Visual Collaboration Installation

For Visual Collaboration to function properly, Aras Innovator requires the Aras PDF Viewer to be installed. Aras PDF Viewer is a feature included in Aras Innovator to display PDF documents as part of the Visual Collaboration feature. However, the technology used to make feature display PDFs is browser specific. Users may experience differences in behavior when loading in different browsers. While all browsers provide the same functionality, the user experience will be slightly different.

The PDF Viewer installation includes updates to the Aras Innovator database and code tree.

Before installing the PDF Viewer package, confirm that the server has Microsoft Visual C++ 2010 Redistributable installed. If required, the package may be downloaded from the Microsoft web site:

Microsoft Visual C++ 2010 Redistributable Package (x64)

https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

Before proceeding with the installation, confirm that the Microsoft Visual C++ 2010 Redistributable package is installed on the server machine.

1. Unzip the ArasPDFViewer.zip file on the server.
Note
Step 2 should only be done if Windows Authentication is set up for the instance. If it is not, users can skip this step.
2. Open the OAuthServer.Plugins.json file located at the root of the Aras OAuth server folder.
3. Add the pdftron user to DeniedDomainUsers of the WindowsUserByNameClaimMapper plugin in the OAuthServer.Plugins.json as follows:

 “Options": {

 “AuthenticationType": “WindowsRemote”,

 “AllowedDomainNames": "^ARAS-CORP$",

 “AllowedDomainUsers": ".+",

 “DeniedDomainUsers": "^admin$|^root$|^vadm |^pdftronuser$

4. Clear the browser cache.
5. Next, you need to import the database package with the Package Import Export Utilities For more information about using this tool, refer to the Aras Innovator 31 - Package Import Export Utilities documentation.
1. You need to enable the Super User user to perform this step.
2. Go to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
3. Input the connection information:

Server: an Aras Innovator connection URL

Database: a target Aras Innovator database

Username: root

Password: a password of the root user, the default is innovator

Target Release: a target release version

Description: a PDF Viewer Package

Manifest File Path: a manifest is found at \Imports\import.mf

Available for Import: PDFViewer

Type: Merge

Mode: Thorough Mode

4. Click the Import button.
5. After the import has been completed, disable the SuperUser user.
6. Log into Aras Innovator as an administrator.
7. Go to Contents --> Administration --> Users and open the pdftron_user User for editing.
8. Set the password for the pdftron_user User as required, Logon enabled: true and click Save, Unclaim and Close.
9. At the root of Aras Innovator code tree, open the InnovatorServerConfig.xml file for editing.
10. Add the following before the closing </Innovator> tag, filling in the password set in Step 10 above.

...

<operating_parameter key="pdftron_user” value="pdftron_user|innovator” />

</Innovator>

11. Save and close the InnovatorServerConfig.xml file.
12. Confirm that either a current version of the Aras.PremierSubscription or a current version of the Aras.EssentialSubscription Feature licenses are activated in the database.
13. Log into Aras Innovator as an administrator.
14. Go to Contents --> Administration --> Feature Licenses and search for the Aras.PremiereSubscription, Aras.EssentialSubscription, and Aras.PDFViewer licenses.
15. If the licenses are not found, you can request them at licenses@aras.com if being a subscriber.

The PDFViewer must be run as a 64-bit application. To confirm that the application is running in 64-bit mode, check the settings on the assigned Application Pool User in IIS.

To request a feature license activation key, customers with an active Aras subscription can send an email to licenses@aras.com or your account representative in the following format:

• Subject: PDF Viewer Activation Key Required
• Body: an Aras Innovator version

You will receive a reply containing the Feature License activation key.

Once you have the activation key, install the feature license as follows:

1. Log into Aras Innovator as an administrator.

Click the User menu icon



and select Activate Feature from the dropdown menu.



2. Paste the acquired activation key and click the Activate Feature button.
3. A success message should pop up.