Export

Exports a policy group in zip file format to the specified target. The policy group may be from the policy group repository or it may be an entity policy group.

Syntax

export [--username=<name>] [--name=<policy group name>] [--scope=<user/host>] [--entity=<entity name>] <target>

--username=<name> : the username of the administrator in the format used by the configuration repository, for example “jmonroe”.

--name=<policy group name> : specifies the name for the policy group. This option is not used with the --entity option as entity policy groups have restricted default names. There may be two policy groups in the policy group repository with the same name, one with user scope, the other with host scope. If the scope is not specified then it defaults to the user scope.

--scope=<user/host> : specifies the scope for the policy group. This can be either user or host. If the scope is not specified then the default is user.

--entity=<entity name> : the entity where the policy group is stored. This option may not be used with the --name option, since entity policy groups have restricted default names. If this option is not specified then the policy group is part of the policy group repository. The entity name is specified in the format used by the storage back end, for example with the LDAP back end the entity is specified using a distinguished name.

<target> : the path and file name where the zip file is to be stored. If no filename is given then it defaults to /tmp/<policy group name>.zip. If the target is not writeable, then the command exits with an error.

Example 3–4 Exporting a policy group

% pgtool export --scope=host --name=HostPolicyGroup1 --username=jmonroe /tmp/newdir

Exported “HostPolicyGroup1” to HostPolicyGroup1.zip, which was created in new directory /tmp/newdir.