Applying Hotfix-076394.37

This section explains how to update the code tree and database for the .NET 10 upgrade. Before applying these changes, please confirm that all required components are present.

Requirements:

• Aras Innovator 14.37.0
• Microsoft ASP.NET Core / .NET Runtime and Hosting Bundle for .NET 10
• Aras Update tool

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.
   
   Note

   Giving at least 24 hours’ notice and a reminder 15 minutes before taking the system offline is best.
2. 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:
   
   1. From the Start Menu, click Start and select Settings and Control Panel.
   2. From the Control Panel, select Programs and Features.
   3. Search for the Aras Innovator entry. The entry should display the physical installation path.
      Once the location of the code tree installation is determined, backup the folder and its contents.
3. 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 all new connections to the Aras Innovator database through the existing instance.
   
4. Backup the database.
   Place this file in a safe location. If the application fails, it will need to be restored from there.
   
5. 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).

This hotfix can be installed using one of three options: the Automated Installation Option (using the Aras Update tool), the Manual Installation Option (using the Aras Import tool), or the DevOps (SaaS) Installation Option (for container-based deployments).

1. Enable the Super User login.
2. 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\.
3. On the Local tab, locate the hotfix package obtained in Hotfix Patch section in Prerequisites under Local Packages.
   

   

4. Expand the Aras Hotfix Package to Net10 component and click Install.
5. Select the components to which the Hotfix will be applied and click Next.
   

   

6. Select the Detailed logging option and click Next.
   

   

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

   

8. Disable the Super User login.

1. Obtain the Hotfix-076394.37 package as described in Hotfix Patch, then extract it to a folder on the local machine.

2. Before copying the updated ‘Innovator’ folder, delete the following files left over from the previous .NET version, if present:

   Innovator\Client:

   Client\bin\Google.Protobuf.dll
Client\bin\Grpc.Core.Api.dll
Client\bin\Grpc.Net.Client.dll
Client\bin\Grpc.Net.Common.dll
Client\bin\Microsoft.Win32.SystemEvents.dll
Client\bin\nefs\Microsoft.Extensions.Configuration.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.Configuration.Binder.dll
Client\bin\nefs\Microsoft.Extensions.Configuration.dll
Client\bin\nefs\Microsoft.Extensions.DependencyInjection.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.DependencyInjection.dll
Client\bin\nefs\Microsoft.Extensions.Diagnostics.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.Diagnostics.dll
Client\bin\nefs\Microsoft.Extensions.FileProviders.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.Hosting.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.Http.dll
Client\bin\nefs\Microsoft.Extensions.Logging.Abstractions.dll
Client\bin\nefs\Microsoft.Extensions.Logging.dll
Client\bin\nefs\Microsoft.Extensions.Options.ConfigurationExtensions.dll
Client\bin\nefs\Microsoft.Extensions.Options.dll
Client\bin\nefs\Microsoft.Extensions.Primitives.dll
Client\bin\nefs\System.Diagnostics.EventLog.dll
Client\bin\nefs\System.Diagnostics.PerformanceCounter.dll
Client\bin\nefs\System.Security.Cryptography.Xml.dll
Client\bin\nefs\System.Security.Permissions.dll
Client\bin\nefs\System.Windows.Extensions.dll
Client\bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
Client\bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
Client\bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
Client\bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
Client\bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
Client\bin\System.Drawing.Common.dll
Client\bin\System.Security.Permissions.dll
Client\bin\System.Windows.Extensions.dll
Client\jsBundles\chunk-CYR24YHC.es.js
Client\jsBundles\chunk-CYR24YHC.es.js.map
Client\jsBundles\chunk-GV4E6MR3.es.js
Client\jsBundles\chunk-GV4E6MR3.es.js.map
Client\jsBundles\chunk-K2SH5HFQ.es.js
Client\jsBundles\chunk-K2SH5HFQ.es.js.map
Client\jsBundles\chunk-LFN7KUHW.es.js
Client\jsBundles\chunk-LFN7KUHW.es.js.map
Client\jsBundles\chunk-LTW6UTOJ.es.js
Client\jsBundles\chunk-LTW6UTOJ.es.js.map
Client\jsBundles\chunk-NVDHYYJA.es.js
Client\jsBundles\chunk-NVDHYYJA.es.js.map
Client\jsBundles\chunk-QGEEC5T3.es.js
Client\jsBundles\chunk-QGEEC5T3.es.js.map
Client\WebHelp\APIReferenceDotNet\Html\html\Properties_T_Aras_IOME_CheckinProgressChangedEventArgs.htm
Client\WebHelp\APIReferenceDotNet\Html\html\Properties_T_Aras_IOME_DownloadFilesProgressChangedEventArgs.htm
Client\WebHelp\APIReferenceDotNet\Html\html\Properties_T_Aras_IOME_UploadFilesProgressChangedEventArgs.htm
Client\WebHelp\APIReferenceDotNet\Html\icons\CFW.gif
Client\WebHelp\APIReferenceDotNet\Html\icons\slMobile.gif
Client\WebHelp\APIReferenceDotNet\Html\icons\xna.gif
Client\WebHelp\APIReferenceDotNet\Html\scripts\jquery-1.11.0.min.js
Client\WebHelp\APIReferenceDotNet\Html\toc\T_Aras_IOME_CheckinProgressChangedEventArgs.xml
Client\WebHelp\APIReferenceDotNet\Html\toc\T_Aras_IOME_DownloadFilesProgressChangedEventArgs.xml
Client\WebHelp\APIReferenceDotNet\Html\toc\T_Aras_IOME_UploadFilesProgressChangedEventArgs.xml
Client\WebHelp\APIReferenceDotNet\Html\WebKI.xml
Client\WebHelp\APIReferenceDotNet\Html\WebTOC.xml

   Innovator\Server:

   Server\bin\Google.Protobuf.dll
Server\bin\Grpc.Core.Api.dll
Server\bin\Grpc.Net.Client.dll
Server\bin\Grpc.Net.Common.dll
Server\bin\Microsoft.DotNet.PlatformAbstractions.dll
Server\bin\Microsoft.Win32.SystemEvents.dll
Server\bin\nefs\Microsoft.Bcl.AsyncInterfaces.dll
Server\bin\nefs\Microsoft.Extensions.Configuration.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.Configuration.Binder.dll
Server\bin\nefs\Microsoft.Extensions.Configuration.dll
Server\bin\nefs\Microsoft.Extensions.DependencyInjection.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.DependencyInjection.dll
Server\bin\nefs\Microsoft.Extensions.Diagnostics.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.Diagnostics.dll
Server\bin\nefs\Microsoft.Extensions.FileProviders.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.Hosting.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.Http.dll
Server\bin\nefs\Microsoft.Extensions.Logging.Abstractions.dll
Server\bin\nefs\Microsoft.Extensions.Logging.dll
Server\bin\nefs\Microsoft.Extensions.Options.ConfigurationExtensions.dll
Server\bin\nefs\Microsoft.Extensions.Options.dll
Server\bin\nefs\Microsoft.Extensions.Primitives.dll
Server\bin\nefs\System.Diagnostics.EventLog.dll
Server\bin\nefs\System.Diagnostics.PerformanceCounter.dll
Server\bin\nefs\System.Security.Cryptography.Xml.dll
Server\bin\nefs\System.Security.Permissions.dll
Server\bin\nefs\System.Windows.Extensions.dll
Server\bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
Server\bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
Server\bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
Server\bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
Server\bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
Server\bin\System.Drawing.Common.dll
   

3. Copy the ‘Innovator’ folder to the root directory where it was installed, overwriting the existing ‘Innovator’ folder and its contents.
4. From the root of the code tree, navigate to \Innovator\Client and edit the InnovatorClient.config file.
   
   1. Change the value of the filesRevision attribute. The value should be changed from std to 2, 3, 4, etc
      <cachingModule moduleEnabled="true” filesRevision="2" />
   2. Save the changes to the InnovatorClient.config file and close it
5. Restart World Wide Web Services (IIS) on the Innovator Server machine.
6. Stop AgentService.

7. Before copying the updated ‘AgentService’ folder, delete the following files left over from the previous .NET version, if present:

   bin\Google.Protobuf.dll
bin\Grpc.Core.Api.dll
bin\Grpc.Net.Client.dll
bin\Grpc.Net.Common.dll
bin\Microsoft.DotNet.PlatformAbstractions.dll
bin\Microsoft.Win32.SystemEvents.dll
bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\net8.0\System.ServiceProcess.ServiceController.dll
bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
bin\System.Drawing.Common.dll
bin\System.Security.Permissions.dll
bin\System.Windows.Extensions.dll
   

8. Copy the ‘AgentService’ folder to the root directory where the Agent Service was installed, overwriting the existing ‘AgentService’ folder and its contents.
9. Start AgentService.

10. Before copying the updated ‘ConversionServer’ folder, delete the following files left over from the previous .NET version, if present:

    bin\DotNetZip.dll
bin\Google.Protobuf.dll
bin\Grpc.Core.Api.dll
bin\Grpc.Net.Client.dll
bin\Grpc.Net.Common.dll
bin\Microsoft.DotNet.PlatformAbstractions.dll
bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
bin\System.Security.Permissions.dll
bin\System.Windows.Extensions.dll
    

11. Copy the ‘ConversionServer’ folder to the root directory where the Conversion Server was installed, overwriting the existing ‘ConversionServer’ folder and its contents.
12. Restart World Wide Web Services (IIS) on the Conversion Server machine.

13. Before copying the updated ‘OAuthServer’ folder, delete the following files left over from the previous .NET version, if present:

    OAuthServer\bin\Google.Protobuf.dll
Bin\AutoMapper.dll
Bin\Google.Protobuf.dll
Bin\Grpc.Core.Api.dll
Bin\Grpc.Net.Client.dll
Bin\Grpc.Net.Common.dll
Bin\Microsoft.Win32.SystemEvents.dll
Bin\nefs\Microsoft.Extensions.Configuration.Abstractions.dll
Bin\nefs\Microsoft.Extensions.Configuration.Binder.dll
Bin\nefs\Microsoft.Extensions.Configuration.dll
Bin\nefs\Microsoft.Extensions.DependencyInjection.Abstractions.dll
Bin\nefs\Microsoft.Extensions.DependencyInjection.dll
Bin\nefs\Microsoft.Extensions.Diagnostics.Abstractions.dll
Bin\nefs\Microsoft.Extensions.Diagnostics.dll
Bin\nefs\Microsoft.Extensions.FileProviders.Abstractions.dll
Bin\nefs\Microsoft.Extensions.Hosting.Abstractions.dll
Bin\nefs\Microsoft.Extensions.Http.dll
Bin\nefs\Microsoft.Extensions.Logging.Abstractions.dll
Bin\nefs\Microsoft.Extensions.Logging.dll
Bin\nefs\Microsoft.Extensions.Options.ConfigurationExtensions.dll
Bin\nefs\Microsoft.Extensions.Options.dll
Bin\nefs\Microsoft.Extensions.Primitives.dll
Bin\nefs\System.Diagnostics.EventLog.dll
Bin\nefs\System.Diagnostics.PerformanceCounter.dll
Bin\nefs\System.Security.Cryptography.Xml.dll
Bin\nefs\System.Security.Permissions.dll
Bin\nefs\System.Windows.Extensions.dll
Bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
Bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
Bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
Bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
Bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
Bin\System.Drawing.Common.dll
Bin\System.Security.Permissions.dll
Bin\System.Windows.Extensions.dll
    

14. Copy the ‘OAuthServer’ folder to the root directory where the OAuth Server was installed, overwriting the existing ‘OAuthServer’ folder and its contents.
15. Restart World Wide Web Services (IIS) on the OAuth Server machine.

16. Before copying the updated ‘VaultServer’ folder, delete the following files left over from the previous .NET version, if present:

    bin\Google.Protobuf.dll
bin\Grpc.Core.Api.dll
bin\Grpc.Net.Client.dll
bin\Grpc.Net.Common.dll
bin\Microsoft.Win32.SystemEvents.dll
bin\nuntimes\unix\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\net6.0\Microsoft.Win32.SystemEvents.dll
bin\nuntimes\win\lib\net6.0\System.Drawing.Common.dll
bin\nuntimes\win\lib\netcoreapp2.0\System.Diagnostics.PerformanceCounter.dll
bin\nuntimes\win\lib\netcoreapp3.0\System.Windows.Extensions.dll
bin\System.Drawing.Common.dll
bin\System.Security.Permissions.dll
bin\System.Windows.Extensions.dll
    

17. Copy the ‘VaultServer’ folder to the root directory where the Vault Server was installed, overwriting the existing ‘VaultServer’ folder and its contents.
18. Restart World Wide Web Services (IIS) on the Vault Server machine.

19. 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.

    

    1. Enable the Super User login to perform this step.
    2. Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file
    3. 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-076394.37
       • Manifest File Path = The manifest imports.mf is found in the folder Imports\
       • Available for Import = Select All
       • Type = Merge
       • Mode = Thorough Mode
    4. Click the Import button
    5. Disable the Super User login once complete.
       
       Note

       The Super User login should not be enabled in production.

This option applies to Aras Innovator deployments that run as containers in a DevOps environment, also referred to as SaaS. In these deployments, the hotfix is not applied to an existing code tree on disk. Instead, the environment is updated to use a container image built on the .NET 10 base image, and the database package is applied to the target database.

This hotfix is published as a versioned container image identified by the build version 14.37.0-msbuild.76394 The image is built on the .NET 10 base image and includes the recompiled net10.0 platform components.

The high-level steps to apply the hotfix in a DevOps (SaaS) environment are as follows:

1. In your local Build and Deployment Service package repository, open the file packages.config from the folder AutomatedProcedures/tools for editing.
2. Find and update the Innovator version number to the one for Release 37 (14.37.0).
3. Update the following values in packages.config according to the Release 37 patch being applied:

Run the Generate Baseline pipeline to produce the patched baseline for the updated configuration.

Follow your standard procedure to deploy the patch release to the target environment, then retrieve and apply the database package:

1. Log on to the Aras File Sharing Site.
2. Navigate to the folder: Aras / Product Releases – Internal / Innovator Builds / Released / Release 37.
3. Download the Aras Innovator Patch Release 37 CD Image archive.
4. Unzip the archive on the local machine in a new folder and locate the Imports subfolder.
5. Apply the AML packages included in the Imports subfolder.

After deployment, verify the installation as described in Confirming the Installation.

After applying hotfix using any of the installation options above, 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:
   
   • MSBuild Number 076394.37
5. Navigate to Administration\Variables in the Table of Contents.
6. Confirm the following Variable is shown:

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