Migrating Atrium Integrator jobs and transformations from one computer to another

You can migrate jobs from one computer to another using one of the following:

Migrating jobs using the Export Configuration tool

The Export configuration tool is available with BMC Atrium Core 8.1.02 and later versions. Export Configuration tool allows you to migrate Atrium Integrator jobs from one computer to another wherein, you can:

• Migrate all or specific Atrium Integrator jobs.
• Migrate Atrium Integrator job schedules.
• Migrate 8.0 and later Atrium Integrator jobs to a computer where the higher version of Atrium Integrator is installed. You will have to run the utility only from a computer where you have BMC Atrium Core 8.1.02 or later version installed.
• The target version must always be equal to or greater than the source.
• Migrate job connections. Only the connections specific to the job are migrated. 

To migrate jobs using the Export Configuration tool

1. Launch the Atrium Integrator console. 
2. In the tool bar, click Export Configuration tool. The Export Configuration tool dialog box is displayed. 
3. Enter the source server details.
   • Server Name: Is auto populated
   • Server Port: Is auto populated
   • AI User: User name
   • Password: Password
   • Authentication: Client-provided authentication string, such as the domain.
4. Click Fetch Jobs. 
   • All the jobs on the source server are displayed in Job List table. 
   • Only the parent jobs are displayed in the Job List table. However, all the associated sub jobs and transformations are also migrated.
   • For all the jobs that have a schedule, the Schedule check box is selected.
   • To troubleshoot: If you are running the Tomcat web server, the Atrium Integrator console log files are located in the following directory on the computer where you installed the mid tier: C:\Program Files\Apache Software Foundation\Tomcat 6.0\logs\stdout_currentDate.log 
5. Enter the target server details. 
   • Server Name
   • Server Port
   • AI Admin User: Remedy Application Service
   • Password: Remedy application service user password
   • Authentication: Client-provided authentication string, such as the domain.
6. Click Test Target. Connection to the target server is tested. 
   • To troubleshoot: If you are running the Tomcat web server, the Atrium Integrator console log files are located in the following directory on the computer where you installed the mid tier: C:\Program Files\Apache Software Foundation\Tomcat 6.0\logs\stdout_currentDate.log
7. By default all the jobs are selected to be exported. 
   • To export selected jobs:
   1. 1. Uncheck the check box on the Job List table header.
      2. Select the jobs you want to export.
   • Similarly, you can also export specific schedules.
8. Click Export Jobs.
9. The job export status is displayed in the Export Status column. 
10. To view the details of a failed job, click the Failed status link in the Export Status column. The export job status dialog box is displayed. 
11. In case of errors, fix the errors and re-export only the updated job.
12. All the successfully exported jobs are displayed in the Atrium Integartor console.

Migrating jobs using Development-to-Production command line utility

When using the Development-to-Production command utility, consider the following:

• Migrate jobs and transformations, only between the same version of Atrium Integrator 8.1 or later.
• The schedules are not migrated. 

The development-to-production utility available at the following location:

• Microsoft Windows:
  <AR Installed Directory>\diserver\data-integration\ngie\bin\ devtoprod.cmd

• UNIX:
  <AR Installed Directory>\diserver\data-integration\ngie\bin\ devtoprod.sh

When migrating jobs, you can run the development-to-production utility from a development computer, a production computer, or even from a computer where Atrium Integrator client is installed. Ensure that you add the location of the folder from which you are running the utility in the AISrcAndTargerARDetails.properties file.

When you migrate jobs and transformations from one computer to another, only the Run History is modified.

To migrate jobs from one computer to another

1. Open the AISrcAndTargerARDetails.properties file from
   <ARInstallationDirectory>\diserver\data-integration\ngie\conf
2. Provide the source BMC Remedy AR System Application Services credentials.
3. Provide the target BMC Remedy AR System Application Services credentials.

4. Provide the backup folder location for all the .kjb and .ktrfiles that are to be exported.

   Note

   On Windows, use double slash when you specify the backup folder location for all the .kjb and .ktr files that will be exported.

   Following is a snippet of the AISrcAndTargerARDetails.properties file:
   # Fill Source AR Credentials
AR.SRC.SERVERNAME =
AR.SRC.TCPPORT =
AR.SRC.RPCPORT = 

# Fill Source AR Remedy Application Services password
AR.SRC.PASSWORD =
# Fill Target AR Credentials
AR.TARGET.SERVERNAME =
AR.TARGET.TCPPORT =
AR.TARGET.RPCPORT = 

# Fill Target AR Remedy Application Services password
AR.TARGET.PASSWORD = 
# Enter the Backup Folder Location FOR All the .KJB AND .KTR file WHICH WILL get Exported
# For Windows use  
 for path separator
AI.SRC.REPO.BACKUP.FOLDER=

5. Save the changes.
6. Run the development-to-production utility.
7. Verify if the jobs are migrated on the target computer.