Previous Topic: unseal—Unseal a Software PolicyNext Topic: deregister—De-register Software Policy from Domain


register—Register Software Policy at Domain

This action registers a software policy from the enterprise manager at a domain.

The syntax of the action is as follows:

swPolicy	action=register
{names=software_policy_name}
[dname=distribution_name]
[{{area=area_name}|
{domain=domain_name}| toAllAreas}
[sendtime=yyyy-mm-dd HH:MM]
[halttime=yyyy-mm-dd HH:MM]]
[replace]
[distPriority={1,...,10}]
names

The name of the software policy to be distributed and registered. To process a list of policies the argument can be coded more than once.

dname

Name of the distribution used to send the registration request to the addressed DSM domains. If such a distribution exists and is not yet sealed then the order is added to this distribution. If the distribution is already sealed then the action terminates with error.

If a distribution of the specified name does not exist then it is created.

If this option is not specified a default name is generated and reported by the CLI on stdout.

area

Specifies the name of a DSM domain the registration request is sent to. This parameter can be coded more than once to specify a list of DSM domains to be addressed.

If this option is coded then the associated distribution is sealed and scheduled for processing.

This option should not be coded if the “domain” option or the “toAllAreas” option is coded.

domain

Specifies the name of a DSM domain group the registration request is sent to. This parameter can be coded more than once to specify a list of DSM domain groups to be addressed.

If this option is coded then the associated distribution is sealed and scheduled for processing.

This option should not be coded if the “area” option or the “toAllAreas” option is coded.

toAllAreas

If coded the related distribution is sent to all domain managers registered at the enterprise manager.

If this option is coded then the associated distribution is sealed and scheduled for processing.

This option should not be coded if the “area” option or the “domain” option is coded.

sendtime

Specifies the start time for the processing of the distribution at the enterprise manager. The date is specified in ISO format. If this option is not coded then the actual date/time is taken.

halttime

Specifies the time the processing of distribution is being stopped. The date is specified in ISO format. If this option is not coded then the actual date/time + 1h is taken.

replace

If this option is specified then the software policies are updated. If this option is not coded then the software policies are created, but if they are already exist an error is reported.

distPriority

Specifies the priority assigned to the distribution. The priority is numeric with values from 1 (highest priority) to 10 (lowest priority).
Default: 5

Note: If neither the option “area” nor the option “domain” nor “toAllAreas” is coded then the distribution remains unsealed and further orders can be added to it.