Installing Aras PDF Viewer package

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.

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 37 - 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 --> FeatureLicenses 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.
2. Click the User menu icon and select Activate Feature from the dropdown menu.

Figure 1.

3. Paste the acquired activation key and click the Activate Feature button.

A success message should pop up.