BLCLI updates for SP1

Service Pack 1 for BMC Server Automation 8.2 (product version 8.2.01) includes the following updates to BLCLI commands:

Namespace

Command

Server

addServer

This new command lets you add a server, even if the server is not up, or does not have an agent yet. This commmand returns the ID of the newly added server. You can later obtain this server's intrinsic properties by running an Update Server Properties job.

This command has the following inputs:

PropertyTypeDescription
serverNameStringName of the server.
shouldUpdate
IntrinsicProperties
BooleanWhether the add process should contact the agent on each server and try to retrieve the server's intrinsic properties (true/false).

Example

The following example shows you how to add a server without attempting to retrieve that server's intrinsic properties.

blcli Server addServer myServer false

Job

getTargetServers

This new command returns a comma-separated list of servers that:

  • Are targets of a specified job
  • Are in a specified state

This command has the following inputs:

PropertyTypeDescription
jobKeyDBKeyDBKey of the job.
serverStateStringA comma separated list of strings that represent server states.
Acceptable strings are:
  • DECOMMISSIONED
  • ENROLLED
  • NOT-ENROLLED

Example
The following command returns a list of server names for servers that are decommissioned or not enrolled, and that are targets of the specified job:

JOB_KEY=`blcli AuditJob getDBKeyByGroupAndName /group1 auditJob1`

blcli Job getTargetServers $JOB_KEY DECOMMISSIONED,NOT-ENROLLED
AgentBundle

The following commands require an agentPlatform input argument:

The strings for specifying Solaris 10 platforms through this argument have changed.

New stringOld string
SOLARIS 10/11 SPARCSOLARIS 10 SPARC
SOLARIS 10/11 x86SOLARIS 10 x86
Virtualization

createVirtualGuestPackage

The Virtual Guest Package (VGP) schema has been updated to support RunOnce commands for VMware Windows-based virtual machines created using a template or from existing virtual machines.

The RunOnce commands you specify run after the guest operating system starts. The operating system starts in 'logged on' mode with Administrator credentials. If you do not want the virtual machine logged on automatically, then add a reboot command to the end of the RunOnce command list (for example, shutdown /r).

Example. Here is an example from a sample VGP XML file. The following example adds a specified route in the local IP routing table:

<RunOnceCommands>
   <Command> route -p add  192.168.1.13 mask 255.255.255.0 192.168.1.1</Command>
</RunOnceCommands>

Note

You can specify only OS commands in the RunOnceCommands list; there is no support for executing multi-line scripts.

Virtualization

changeVirtualGuestPowerStatus

This command changes the power status of a virtual guest. For version 8.2 SP1, two additional options have been added to the powerStatus variable for the IBM platform: GuestShutdown and GuestReboot.

ProvisionJob

createProvisionJob

There have been changes to the way you provision an AIX system.

New system package field

Version 8.2 SP1 adds the following new field to the system package you use to provision an AIX system: IP_ADDRESS.

Overriding system package values in target.csv file

Version 8.2 SP1 also adds support for overriding AIX system package values, using the target.csv file. The possible entries in the target.csv file remain the same as in previous releases:

MAC_ADDRESS,COMPUTER_NAME,OM_SERVER_NAME,IP_ADDRESS,
SUBNET_MASK,DEFAULT_GATEWAY,OS_LICENSE,NIM_CLIENT_NAME

You can populate the target.csv file with the following values, and the target.csv values will override corresponding values in the AIX system package:

IP_ADDRESS - This is the target client LPAR IP address (new field in the AIX system package).

SUBNET_MASK - This is the client LPAR subnet mask. In previous releases, you could not use the target.csv file to override this value.

DEFAULT_GATEWAY - This is the client LPAR default gateway. In previous releases, you could not use the target.csv file to override this value.

Utility

The following commands now produce reports in XML format, rather than CSV format:


Was this page helpful? Yes No Submitting... Thank you

Comments