Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

RLM create and deploy repo instance automation script

You can use this automation script to create an instance for a repository and deploy it on BMC VaraLogix Q Deployment Automation by using the BMC Release Process Management user interface. For this script to work, you must have an already created repository on BMC VaraLogix Q Deployment Automation.

This script creates an instance with the next available default name in the BMC VaraLogix Q Deployment Automation database. For example, if the last name with which an instance got created on BMC VaraLogix Q Deployment Automation is 0.0.0.2, then on running this script, the instance is created with the name 0.0.0.3.

Inputs required while creating a step

When you use this automation script at the time of creating a step, you must specify the following inputs:

  • Repo: Select from a list of repositories present in the database of BMC VaraLogix Q Deployment Automation. You must select that repository for which you want to create an instance and deploy it.

    Note

    You see only those repositories in this list, which are in the ready state on BMC VaraLogix Q Deployment Automation.

  • Locked: Select Yes to create a locked instance for the selected repository and select No to not create a locked instance for the selected repository.
  • Route: Select from a list of routes present in the database of BMC VaraLogix Q Deployment Automation.

  • Environment:A list of environments is populated when you select a route. You can select from a list of environments associated with the selected route.

    Note

    If an environment name used in the request of the step matches exactly with the environment name on BMC VaraLogix Q Deployment Automation, then such an environment is selected by default in the step and is suffixed with the text (inherited from request).

  • Channels: Select the channel for the deployment from the list. A list of channels is populated when you select an environment.

    Note

    In automation scripts, channels for BMC VaraLogix Q Deployment Automation are available only if you use BMC Release Process Management version 4.3.01.09 or later and the integration with BMC VaraLogix Q Deployment Automation version 4.3.01.09 or later.

  • 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 VaraLogix Q Deployment Automation. 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 VaraLogix Q Deployment Automation. For more information, see Set-property-values-for-a-package-repository-or-instance.

Expected results on running this automation script

After you run this script and the step completes successfully, you can see the following script results on the step Automation tab.

  • Repo Instance: The database ID of the repository instance that is created on BMC VaraLogix Q Deployment Automation.
  • Repo Instance Log: Contains details about the snapshot of the repository instance that was created. You can download this file and save it. This file contains log details that are originally generated in BMC VaraLogix Q Deployment Automation and is available for download from BMC Release Process Management.
  • Repo Instances: Provides a URL that takes you to the Deploy > Repositories page on BMC VaraLogix Q Deployment Automation, 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. You can download this file and save it. This file contains log details that are originally generated in BMC VaraLogix Q Deployment Automation and is available for download 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 VaraLogix Q Deployment Automation.

 If errors occur and the repository instance creation or deployment fails, the step goes into a problem state. In this case, you can see the script errors the step Notes tab.

Associated resource automation scripts

The RLM create and deploy repo instance automation script uses the following resource automation scripts:

Resource automation scripts

Resource automation script

Description

RLM repos

This script is used for retrieving repositories in the ready state, that are already existing in the BMC VaraLogix Q Deployment Automation database. The data retrieved by this script is displayed as a list while adding 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 routes

This script is used for retrieving data about routes that are already existing in the BMC VaraLogix Q Deployment Automation database. The data retrieved by this script is displayed as a list while adding a step in BMC Release Process Management.

Used in the following automation scripts:

  • RLM create and deploy package instance
  • RLM create and deploy repo instance
  • RLM deploy package instance by name

RLM route environments

This script is used for retrieving data about environments associated with the selected route from the BMC VaraLogix Q Deployment Automation database. The data retrieved by this script is displayed as a list while adding a step in BMC Release Process Management.

Used in the following automation scripts:

  • RLM create and deploy package instance
  • RLM create and deploy repo instance
  • RLM deploy package instance
  • RLM deploy package instance by name
  • RLM deploy repo instance

RLM route channels

This script is used for retrieving data about channels associated with the selected route and environment from the BMC VaraLogix Q Deployment Automation database. The data retrieved by this script is displayed as a list while adding a step in BMC Release Process Management.

Note

In automation scripts, channels for BMC VaraLogix Q Deployment Automation are available only if you use BMC Release Process Management version 4.3.01.09 or later and the integration with BMC VaraLogix Q Deployment Automation version 4.3.01.09 or later.

Used in the following automation scripts:

  • RLM create and deploy package instance
  • RLM create and deploy repo instance
  • RLM deploy package instance
  • RLM deploy package instance by name
  • RLM deploy repo instance

RLM repo properties

This script is used for retrieving data about properties associated with the selected repository from the BMC VaraLogix Q Deployment Automation 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*