vseinitconfig(1M)

NAME

vseinitconfig — Configure or unconfigure the VSE Management Software

SYNOPSIS

Path: /opt/vse/bin/vseinitconfig

vseinitconfig [ -a --initconfig ] [ -F --clobber ] [-x restart_sim= { true false }]

vseinitconfig -r --unconfig

vseinitconfig { -b --backup } { -d --dir=path }

vseinitconfig { -s --restore } { -d --dir=path } { -F --clobber }

DESCRIPTION

The vseinitconfig command performs initial configuration of the Virtual Server Environment (VSE) Management Software on an HP Systems Insight Manager (SIM) Central Management Server (CMS). It can also be used to remove the existing configuration and to back up or restore the VSE Management Software database. The vseinitconfig command is installed on the CMS with the VSE Management Software.

This command performs four different functions on the CMS, corresponding to the four syntax options shown in the synopsis. With no options specified, the initial configuration function is performed.

Initial configuration after installing or updating the VSE Management Software on the CMS. This includes initial configuration of HP Integrity Essentials Virtualization Manager, HP Integrity Essentials Global Workload Manager (gWLM), and HP Integrity Essentials Capacity Advisor, as well as initialization of the VSE Management Software database.
Removal of the VSE Management Software menu items and actions from HP SIM and clearing of the VSE Management Software database. This option is automatically invoked during removal of the VSE Management Software.
Safe backup of the VSE Management Software database to protect against loss of data.
Safe restore of the VSE Management Software database from a previous backup.

Options

The vseinitconfig command recognizes the following options. Each option can be expressed in a long or short form.

If no options are specified, the initial configuration function is performed.

Title not available (Options)

-a --initconfig

Perform the initial configuration of the VSE Management Software (this is also the default function performed if no option is specified). This action requires that HP SIM is running and configured with the mxinitconfig command. This command registers the VSE Management Software tools, toolboxes, and actions with HP SIM and initializes the VSE Management Software database.

The optional --clobber or -F option causes an existing VSE Management Software database to be removed without being backed up first. If that option is not used, then an existing database will be upgraded from the previous version of the VSE Management Software.




	NOTE: Before upgrading from a previous version of the VSE Management Software, see the VSE Management Software Installation and Update Guide Version A.03.00.01 and the following description of the `--restore` option for important information.

-F --clobber

Clear any existing VSE Management Software database without backing it up.

-x restart_sim={ true | false }

This option selects whether to automatically restart HP Systems Insight Manager after initial configuration of the VSE Management Software. It is only applicable in combination with the initial configuration option (-a or --initconfig).

Use -x restart_sim=true to restart HP SIM without any further prompting after all of the VSE Management applications are configured. There can be a delay of one or two seconds after vseinitconfig finishes execution before HP SIM is ready to respond to mx... commands.

Use -x restart_sim=false to return immediately after all of the VSE Management applications are configured, without restarting HP SIM.

If this option is not used, you will be prompted whether to restart HP SIM after all of the VSE Management applications are configured.

-r --unconfig

Remove an existing VSE Management Software configuration and database.

Important: this operation will delete the contents of the VSE Management Software database. If you do not perform a backup of the VSE Management Software database before executing this step, you will lose all of your VSE Management Software data, including gWLM and Capacity Advisor configuration and historical data.

If HP SIM is not running, a script named /opt/vse/cleanup_vsemgmt.sh is generated that can be executed at a later time when HP SIM is running. This script removes the VSE Management Software tools, toolboxes, actions, and online help from HP SIM.

-b --backup

Back up the VSE Management Software database, including gWLM and Capacity Advisor data, to protect against loss of data. The VSE Management Software must be initialized before you can perform a backup. For information about initializing the VSE Management Software, see the earlier description of the --initconfig option.

The backup is created in the directory specified by the -d or --dir option. This directory must be initially empty or must not yet exist.

The backup created by this command contains only the VSE Management Software data. For information about backing up the HP SIM database, refer to the HP white paper Backing up and restoring HP Systems Insight Manager data files in an HP-UX or Linux environment, available from the Information Library link at http://hp.com/go/hpsim.

If you are creating a backup in preparation for relocating the CMS, HP recommends that you first undeploy all shared resource domains (SRDs). This will make it easier to redeploy the SRDs after the CMS is moved. To ensure that your backup includes up-to-date historic data, you should also perform the following steps:

If you are using gWLM to manage any SRDs, execute the following command on the CMS:
# gwlm history --flush
If you use Capacity Advisor, execute the following command on the CMS:
# capcollect

-s --restore

Restore the VSE Management Software database from the backup in the directory named by the -d or --dir option. The VSE Management Software must be initialized before you can perform a restore, therefore the --clobber or -F is also required in order to replace the database. For information about initializing the VSE Management Software, see the earlier description of the --initconfig option.

HP SIM must be stopped when the restore operation is performed. To stop HP SIM, execute the command mxstop on the CMS. Use mxstart to restart HP SIM after the restore operation is finished.




	NOTE: If the CMS or managed systems have been modified between the backup and the restore (for example, changing hostnames or adding or removing processors), gWLM might not function as expected after the restore. You cannot restore a backup that was created with a previous version of the VSE Management Software. The structure of the VSE Management Software version A.02.00.00 database is incompatible with version A.03.00.01. If you have not yet installed version A.03.00.01 software and you intend to restore from a version A.02.00.00 backup, perform the restore first. Then install and initialize the new software. The initialization process upgrades the already-restored database to the new format. If you have already installed version A.03.00.01 software and you need to restore from a version A.02.00.00 backup, follow these steps: Remove the VSE Management Software. For instructions, see the VSE Management Software Installation and Update Guide Version A.03.00.01. Reinstall version A.02.00.00 according to the installation instructions published with that release. Restore the VSE Management Software database from the version A.02.00.00 backup. Install the VSE Management Software version A.03.00.01. For installation instructions, see the VSE Management Software Installation and Update Guide Version A.03.00.01. Initialize the software as described in the earlier description of the `--initconfig` option. This upgrades the restored database to the new format.

Removing and Reinstalling VSE

If the VSEMgmt product is removed and reinstalled, collection of Capacity Advisor data can miss some data on the CMS. To avoid this, back up the VSE Management Software database before removing VSE, and restore the database after it is reinstalled.

RETURN VALUES

Title not available (RETURN VALUES)

0: The command completed successfully; no errors were detected.
1: An error occurred and the command did not complete successfully.

EXAMPLES

The following command performs initial configuration of the VSE Management Software, performs a backup of the VSE Management Software database if a previous version exists, upgrades the database if necessary, and prompts whether to restart HP SIM after configuration is complete.

vseinitconfig -a

The following command performs initial configuration of the VSE Management Software, removes any existing VSE Management Software database without backing it up, and restarts HP SIM automatically:

vseinitconfig -a -F -x restart_sim=true

Here is the same command, using the long form of options:

vseinitconfig --initconfig --clobber -x restart_sim=true

The following command backs up the VSE Management Software database to the directory /var/backups/2006-04-01:

vseinitconfig -b -d /var/backups/2006-04-01

Here is the same command, using the long form of options:

vseinitconfig --backup --dir=/var/backups/2006-04-01

You can mix the short and long form options. For example, to restore the VSE Management Software database from the directory /var/backups/2006-04-01, you can use the following command:

vseinitconfig --restore -d /var/backups/2006-04-01 -F

AUTHORS

vseinitconfig was developed by Hewlett-Packard Company.

FILES

Title not available (FILES)

/var/opt/vse/logs/vseinitconfig.log: Errors and exceptions reported by vseinitconfig are logged here.