Hotfix 12141 - 37

This document outlines the required steps to install Hotfix-12141 for Aras Innovator. This hotfix enables the Aras Innovator release to run in browsers which already deprecated native XSLT support. These changes affect both the code tree and the database.

For more information about the deprecation of XSLT, see the official documentation: https://developer.chrome.com/docs/web-platform/deprecating-xslt.
XSLT is planned to be deprecated in all Chromium-based browsers. At this time, there is no official information from other browser vendors regarding XSLT deprecation; however, it is highly likely that this functionality will eventually be deprecated across all major browsers.
In Google Chrome, XSLT support can currently be enabled or disabled via the experimental flag at chrome://flags/#xslt.

The patch includes fixes for the following issues:

To apply Hotfix-12141 to Aras Innovator, confirm that the software is currently eligible for this hotfix. Next, download the necessary materials for the upgrade.

The following steps outline the process to check if Aras Innovator is eligible to apply Hotfix-12141

1. Log in to Aras Innovator as an administrator.
2. From the Help menu, select About.
3. Confirm that the window shows the following Release 37.
4. Log in to Aras Innovator as an administrator.
5. Navigate to Administration\Variables in the Table of Contents.
6. Confirm that the following set of variables is listed:

Contact Aras Support before installing if the eligibility requirements are unmet.

If the Prerequisites listed in the previous section have been met, the next step is to obtain the required upgrade files and utilities.

The Aras Update tool can be downloaded from https://www.aras.com/support/downloads.

Aras Update should be downloaded and installed locally on every node running the Aras Innovator component.

Subscribers can obtain the patch from mft.aras.com. The hotfix zip file is in the same directory as the Aras Innovator Release 37 CD Image.
Copy the ‘.zip’ file with a hotfix patch to a local machine.

This section explains how to modify the database and Aras Innovator client. Before applying these changes, please confirm if all required components are present.
Requirements:

• Aras Innovator 37
• ArasUpdate tool or Aras Innovator Package Import Export Utilities

Notify users that the system will be down at a scheduled time and that they should log out before starting the process.
Giving at least 24 hours’ notice and a reminder 15 minutes before taking the system offline is best.

Back up 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 similar to:
C:\Program Files(x86)\Aras\Innovator

The installation folder can be confirmed with the following steps:

• From the Start Menu,click Start and select Settings and Control Panel.
• From the Control Panel, select Programs and Features.
• Search for the Aras Innovator entry.

The entry should display the physical installation path.
Once the location of the code tree installation is determined, back up the folder and its contents.
The Hotfix overrides the following files:

• "\Innovator\Client\javascript\aras_object.ts”
• "\Innovator\Client\javascript\client_cache.ts”
• "\Innovator\Client\javascript\IncludeNamespaceConfig.xml”
• "\Innovator\Client\Modules\core\Xml.ts”
• "\Innovator\Client\scripts\include\InitialSetupHeader.cshtml”

If the target Innovator instance contains customizations in these files, ensure they are backed up before proceeding, as applying the Hotfix will overwrite them.

• 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 w3svcservice(IIS). This expires all sessions and prevents all new connections to the Aras Innovator database through the existing instance.

• Backup the database.

Place this file in a safe location. If the application fails, it will need to be restored from there.

• 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 thew3svc service (IIS).

This hotfix can be installed using the Automated Installation Option (using the Aras Update tool) or the Manual Installation Option (using the Aras Import tool).

1. Extract the Hotfix-12141.zip file to a folder on the local machine.
2. Enable the Super User 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\ArasUpdate\.
   
4. On the Local tab, click Add package reference, then navigate to the folder where the hotfix was extracted in the first step.
5. Expand the Aras Hotfix Package to Xslt component and click Install.

6. Select the components to which the hotfix will be applied and click Next.

7. Select the Detailed logging option and click Next.

8. Fill in the appropriate Client Path information, URL, Database, Username, and Password for the root user, and click Install.

9. Disable the Super User login.

• Extract the Hotfix-12141.zip file to a folder on the local machine.
• Copy the ‘Innovator’ folder to the root directory where it was installed, overwriting the existing ‘Innovator’ folder and its contents.
• From the root of the code tree, navigate to \Innovator\Client and edit the InnovatorClient.config file.
• Change the value of the filesRevision attribute. The value should be changed from std to 2, 3, 4,etc

<cachingModulemoduleEnabled="true"filesRevision="2" />

• Save the changes to the InnovatorClient.config file and close it.
• Restart World Wide Web Services (IIS) on the Innovator Server machine.
• Import the database package with the Package Import Utility. For more information on using this tool, refer to the Aras Innovator - Package Import Export Utilities document.

• Enable the Super User login to perform this step.
• Browse to the\PackageImportExportUtilities\Import\folder and run the Import.exe file
• Input the following connection 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=R37
Description= Hotfix-12141.37
Manifest File Path= The manifest imports.mf is found in the folder Imports\
Available for Import= Select All
Type= Merge
Mode= Thorough Mode

• Click the Import button
• Disable the Super User login once complete.
• The Super User login should not be enabled in production.
• Confirming the Installation

Use the following steps to verify that the database has correctly applied the updates to Aras Innovator.

1. Start IIS
2. Log in to Aras Innovator as an administrator.
3. From the Help menu, select About.
4. Confirm that the window shows the following:
5. MSBuildNumber IH-12141.37
6. Navigate to Administration\Variables in the Table of Contents.
7. Confirm the following Variable is shown:

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