Upgrading jobs to Atrium Integrator by using the Atrium Integrator Maintenance Tool

When you upgrade to Atrium Integrator, most jobs are automatically upgraded. There be situations where certain jobs are not upgraded, in which case, you can upgrade these jobs by using the Atrium Integrator Maintenance Tool. 

If you are not able to directly upgrade the jobs, you need to re-export the jobs from the backup folder that was created for the earlier version of Atrium Integrator and then import the job by using the Atrium Integrator Maintenance Tool. The backup folder for the earlier version of Atrium Integrator is available in the installation folder. The backup folder is renamed with <version number> suffix. 

When you upgrade jobs to Atrium Integrator, the old jobs are moved from the database repository to the form-based repository where the following modifications are made:

• The connection is changed from database to Remedy AR System form.
  For delta jobs the connection changes to Remedy AR System connection. If a transformation has a delta step, then the transformation is modified as per the new design where changes are from the database repository to the form-based repository.
• The log name is changed to UDM:JobLog.
• The log entry name is changed to UDM:JobEntryLog.
• UDM:TransformationLog form is added. It provides details about transformation run.
• UDM:StepLog form is added. It provide details about step run.

Data store connection information from earlier versions of Atrium Integrator console is not upgraded in the Atrium Integrator console, Therefore this information cannot be viewed from the Manage Data stores dialog box. However, the connection information can be viewed from Atrium Integrator Spoon. You can manually create the connection information in the Atrium Integratorconsole with the same alias name.

The following figure illustrates the different stages in the process of upgrading jobs to Atrium Integrator by using the Atrium Integrator Maintenance Tool. 

Upgrading jobs by using the Atrium Integrator Maintenance Tool 

To upgrade jobs by using the Atrium Integrator Maintenance Tool

1. Go to the backup folder of the earlier version of Atrium Integrator.
   It is the earlier installation folder that is renamed with 7604 suffix.
2. To open Atrium Integrator Spoon, double-click spoon.bat.
   1. Log on as follows:
      • In the Repository field, leave the default entry of NGIEREPD.
      • In the Login field, enter admin.
      • In the Password field, enter admin.
      • Click OK.
   2. In the Atrium Integrator Spoon window, open the job.

   3. Select File > Export to an XML file.

      Best practice

      We recommend that you export each job individually instead of exporting the jobs by using the Export all linked resources to XML option. If you export jobs by using the Export all linked resources to XML option, after importing the jobs, you must replace the data_path value with actual file path. You must make this change in the Text Source, Error Logging, Modified Java Script Value, and Get Data from XML step in Atrium Integrator Spoon.

   4. Save the job as a .kjb file, and the related transformation as a .ktr file.

      Note

      Do not add the .ktr and .kjb files to a zip file.

3. On the Atrium Integrator server, import the jobs by using the Atrium Integrator Maintenance Tool.
   1. Navigate to the <AtriumIntegratorInstallationDirectory>\aint directory.
   2. Open the Atrium Integrator Maintenance Tool:
      • Windows--Double-click AtriumIntegratorMaintenanceTool.cmd.
      • UNIX and Linux--Run ./AtriumIntegratorMaintenanceTool.sh.
   3. In the Atrium Integrator Maintenance Tool, click the Load Content tab.
   4. Provide the following Remedy Action Request System information:
      • Remedy Action Request System Administrator Name — Specify an administrator user name.
      • Remedy AR System server Administrator Password — Type the password for the administrator user name.
      • Remedy AR System server TCP Port — If you specified a port number when installing the Remedy AR System server, type that number in this field. If the server uses a portmapper to automatically select a port to use, leave this field blank.
      • Remedy AR System server Name Alias — Type the computer name on which to import the jobs.
   5. Click Next.
   6. Specify the JRE path that is used by the Atrium Integrator computer and click Next.
   7. Specify the directory where the .kjb files are located.
   8. Click Next to begin the import process.
      The Atrium Integrator Content Loader Summary page indicates if the import succeeded or failed.
   9. (optional) Click View Log to find more details about the failure.
      • In the atriumintegrator_configuration_log.txt window, sort the messages by severity.
      • Select a message to display the details at the bottom of the window.
        You can access the log file from the TEMP directory on Windows or the /var/tmp on UNIX.

4. On the Atrium Integrator server, open Atrium Integrator Spoon and confirm that the jobs are successfully imported.

   Note

   When you import jobs, cache is disabled by default. After upgrading you must manually enable the cache by using Atrium Integrator Spoon.