Previous Topic: Hash Password OptionNext Topic: Run Report Option

Using the Command-line Interface › ccautil › Refresh Service or Server Option

Refresh Service or Server Option

The following command refreshes the identified service or server and directs ccautil to perform other optional tasks (listed in square brackets):

ccautil -task refresh
-s <server:port_number>
-u <user_name>
-p <password> or -pwfile </path/filename>
-service
-server
-id <service/server_UUID>
-servicename <service_name>
-servername <server_name>
[-job <refresh_jobname>]
[-snap]
[-cd]
[-rc]
[-date <mm/dd/yyyy>]
[-time <hh:mm>]

[-delay <secs>]
[-n error or -n completion]
[-email <email_account@your_company.com>]
[-emailsubject <email_subject>]
-s <server:port_number>

Specifies the CA Configuration Automation Server name and port number for which you want to refresh a service.

-u <user_name>

Specifies a valid CA Configuration Automation Server user login name.

-p <password>

Specifies the user’s password. The password shows as clear text on the command line. Alternatively, you can create and use a scrambled password file for authentication. For more information, see Hash Password Option.

-pwfile </path/filename> (on UNIX servers) or -pwfile <\path\filename> (on Windows servers)

Specifies the user’s password file. You can use this argument instead of -p password.

-id <service_uuid> or <server_uuid>

Specifies the service or server ID number returned from the -task listservices query operation of the service or server you want to refresh. Use this argument and the -servicename or -servername arguments to uniquely identify the service or server you want to refresh.

-servicename <service_name>

Specifies the name of the service you want to refresh.

-servername <server_name>

Specifies the name of the server you want to refresh.

[-job <refresh_jobname>]

Specifies a job name for the Refresh operation. If no name is specified, the CLI uses refresh_jobname, ccautil.

[-snap]

Creates a Snapshot of the current data.

[-cd]

Runs Change Detection between the current data and the most recent Snapshot.

[-rc]

Runs Rule Compliance to verify service and Blueprint rules on the current data.

[-date mm/dd/yyyy]

Specifies the date the Refresh operation is to run. If no date is specified, the CLI uses today's date.

[-time hh:mm]

Specifies the time (24-hour clock) the Refresh operation is to run. If no date is specified, the CLI uses the current time.

[-delay secs]

Specifies the number of seconds to delay the start of the Refresh operation. You can specify any integer.

Note: This feature is unique to the CLI and is not available in the CA Configuration Automation Server GUI.

[-n]

Specifies if a Refresh job completion or failure notification is to be sent, depending on how you append the argument. If notification is to be sent, you must also specify the -email argument with a valid email account. For more information, see the details for each of these arguments.

[-n error]

Sends email notification only if remediations or rule violations are detected.

[-n completion]

Sends email each time a Refresh operation completes.

[-email <email_name@company.com>]

Specifies that an email notification be sent and specifies the email account to send the notification to. Specify this argument with the -n argument.

[-emailsubject <email_subject>]

Specifies the subject line of any sent email notifications.

Usage Example