RLM create repo instance


You can use this automation script to create an instance for an existing repository on BMC Release Package and Deployment by using the BMC Release Process Management user interface. For this script to work, you must have a created repository on BMC Release Package and Deployment and the repository must be in the ready state.

Inputs required while creating a step

To use this automation script in a step, specify the following inputs:

  • Repo: Select in a list of repositories present in the database of BMC Release Package and Deployment. You must select the repository for which you want to create an instance.

    Note

    You see only those repositories in this list, which are in the ready state on BMC Release Package and Deployment.

  • Instance Name: Specify the name with which you want to create an instance for the repository selected. If you leave this field blank, then the instance is created with the default name, 0.0.0.8.

    Note

    Ensure that you do not leave the Instance Name field blank if an instance with the default name, 0.0.0.8, already exists on BMC Release Package and Deployment. This is necessary to avoid the step going into a problem state.

  • Locked: To create a locked instance for the selected repository, select  Yes. Otherwise, select No.
  • Set Properties: This item is displayed only when you select a repository. The table displayed provides a list of properties that are associated with the selected repository on BMC Release Package and Deployment. You can select one of these properties to override its value with a property value in BMC Release Process Management. For this, you must first create a mapping of properties in BMC Release Process Management with that on BMC Release Package and Deployment. For more information, see Setting-property-values-for-a-package-repository-or-instance.

Expected results after running this automation script

After you run this script, you can expect to see the following results on the Automation tab in the step:

Note

The following results are only available if the step is completed successfully. If there are errors and the repository instance creation fails, then the step goes into a problem state and the errors are displayed on the Notes tab in the step.

  • Repo Instance: The database ID of the repository instance that is created on BMC Release Package and Deployment.
  • Repo Instance Log: Contains details about the snapshot of the repository instance that is created. You can download this file and save it. This file contains log details that are originally generated in BMC Release Package and Deployment. You can download the file from BMC Release Process Management.
  • Repo Instances: Provides a URL that takes you to the Deploy > Repositories page on BMC Release Package and Deployment where you can see a list of existing repository instances. You can click any of the instances to view its log details.
  • Deployment Log File: Contains log details about the repository instance deployment. This file contains log details that are originally generated in BMC Release Package and Deployment. You can download the file from BMC Release Process Management.
  • Deployment Log URL: Provides a URL that takes you to the location where the deployment log file is available on BMC Release Package and Deployment.

Associated data retriever scripts

The RLM create repo instance automation script uses the following data retriever scripts:

Data retriever script

Description

RLM repos

This script is used for retrieving repositories in the ready state that already exist in the BMC Release Package and Deployment database. The data retrieved by this script is displayed as a list when you add a step in BMC Release Process Management.

Used in the following automation scripts:

  • RLM create and deploy repo instance
  • RLM create repo instance
  • RLM deploy repo instance

RLM repo properties

This script is used for retrieving data about properties associated with the selected repository from the BMC Release Package and Deployment database. The data retrieved by this script is displayed as a table of properties with corresponding values.

Used in the following automation scripts:

  • RLM create and deploy repo instance
  • RLM create repo instance

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*