Previous Topic: image—Manage OS and Boot ImagesNext Topic: delete—Delete Images from the OSIM Database


assignToTargets—Assign Image to Targets

This action assigns the specified image to a list of targets and creates new planned configurations with this image for the targets or modifies the possibly already existing ones.

The syntax of the action is as follows:

image	action=assignToTargets
name=image_name
{computer={OSIM_target_name} |
compgrp={computer_group_name} |
ccompgrp={computer_group_name sep scope}}
name

Specifies the name of an image to be installed at the specified targets

computer

Specifies the name of the OSIM targets at which the specified image can be installed. The option can be specified more than once to address a list of targets. The option should not be coded together with the option “compgrp” or “ccompgrp”.

compgrp

Specifies the name of a computer group its members that are OSIM managed systems are taken as targets for the specified image. The option can be specified more than once to address a list of groups. The option should not be coded with the option “computer”.

ccompgrp

Specifies the computer group to be addressed as a pair of group name and scope. By default, name and scope are separated by a dot ("."), but an alternate separator can be specified with the sep option. The separator should not be used as part of the names.

The option can be specified more than once to address a list of groups.

The option should not be coded with the option “computer”.

scope

For the group scope only the following values are valid:

local

The group is created at the local domain manager,

global

The group has been created at the enterprise manager and may be replicated

sep

Specifies an alternate separator used with the ccompgrp option. The separator should not be part of the group name coded with the ccompgrp options

Note: Only registered images can be assigned to targets. If an image is detected, only the error BMSAPI_IMAGE_DETECTED – “Image not registered but detected only” is reported for this image.