This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

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. 

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 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. 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.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Mahamadou Traore

    Hi BMC, Can you double here. ''•Only the parent jobs are displayed in the Job List table. However, all the associated sub jobs and transformations are also migrated.''

    because migrating the jobs from one server to another using the export congiguration Tool, the transformation are not migrated.

    Nov 15, 2018 02:41
    1. Maithili Deshpande

      Hi Mahamadou, 

      Thank you for your comment. Will check with the SME and respond at the earliest. 

      Regards,

      Maithili

      Nov 19, 2018 01:54
    1. Maithili Deshpande

      Hi Mahamadou, 

      We tried this feature in our environment and the sub jobs and transformations are migrating using the export configuration tool. If it is not working properly for you, we recommend you reach out to BMC Support.

      Feel free to reach out to us for any other queries. 

      Regards,

      Maithili

      Apr 19, 2019 07:11
      1. Mahamadou Traore

        Hi Maithili,

        I raised a case, BMC responded by as design. They told me only the jobs and subjob are exported not the transformation. What version are you in?

        Apr 23, 2019 09:43
        1. Maithili Deshpande

          Hi Mahamadou, 

          It was the version 9.1.00 that we checked. However, let me share your feedback with the SME.

          Thanks!

          Regards,

          Maithili

          May 02, 2019 06:47