Installing Aras Import Manager

After the Aras Innovator installation is complete and confirmed, Aras Import Manager installation modifies the Aras Innovator database with metadata required to run the application. Before applying these changes, verify the following requirements:

• Aras Innovator 33
• 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 starting the process.

1. Back up the code tree:

The “Code Tree” refers to files and folders installed on the disk with Aras Innovator installation. The default path for the Code Tree installation is typically:

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

With the following contents:

The following steps can be used 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…
  1. Select the Comments header if it is not checked.
  2. Click OK.
     • Search for the Aras Innovator entry in the Programs and Features window.
     • View the value set in the Comments column for the Aras Innovator entry:

After verifying the code installation path, back up the folder and its contents.

2. Disconnect all users from the database.

The easiest way to prevent client sessions from committing any further changes to the database is to change the database connection string in the InnovatorServerConfig.xml from ＜DB-Connection… to ＜xDB-Connection… and restart the w3svc service(IIS). This expires all sessions and prevents new connections to the Aras Innovator database through the existing instance.

3. Back up the database.

Store these files in a safe location, as they will be needed for restoration if the process fails.

4. Enable database connections.

After the database backup has completed, enable the database connection string in the InnovatorServerConfig.xml by simply changing it from ＜xDB-Connection… to ＜DB-Connection… and restarting the w3svc service (IIS).

The Aras Import Manager application can be installed using either the Automated Installation option (using the Aras Update Tool) or the Manual Installation option (using the Aras Import Tool).

1. Copy and unzip the Aras Import Manager CD Image on the local computer.
2. Enable the Super User (root) login.
3. Launch the ArasUpdate.exe file as administrator.

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

4. On the Local tab, click Add package reference and navigate to the folder where the Aras Import Manager package was extracted in the first step.
5. Expand the Aras Import Manager package and click Install.

6. Select Aras Innovator Server Code Tree Updates, Aras Innovator Client Code Tree Updates, and Import into Innovator DB options.

7. Click Next.
8. Select the Detailed logging option and click Next.

The logging option records the installation attempt and can be used to troubleshoot issues.

9. Input the connection information and click Install.

• Path to Innovator: The physical path to the Aras Innovator Code Tree (should be the same as the one defined in IIS application settings)
• Innovator URL: The connection URL for Aras Innovator
• Database name of Innovator instance: The target Aras Innovator database
• Username: root
• Password: Password for “root” login (Default is “innovator”)
• Conversion Server: The physical path to the Aras Innovator Conversion Server (should be the same as the one defined in IIS application settings)
• Agent Service: The physical path to the Aras Innovator Agent Service (should be the same as the one defined in IIS application settings)

Aras Update will import everything required for Aras Import Manager.

10. Disable the Super User (root) login after the import is complete.

1. Download the Aras Import Manager CD image from the Aras MFT site, and unzip the file on the local machine.
   1. Copy the \Innovator folder to the root of the install directory, overwriting the existing \Innovator folder and all its contents.
   2. Copy the \ConversionServer folder to the root of the install directory, overwriting the existing \ConversionServer folder and all its contents.

It is recommended that an administrator perform this step on the server.

3. Increment the filesRevision setting in the \Client\InnovatorClient.config file.
   • Navigate to the \Innovator\Client\ directory and open the InnovatorClient.config file for editing.
   • Change the value of the filesRevision attribute. The value should be changed from std to 2, 3, 4, etc.

<cachingModule moduleEnabled="true” filesRevision="2" />

• Save the changes to the InnovatorClient.config file and close it.

4. Import the Aras Import Manager database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 33 – Package Import Export Utilities documentation.

2. Enable the Super User (root) login to perform this step.
   • Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.

• Input the connection information.
  • Server: The connection URL for Aras Innovator

Click the Login button and enter:

• Database: The target Aras Innovator database
• Username: root
• Password: Password for “root” login (Default is “innovator”)
• Target Release: AIM33
• Description: Aras Import Manager 33
• Manifest File Path: The manifest file \Imports\imports.mf
• Available for Import: Select All Packages
• Type: Merge
• Mode: Thorough Mode

• Click the Import button.
• Disable Super User (root) login.

• Repeat the import with the second manifestimports.standard.mf.

• Input the connection information.
  • Server: The connection URL for Aras Innovator

Click the Login button and enter:

• Database: The target Aras Innovator database
• Username: root
• Password: Password for “root” login (Default is “innovator”)
• Target Release: AIM33
• Description: Aras Import Manager 33
• Manifest File Path: The manifest file \Imports\imports.standard.mf
• Available for Import: Select All Packages
• Type: Merge
• Mode: Thorough Mode

• Click the Import button.
• Disable Super User (root) login.

• Optional: import with the manifestimports.pe.mf.

• Input the connection information.
  • Server: The connection URL for Aras Innovator

Click the Login button and enter:

• Database: The target Aras Innovator database
• Username: root
• Password: Password for “root” login (Default is “innovator”)
• Target Release: AIM33
• Description: Aras Import Manager 33
• Manifest File Path: The manifest file \Imports\imports.pe.mf
• Available for Import: Select All Packages
• Type: Merge
• Mode: Thorough Mode

• Click the Import button.
• Disable Super User (root) login.

• Open %InstallPath%\Innovator\Server\method-config.xml.
• Check that the content of ReferencedAssemblies is similar to the following content.
• Lines highlighted in yellow have been added
• Check the lines highlighted in yellow and red text. If any already exist, don’t add them.

<ReferencedAssemblies>
<name>$(binpath)/Aras.Server.Core.dll</name>
<name>$(binpath)/Aras.Server.Configurator.Abstractions.dll</name>
<name>$(binpath)/Aras.Server.Workflow.Abstractions.dll</name>
<name>$(binpath)/Aras.Server.Lifecycle.Abstractions.dll</name>
<name>$(binpath)/Aras.TDF.Base.dll</name>
<name>$(binpath)/Aras.TDF.Base.Extensions.dll</name>
<name>$(binpath)/Conversion.Base.dll</name>
<name>$(binpath)/ConversionManager.dll</name>
<name>$(binpath)/FileExchangeService.dll</name>
<name>$(binpath)/IOM.dll</name>
<name>$(binpath)/Newtonsoft.Json.dll</name>
<name>$(binpath)/SixLabors.ImageSharp.dll</name>
<name>$(binpath)/Microsoft.Data.SqlClient.dll</name>
<name>Microsoft.Extensions.Logging.Abstractions.dll</name>
<name>Microsoft.Extensions.Primitives.dll</name>
<name>$(binpath)/Aras.Server.Core.Abstractions.dll</name>
<name>$(binpath)/Aras.Server.AccessControl.Abstractions.dll</name>
<name>$(binpath)/Aras.Server.MetadataCache.Abstractions.dll</name>
<name>$(binpath)/System.Runtime.Caching.dll</name>
<name>$(binpath)/Aras.Ark.ImportManager.dll</name>
<name>$(binpath)/Aras.Ark.ImportManager.CustomReader.dll</name>
</ReferencedAssemblies>

To make the conversion server work, we need to first configure all the converters we are going to use following these steps :

• Open %InstallPath%\ConversionServerConfig.xml
• Check that the content of ReferencedAssemblies is similar to the following content.
• Line highlighted in yellow has been added

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<!-- Common converter service configuration -->
<section name="ConversionServer" type="Aras.ConversionFramework.ConversionServer.Configuration.ConversionServerConfigurationSection, Conversion.Base"/>
<sectionGroup name="ConverterSettings">
<!-- Place here class configuration section definitions for converters -->
</sectionGroup>
</configSections>
<ConversionServer>
<InnovatorServer url="http://localhost/Innovator/Server/InnovatorServer.aspx"/>
<Converters>
<Converter name="AIM_Import_GenericConverter" type="Aras.Ark.ImportManager.Conversion.GenericConverter,Aras.Ark.ImportManager.Conversion" />
</Converters>
</ConversionServer>
<ConverterSettings>
<!-- Place here configuration sections for converters -->
</ConverterSettings>
</configuration>

In order to have Aras Import Manager background tasks working correctly, we need to configure the conversion rules following these steps :

• Open %InstallPath%\AgentService\conversion.config
• Check that the content of ReferencedAssemblies is similar to the following content.
• Line highlighted in yellow has been added :
  • Replace DB value with you instance name (e.g.: PROD_ImportManager)

<configuration>
<configSections>
<section name="Innovator" type="Aras.Server.Configuration.InnovatorConfigurationSection, Aras.Server.Agent" />
</configSections>
<Innovator>
<Conversion>
<ProcessingCycles>
<!--cycle DB="{db}" User="{user}" Interval="20000" MaxBatch="5" /-->
<!--cycle DB="{db}" User="{user}" Interval="20000" MaxBatch="1" ConversionRuleName="SSVC.Email.Digest.Notification.Rule" /-->
<!--cycle DB="{db}" User="{user}" Interval="5000" MaxBatch="50" ConversionRuleName="SSVC.Notification.Rule" /-->
<!--cycle DB="{db}" User="{user}" Interval="5000" MaxBatch="50" ConversionRuleName="SSVC.UpdateNotification.Rule" /-->
<cycle ConversionRuleName="AIM_Import_GenericConversionRule" DB="<your_database_instance>" Interval="10000" MaxBatch="20" User="admin" />
</ProcessingCycles>
</Conversion>
</Innovator>
</configuration>

After configuring the conversion server, you may have to restart the AgentService Service in Windows services.

Use the following procedure to check if the database has correctly applied the Aras Import Manager changes to Aras Innovator:

1. Log in to Aras Innovator as an administrator.
   1. From the TOC, select Administration --> Variables.
   2. Confirm that the following Application Domain are listed:

If at any time the installation fails, revert to your backups, and contact Aras Support at support@aras.com.