Installation guide

Table Of Contents
Installation Options with Default
Values
Description
CSI_LOCALE=
Keep the locale configuration option unspecified in the
csi.config file when installing the Agent.
If you configure the value, it supercedes the data encoding
locale on the target operating system. The locale, which
should be a UTF-8 locale, affects the internal data conversions
on non-ASCII data performed by VCM, but the setting does
not affect how the collected data is displayed in VCM. This
configuration value is used to resolve any problems with data
conversions after you install the Agent.
If this value is left blank, the Agent installation scripts attempt
to find an appropriate value for the CSIRegistry base on the
following rules presented in order of precedence.
1. The optional CSI_LOCALE value set is in the csi.config
file.
By default, the entry is blank in the csi.config file package
in the Agent. If this value is set, the Agent installation
script uses the provided value. During the installation of
the Agent, the value is checked against the operating
system to ensure that it is a valid value. If the value is not
valid, it is still used and is set as the value in the
CSIRegistry, but the process logs and displays an
installation error. The Agent uses what is in the
CSIRegistry.
2. The default locale on the target operating system at
installation time is {some locale value}.utf8. For example,
en_US.UTF-8.
The value is added to the CSIRegistry.
3. The default locale on the target operating system is not
UTF-8, but has a UTF-8 locale installed. For example, if the
default locale is en_US.8859-15 and en_US.UTF-8 is
installed on the system, en_US.UTF-8 is used.
The UTF-8 locale is added to the CSIRegistry.
4. No default locales are specified on the target operating
system.
The Agent installation script runs the locale -a command
and adds the first installed UTF-8 locale that it finds to the
CSIRegistry.
5. The operating system is not configured for any
internationalization.
The C locale, which is the locale that is used to specify
plain ASCII, is added to the CSIRegistry, but processes the
logs and displays an i18n warning.
If you interactively install the Agent, the Agent installation
Configuring Linux, UNIX, and Mac OS X Machines
VMware, Inc.
131