HP Systems Insight Manager - Manual (Page 92)

19 CMS Reconfigure Tool
The CMS Reconfigure Tool feature provides a set of commands that enable you to quickly make
common reconfiguration changes to HP SIM, HP Insight Control, HP Virtual Connect Enterprise
Manager, and HP Matrix OE.
The challenge in attempting to make operating system or CMS configuration changes is the difficulty
in knowing exactly what steps need to be performed on a particular operating system/CMS installed
environment. The mxreconfig command fills the need for an automated application tool to
perform these tasks for the Insight Management software components.
The CMS Reconfigure Tool is supported through HP SIM and only on systems running Microsoft
Windows with SQL server.
Prior to executing any CMS Reconfigure Tool command, ensure the CMS and associated database
are backed up. For information about backing up the CMS, see the Backing up and restoring HP
Insight Software Central Management System (Windows) white paper at:
www.hp.com/go/
insightsoftware/docs .
Operational Commands, Options and Parameters
Operational command type options for mxreconfig are those designated single-char options that
must be the first option placed on the entered command line string. These type options may or may
not require an additional argument string. For example, the operational command option ‘-m’
(mode) option requires an argument. This operational option is used to specify a particular
reconfiguration mode. The required associated argument string identifies which specific
reconfiguration task mode needs to be performed in the specified mode, such as ‘host’ (to change
host name) or ‘password’ (to change password).
An example of an mxreconfig command is shown below. This command is a request to change
the CMS host name (additional command line options and arguments would be required for this
particular reconfiguration command and are described later).
>mxreconfig –m host
An example of an operational command option that does not require an argument is the ‘-h’ (help)
option. This operational option is used to show brief online help usage text in the console. No
associated argument string is required.
>mxreconfig –h
Parameter type options are those single-char options that follow the operational command option
on the entered command line string. These type options may be required or may be optional for
the specified operational command option being given, and the parameter option itself might not
require an additional argument string. An example of using a parameter type option is the ‘-a’
option which is used to specify the database user name. This particular type parameter option
does require an additional string argument, which is the actual specified database username.
>mxreconfig –m dbauth –a db-username-here
The usage of the available commands depends on the products you have installed. See the HP
Systems Insight Manager Command Line Guide for information on the command options, arguments,
and parameters.
Reconfiguring the CMS password
The mxreconfig —m password command prompts you for a new password and changes the
credentials configured. The mxreconfig –m password command realigns the Insight
Management software services account credentials with the operating system password (after this
has been changed). If the user that installed Insight Management software changes the Windows
logon password, then that user must also run this command to make Insight Management software
match the new operating system password.
92 CMS Reconfigure Tool