This documentation supports the 20.02 version of BMC CMDB.

To view an earlier version, select the version from the Product version menu.

Migrating Atrium Integrator jobs and transformations

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

Migrating jobs by using Atrium Integrator Spoon

You can export and import jobs by using Atrium Integrator Spoon. 

To export jobs by using Atrium Integrator Spoon

  1. Log into Atrium Integrator Spoon.
  2. Navigate to Tools > Repository.

  3. Select Export Repository.
  4. Give a name to the repository file to be exported and click Export.

For additional information on Export Repository, refer to Pentaho documentation.


To import jobs by using Atrium Integrator Spoon

  1. Log into Atrium Integrator Spoon.
  2. Navigate to Tools > Repository.

  3. Select Import Repository.
  4. Browse to the location where your files are located and select the file to import.


Migrating jobs by 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 CMDB 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. 

Note

Unlike the Development-to-Production command line utility, when you migrate jobs using the Export Configuration tool, you don't need a backup folder (staging area) for copying the .kjb and .ktr files.

To migrate jobs by using the Export Configuration tool

  1. Launch the Atrium Integrator console. 
  2. In the tool bar, click Export Configuration tool.
    The Export Configuration 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. 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 Integrator console.


Migrating jobs by 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 Remedy Action Request System Application Services credentials.
  3. Provide the target Remedy Action Request 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.


Was this page helpful? Yes No Submitting... Thank you

Comments