Customization and Maintenance › Update a CI Property

Update a CI Property

As an administrator, you use the WSSamCICmd.bat utility to update a subset of the service or CI properties. The utility updates one property at a time.

Follow these steps:

1. Open a command prompt, and navigate to SOI_HOME\tomcat\bin.
2. Run the following command:

   WSSamCICmd.bat -hsamanagerhost:port -uadminuser -ppassword -aUpdate ‑iInstanceID -npropertyName -vpropertyValue
   

   Note: Note the lack of spaces between the parameters and values.

   -hsamanagerhost:port

   Defines the host name and Tomcat port number of the SA Manager from which you want to update CI properties. The default Tomcat port is 7090.

   -uadminuser

   Defines the user name of the CA SOI administrator user ("samuser" user by default).

   -ppassword

   Defines the password of the CA SOI administrator user. Run WSSamEncryptCmd.bat from the same directory to generate an encrypted version of the password for use in this parameter.

   -aUpdate

   Defines to update the property of a CI. Currently this operation is the only option.

   -iInstanceID

   Defines the instanceID of the CI to update. A CI can be a service or any CI that is part of an existing service. Find the instanceID property for any CI in the Service Modeler.

   -npropertyName

   Defines the property name to update. Valid values are as follows:

   item_label

   Updates the Label property.

   item_description

   Updates the Description property.

   item_priority

   Updates the Priority property. Valid values are Low, Medium, High, and Critical.

   item_status

   Updates the Operational Mode property. Valid values are Active and In Repair.

   item_department

   Updates the Location property.

   sam_category

   Updates the Category property.

   sam_ipaddress

   Updates the IP Address property.

   -vpropertyValue

   Defines the new value for the specified property. Enter a valid value.

   The command runs. A return code of 1 indicates that the command failed. The update progress displays in the command prompt. After the update completes, a success message displays with a return code of 0.

Example: Update a Server CI Location

The following example command updates the SA_Server:server1 CI Location property:

WSSamCICmd.bat -hSAServer:7090 -usamuser -psamuserpw -aUpdate ‑iSA_Server:server1 -nitem_department -vOfficeB