RLM create package instance


You can use this automation script to create an instance for an existing package 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 package on BMC Release Package and Deployment.

Inputs required while creating a step

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

  • Package: Select in a list of packages present in the database of BMC Release Package and Deployment for which you want to create an instance.
  • Instance Name: Specify the name with which you want to create an instance on BMC Release Package and Deployment. If you leave this field blank, the instance is created with the default name, 0.0.0.1.

    Note

    Ensure that you do not leave the Instance Name field blank if an instance with the default name, 0.0.0.1, 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.
  • Contents: This item is displayed when you select a package. Depending on the package that you select, the associated references are displayed.
  • Set Properties: This item is displayed only when you select a package. The table displayed provides a list of properties that are associated with the selected package on BMC Release Package and Deployment. You can select one of these properties and 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.

    Note

    The property values are overridden for the package, not an instance, in BMC Release Package and Deployment.
    If you integrate with BMC Release Package and Deployment 4.4.00.07 and later, the property values are overridden for the instance in BMC Release Package and Deployment. To use this functionality, reimport the RLM create package instance automation script.

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 package instance creation fails, then the step goes into a problem state and the errors are displayed on the Notes tab in the step.

  • Package Instance: Name of the package instance that is created.
  • Package Instance Log: Contains log details about the package instance that was created. 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.
  • Package Instances: Provides a URL that takes you to the location where the package instance log file is available on BMC Release Package and Deployment.

Associated data retriever scripts

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

Data retriever script

Description

RLM packages

This script is used for retrieving packages 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 package instance
  • RLM create package instance
  • RLM deploy package instance
  • RLM deploy package instance by name

RLM package content references

This script is used for retrieving data about references associated with the selected package from the BMC Release Package and Deployment database.

Used in the following automation scripts:

  • RLM create and deploy package instance
  • RLM create package instance

RLM package properties

This script is used for retrieving data about properties associated with the selected package 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 package instance
  • RLM create package instance
  • RLM deploy package instance by name

 

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