Sign in

Installing the Aras ProAppDesigner

5 min read

The ProAppDesigner can be installed using either the Automated Installation option (using the Aras Update tool), or the Manual Installation option (using the Aras Import Tool).

Automated Installation Option

  1. Download the Aras ProAppDesigner CD Image from the Aras File Sharing site.
  2. Unzip the Aras ProAppDesigner CD Image on the local computer.
  3. Enable the Super User login.
  4. Launch the ArasUpdate.exe file as administrator.
  5. On a default installation, the ArasUpdate.exe file can be found in the C:\Program Files (x86)\Aras\Aras Update\ directory.

  6. Locate and select the Aras ProAppDesigner package.

  7. Click Install.

  8. Select the Aras Innovator Code Tree Updates and Aras Innovator Database Updates options.
  9. Click Next.
  10. Select the appropriate logging option and click Next.
    The logging option is used to record the installation attempt and can be used to troubleshoot issues.
  11. Input the connection information and click Install.
    • Server URL = The connection URL for Aras Innovator
    • Database = The target Aras Innovator database
    • Username = root
    • Password = Password for “root” login (Default is “innovator”)

    Aras Update should import everything required for Aras Innovator ProAppDesigner.

  12. After the import is complete, disable the Super User login.

Manual Installation Option

  1. Download the Aras ProAppDesigner 14 CD image from the Aras File Sharing site, in the Aras ProAppDesigner Releases folder, and unzip the file on the local computer.

  2. Copy the \Files\Innovator\Client folder to the root of your installation directory. When prompted, overwrite the existing \Innovator\Client folder and all of its contents.

    It is recommended that this step be performed by an administrator on the server.

  3. From the \Files\Innovator\Server folder, copy all files matching Prorigo.* to the root of your installation directory. When prompted, overwrite the existing files in the \Innovator\Server folder.

    It is recommended that this step be performed by an administrator on the server.

  4. From the \Files\Innovator\Server folder, copy all remaining files excluding Prorigo.* into the \Innovator\Server folder. Do not overwrite any existing files during this step.

  5. Copy the \Files\ConversionServer folder to the root of your install directory, overwriting the existing \ConversionServer folder and all its contents.

    It is recommended that this step be performed by an administrator on the server.

  6. If any of the below DLLs are available in \Innovator\Server\bin or in ConversionServer\bin folder, delete them
    • Prorigo.Protrak.ExpressionEvaluatorStd.Impl.dll
    • Prorigo.Protrak.ExpressionEvaluatorStd.dll
    • Prorigo.Plm.PresentationGenerator.dll
    • Prorigo.Plm.PresentationGenerator.Aras.dll
    • Prorigo.Plm.Logging.Framework.dll
    • Prorigo.Plm.DocumentGenerator.dll
    • Prorigo.Plm.DocumentGenerator.Aras.dll
    • Prorigo.Plm.DiscussionPanel.dll
    • Prorigo.Plm.Core.dll
    • Prorigo.Plm.Aras.BackgroudCronJobFramework.dll
    • Prorigo.Plm.AppStudio.RuleEngine.Impl.dll
    • Prorigo.Plm.AppStudio.RuleEngine.dll
    • Prorigo.Plm.AppStudio.IntegrationFramework.dll
    • Prorigo.Plm.AppStudio.dll
  7. From the root of your code tree, navigate to \Innovator\Server and edit the method-config.xml file.

    1. Add below entries as shown:

      ...

      <!-- ProAppDesigner DLLs : Start -->
      <name>$(binpath)/Prorigo.Plm.Aras.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.AppStudio.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.TDP.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.SubscriptionFramework.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.DocumentGenerator.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.BackgroundCronJobFramework.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.RuleEngine.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.PresentationGenerator.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.IntegrationFramework.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.IntegrationFramework.Connector.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.DiscussionPanel.dll</name>
      <name>$(binpath)/Prorigo.Plm.Aras.Logger.dll</name>
      <name>$(binpath)/Prorigo.Plm.LicensingFramework.dll</name>
      <!-- ProAppDesigner DLLs : End -->

      </ReferencedAssemblies>

    2. Save the changes to the method-config.xml file and close it
    Warning
    If any of the DLLs mentioned in the DLLs to be deleted section, please delete the corresponding entry from method-config.xml file.

  8. From the root of your code tree, navigate to \Innovator\Client and edit the InnovatorClient.config file.
    1. Change the value of the filesRevision attribute. The value should be changed from std to 2, 3, 4, etc
      ...
      <oauth configSource="OAuth.config” />
      <cachingModule moduleEnabled="true” filesRevision="2" />
      <staticContent>
      ...
    2. Save the changes to the InnovatorClient.config file and close it.
  9. From the root of your code tree, open ConversionServerConfig.xml file.
    1. Add below entries in Converters.
      ...
      <Converters>
      <Converter name="bcj_CRONJOBS” type="Prorigo.Plm.Aras.BackgroundCronJobFramework.BCJ_Converter, Prorigo.Plm.Aras.BackgroundCronJobFramework” />
      <Converter name="bcj_Background_Job_Conversion_Type” type="Prorigo.Plm.Aras.BackgroundCronJobFramework.BCJ_Converter, Prorigo.Plm.Aras.BackgroundCronJobFramework” />
      </Converters>
      ...
    2. Save the changes to the ConversionServerConfig.xml file and close it.
  10. Restart the World Wide Web Service (IIS).

  11. Execute Pre Import Scripts

    Before you install Aras ProAppDesigner, execute the following scripts:

    1. Navigate Aras Nash tool using URL http://localhost/InnovatorServer/Client/scripts/nash.aspx

    2. Login in Nash using admin user.

    3. In the package go to folder PreImportAMLScripts\Manual Scripts, open each file in below sequence, copy the content in XML form and click on Submit.
      • 04500_TemplateDeploy_PreAML.xml
  12. Complete the Installation of ProAppDesigner: Import the ProAppDesigner database package with the Package Import Export Utilities (For more information using this tool, please see the Aras Innovator - Package Import Export Utilities documentation.)
    1. You will need to enable the Super User login to perform this step.

    2. Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.

    3. Enter the following information:

      • Server = The connection URL for Aras Innovator
      • Database = The target Aras Innovator database (login screen)
      • Username = root (login screen)
      • Password = Password for “root” login (Default is “innovator”) (login screen)
      • Target Release = ProAppDesigner
      • Description = ProAppDesigner
      • Manifest File Path = The manifest is found in the unzipped patch folder in \Aras ProAppDesigner CD Image\Imports\ProAppDesigner\imports.mf
      • Available for Import = Check all packages
      • Type = Merge
      • Mode = Thorough Mode
    4. Click the Import button.
  13. Disable the Super User login.
  14. Execute Post Import Scripts
    After you install Aras ProAppDesigner, execute the following scripts:
    1. Navigate Aras Nash tool using URL http://localhost/InnovatorServer/Client/scripts/nash.aspx

    2. Login in Nash using admin user.

    3. In the package go to folder PostImportAMLScripts\Manual Scripts, open each file in below sequence, copy the content in XML form and click on Submit.

      • 05000_TemplateDeploy_PostAML.xml