Profile parameters are needed to run IBM® Tivoli® Storage FlashCopy® Manager for VMware.
The parameters are contained in a profile file.
A profile file must be available on the server where the
management agent, the
acsd daemon, is running.
The
Tivoli Storage FlashCopy Manager for VMware profile
is created or updated by using the setup script. The standard profile
is called
profile and is in the
$HOME/tdpvmware/config/ directory.
The following symbolic links reference the
profile file:
- vmcliprofile in the /opt/tivoli/tsm/tdpvmware/common/scripts directory
- profile in the /opt/tivoli/tsm/tdpvmware/fcm directory
The elements of the profile are not case-sensitive. By convention,
the section and the parameter names are shown in uppercase in the
profile file. The
ACS_DIR profile parameter is used
to define the configuration directory.
Tivoli Storage FlashCopy Manager for VMware profile
sections
In the
Tivoli Storage FlashCopy Manager for VMware profile
file, the profile parameters are categorized into sections. Each section
of the profile file contains information that is relevant to that
section. The profile is structured into five named sections.
- GLOBAL
- ACSD
- VMWARE
- VMCLI
- DEVICE_CLASS
The profile file can have more than one DEVICE_CLASS section,
and each section must have a unique instance name. The DEVICE_CLASS
sections can be named and renamed by using the setup script. Each
occurrence of the DEVICE_CLASS section has a unique set of parameters.
The
named sections of the profile are described in the following paragraphs:
- GLOBAL section
- The GLOBAL section contains information that is used by all Tivoli Storage FlashCopy Manager for VMware components.
Each Tivoli Storage FlashCopy Manager for VMware component
evaluates this section once, when Tivoli Storage FlashCopy Manager for VMware is
started. Changes within this section require a restart of Tivoli Storage FlashCopy Manager for VMware before
they become effective. The GLOBAL section is also used to specify
the location for logging, tracing, and password files.
- ACSD section
- The ACSD section contains information that is used by the management
agent (acsd). This section includes the ACS_REPOSITORY parameter,
which specifies the directory where the management agent stores the
backup repository. This repository is the most important collection
of Tivoli Storage FlashCopy Manager for VMware data.
If the repository is lost, any previously created backup cannot be
restored.
Important: You must back up the snapshot backup
repository regularly. This backup does not happen automatically.
- VMWARE section
- The VMWARE section contains the parameters that are related to
backups and restores in a virtual system. The parameters in the VMWARE
section specify options that are related to the VMware vCenter Server
and its environment.
- VMCLI section
- The VMCLI section contains parameters that specify the vmcli database and
the Data Protection for VMware command-line interface.
- DEVICE_CLASS section
- The DEVICE_CLASS section contains parameters that are related
to the storage system. At least one DEVICE_CLASS section is required
to configure the management agent. A DEVICE_CLASS section describes
the characteristics of a storage device and is dependent on the specific
storage subsystem. You can specify multiple DEVICE_CLASS sections
within one profile and assign unique names to each section. The parameter
values for each device class section are recorded in the Tivoli Storage FlashCopy Manager for VMware repository
to identify the appropriate DEVICE_CLASS section that is used during
restore processing. For each storage device, a password is required.
The setup script prompts you to enter parameter values that are specific
to your storage system, the vCenter password, the acsd management
agent password, and the device class passwords. The following command
starts the setup script:
setup.sh
The passwords
can also be set by using the fcmcli command fcmcli
-f password. These passwords are used by Tivoli Storage FlashCopy Manager for VMware to
authenticate to the storage subsystem that is represented by the associated
DEVICE_CLASS section.
A profile is created in the $HOME/tdpvmware/config/profile directory
where $HOME is the home directory of the user name
created during the installation. The profile contains the configuration
information for Tivoli Storage FlashCopy Manager for VMware.
Changes to the profile take effect immediately, except when the GLOBAL
or ACSD sections of the profile file are modified. Run the ./setup.sh script
to configure additional parameters in the profile file.
See the topic "Configuring using the setup script" in the Configuring Tivoli Storage FlashCopy Manager for VMware section for
details.