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.

Configuring the eZDeploy utility

This topic describes how to configure the eZDeploy utility.

This topic covers the following:

Before you begin

Before you configure the eZDeploy utility, ensure that all of the following conditions are met:

  • Install Java Runtime Environment (JRE) 1.6 or later on the machine on which you will run the eZDeploy utility.
  • Set JAVA_HOME.
    For Windows, go to Advanced System Settings > Environment Variables; then click New System Variables and add JAVA_HOME as the variable name and <JRE Path> as the value.
    For Linux, export JAVA_HOME=<JRE Path>.
  • Download and install the BMC Server Automation console on the machine on which you will run the eZDeploy utility.
  • Ensure that the version of the BMC Server Automation console matches the version of the target BMC Server Automation Server from the BMC Coud Lifecycle Management setup. Also ensure that Network Shell (NSH) is installed along with the BMC Server Automation console.
  • Ensure that the BMC Server Automation user assigned the Bladelogic Administrator role is used to create the eZDeploy authentication profile in BMC Server Automation.

  • Ensure that you have NSHDIR set in the environment variables.

    Windows

    Linux

    Open Advanced Properties; then, from the Environment Variables section, create a new environment variable with the following specifications:
    Name: NSHDIR

    Value: C:\Program Files\BMC Software\BladeLogic\NSH

    $ export NSHDIR = /opt/bmc/BladeLogic/NSH

    Check the following file: /usr/lib/rsc/HOME

    The contents of this file should also match the NSH install directory; for example:

    C:\Windows\rsc>more HOME
    /cygdrive/C/Program Files/BMC BladeLogic/OM/NSH

    Check the following file:
    /usr/lib/rsc/HOME

    [root rsc]# pwd

    /usr/lib/rsc

    [root rsc]# more HOME

    /usr/nsh/NSH

Creating an eZDeploy profile

You must create an eZDeploy profile before you start using the import and export functionality of the eZDeploy utility. You can create a profile using the profile command on the command-line interface (CLI). Before you create eZDeploy profiles, the CLI requires the Enterprise AR server details. It automatically gets the BMC Cloud Lifecycle Management Platform Manager details, the associated BMC Server Automation details, and the BMC Atrium Orchestrator details from the BMC Cloud Lifecycle Management configuration files.

To create an eZDeploy profile, perform the following steps: 

  1. Run the following command:

    eZDeploy> profile add -name <PROFILE_NAME> -host <AR_HOST/IP> -port <AR_PORT> -user <AR_USER>

    The following table lists the inputs that you must provide to run the command:


    Field name

    Input

    Name

    eZDeploy profile name

    Host

    BMC Cloud Lifecycle Management Enterprise AR host name or IP address

    User

    BMC Cloud Lifecycle Management Enterprise AR Admin username

    Note: Ensure that the BMC AR System server user has the Administrator and Cloud Administrator privileges.

    Port

    BMC Cloud Lifecycle Management Enterprise AR port

    Password

    (Optional) BMC Cloud Lifecycle Management Enterprise AR Admin password

  2. Press Enter. 
    The eZDeploy profile is created and eZDeploy stores the BMC Server Automation Server and Atrium Orchestrator Server details.
  3. Verify that the eZDeploy profile is created correctly:
    1. Use the profile list command to view the profile details. See To view eZDeploy profiles for details.
    2. Navigate to your eZDeploy environment's BMC Server Automation console and ensure that the prefix "eZProfile-" is appended with the BMC Server Automation Server Name in the newly created BMC Server Automation Authentication Profile.
      If you cannot view the profile, relaunch the BMC Server Automation console.

Note

If eZDeploy fails to detect BMC Server Automation or Atrium Orchestrator configuration, it will prompt you for the following inputs:

  • For BMC Server Automation, you need to provide the BMC Server Automation Host, Username, Password, and Authentication Port.
  • If you want to add BMC Atrium Orchestrator details, you need to provide BMC Atrium Orchestrator Repository details such as, Atrium Orchestrator Repository host, Username, Password, and Port. Ensure that you have provided the correct BMC Atrium Orchestrator details because eZDeploy does not validate these details when you create a user profile.

Accepting the BSA Authentication Service X509 certificate

You must accept the BMC Server Automation Authentication Service X509 certificate by using one of the following methods:

  • Log in with the new BMC Server Automation authentication profile that is created and accept the certificate.

    Certificate.png
  • If you are running eZDeploy on a Linux system and you do not have a user interface for the BMC Server Automation console, run the following command and press Enter:
Accept X509 Certificate
blcred cred -acquire -username <BSA Server Username> -password <BSA Server Password > -profile <eZProfile>

Certificate1.png

Viewing eZDeploy profiles

To view the list of eZDeploy profiles that you created, run the following command:

 eZDeploy> profile list and press Enter. 
A list of profiles is displayed.

Image_3.png

Deleting an eZDeploy profile

To delete a particular eZDeploy profile, run the following command:

eZDeploy> profile delete -name <Profile Name> and press Enter. 
The profile is deleted.

For example: eZDeploy> profile delete -name Source

Where to go from here

Using-the-eZDeploy-1-0-00-utility

Using-the-eZDeploy-1-1-00-utility

 

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