Installing Aras Workspace Connector Server Components

After successfully installing and confirming Aras Innovator, the Aras Innovator database must be modified with the metadata required to run Aras Workspace Productivity Connector 33.

Before proceeding, ensure the following components are available:

• Aras Innovator 33
• Aras WorkspaceProductivity Connector Feature License
• Aras Update Tool 1.23

or

• Aras Innovator Package Import Export Utilities

1. Notify users that the system will be down at a scheduled time and that they should log out before the process starts.
   
   Note

   It is best to give at least 24-hour notice, as well as a reminder 15 minutes prior to the upgrade.
2. Backup the Code Tree
   The “Code Tree” refers to files and folders installed on the disk when Aras Innovator was first installed. The default path for the Code Tree installation would be something like:
   
   Expand Collapse

   C:\Program Files (x86)\Aras\Innovator

   With the following contents:
   

   

3. Follow these steps to confirm the installation folder:
   
   • From the Windows search field, enter Control to access the Control Panel.
   • Select Programs and Features.
   • Right-click the Name column and select More…
   • Select the Comments header if it has not been checked.
   • Click OK.
4. Search for the Aras Innovator entry in the Programs and Features window.
5. View the value set in the Comments column for the Aras Innovator entry:
   

   

   After verifying the Code Tree installation path, back up the folder and all its contents.
   
6. Disconnect all users from the database
   To prevent any further changes to the database by client sessions, the simplest method is to:
   
   • Open the InnovatorServerConfig.xml file
   • Modify the database connection string by changing ＜DB-Connection... to ＜xDB-Connection…
   • Restart the w3svc service (IIS).

   This will immediately expire all active sessions and block any new connections to the Aras Innovator database through the current instance.
   

7. Backup the database
   Store these files in a safe location, as they will be needed if the process fails.
8. Enable database connections
   Once the database backup is complete:
   
   • Open the InnovatorServerConfig.xml file.
   • Change the connection string from ＜xDB-Connection... back to ＜DB-Connection....
   • Restart the w3svc service (IIS).

You can install Aras Workspace Productivity Connector 33 using either of the following methods:

• Automated Installation using the Aras Update Tool
• Manual Installation using the Aras Import Tool

1. Download the Aras Workspace Productivity Connector 33 CD Image from the Aras MFT site and unzip the file on the local computer.
   
   • Enable the Super User login.
   • Launch the ArasUpdate.exe file as administrator.

   If default options were selected during installation, the ArasUpdate.exe file can be found in the C:\Program Files (x86)\Aras\Aras Update\ directory.

2. On the Local tab, click Add package reference and navigate to the folder where the Aras WorkspaceProductivity Connector 33 package was extracted from the first step.
3. Expand the Aras Workspace Productivity Connectorpackage and click Install.
   

   

4. Select Aras Innovator Code Tree Updates and Aras Innovator Database Updates options and click Next.
   

   

5. Select the Detailed logging option and click Next.
   The logging option records the installation attempt and can be used to troubleshoot issues.
6. Enter the connection information and click Install.
   

   

   • Install Path: The physical path to the Aras Innovator code tree
   • 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 will import everything required for Aras Workspace Productivity Connector 33.

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

1. Download the Aras Workspace Productivity Connector 33 CD Image from the Aras MFT site and unzip the file on the local computer.
2. Copy DLLs from the ..\Files\Innovator\Server\bin folder to the Innovator\Server\bin folder and update method-config.xml with following entries:
   
   Expand Collapse

   <!-- Workspace Productivity Connector dlls -->
   
   ＜name＞$(binpath)/Prorigo.Plm.Logging.Framework.dll</name>
   
   ＜name＞$(binpath)/Prorigo.Plm.LicensingFramework.dll</name> 
   
   ＜name＞$(binpath)/Aspose.Words.dll</name>   
   
   ＜name＞$(binpath)/ Prorigo.Plm.OfficeConnector</name>          
   
   ＜name＞$(binpath)/Prorigo.Plm.DiscussionPanel.dll</name>

3. Copy content from the ..\Files\Innovator\Client folder to the Innovator\Client folder.
4. Use the Package Import Export Utilities to import the Aras Workspace Productivity Connector 33 database package. For more information about using this tool, please see the Aras Innovator 33 – Package Import Export Utilities documentation.
   
   • Enable the Super User login to perform this step.
   • Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file as administrator.

   

5. Enter the following information:
   
   • Server: The connection URL for Aras Innovator
   • Database: The target Aras Innovator database
   • Username: root
   • Password: Password for “root” login (Default is “innovator”)
   • Target Release: WPC33
   • Description: Aras Workspace Productivity Connector 33
   • Manifest File Path: \Workspace Productivity Connector 33 CD Image\Imports\imports.mf
   • Available for Import: Select All Packages
   • Type: Merge
   • Mode: Thorough Mode
6. Click the Import button.

1. Navigate to the Aras Innovator Code Tree.
2. Open the /Innovator/OAuthServer/OAuth.config file for editing.
3. Add a redirect URL for Aras Workspace Productivity Connector under the redirectUris section of the file.
   
   Expand Collapse

   <redirectUri value='https://${InnovatorURL}Client/Solutions/WorkspaceProductivityConnector/sidebar-index-page-impl.html?redirect=loginSuccess'/>

   Replace ${InnovatorURL} with the URL to the Aras Innovator instance being used.

Use the following procedure to check if the database has been updated correctly:

1. Log into Aras Innovator as an administrator.
2. From the TOC, expand Administration and select Variables.
3. Confirm the following variable:

If the installation fails at any time, revert to backups and contact Aras Support at the Aras Subscriber Portal.