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

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:

Property

Type

Description

serverName

String

Name of the server.

shouldUpdate
IntrinsicProperties

Boolean

Whether 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

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:

Property

Type

Description

jobKey

DBKey

DBKey of the job.

serverState

String

A 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

The following commands require an agentPlatform input argument:

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

New string

Old string

SOLARIS 10/11 SPARC
SOLARIS 10 SPARC
SOLARIS 10/11 x86
SOLARIS 10 x86

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.

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.

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.

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


 

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