vseinitconfig(1M)

NAME

vseinitconfig — Configure or unconfigure the VSE Management Software

SYNOPSIS

Path (HP-UX): /opt/vse/bin/vseinitconfig

Path (Windows): install-path\bin\vseinitconfig

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

(Initial software configuration)

vseinitconfig { -r --unconfig } [ -F --clobber ] [ -q --quiet ]

(Unconfigure software for removal)

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

(Backup the PostgreSQL database on HP-UX CMS)

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

(Restore the PostgreSQL database on HP-UX CMS)

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. (Backup and restore functions are only available on a CMS running HP-UX using the PostgreSQL database.). The vseinitconfig command is installed with the VSE Management Software on both HP-UX and Microsoft® Windows® CMS.

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 Virtualization Manager, HP Global Workload Manager (gWLM), and HP 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, in preparation for removal of the VSE Management Software.
Safe backup of the VSE Management Software database to protect against loss of data (on a CMS running HP-UX using the PostgreSQL database).
Safe restore of the VSE Management Software database from a previous backup (on a CMS running HP-UX using the PostgreSQL database).

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.

On an HP-UX CMS, 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. This does not apply to a Microsoft Windows CMS.




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

-F|--clobber

Clear any existing VSE Management Software database without backing it up. For more information about how this option affects vseinitconfig, see the descriptions of the options -a|--initconfig and -r|--unconfig.

-q|--quiet

Do not display any output. Do not prompt for HP SIM restart after performing the initial configuration operation. You can view the console and error output in the log files.

-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 the installed VSE Management Software tools from HP SIM. The existing database and configuration information will not be removed unless the optional --clobber or -F option is used.

Important: The optional --clobber or -F option causes an existing VSE Management Software database to be removed without being backed up first. If you do not perform a backup of the VSE Management Software database before executing this command, you will lose all of your VSE Management Software data, including gWLM and Capacity Advisor configuration and historical data.

-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.




	NOTE: This option is only available on a CMS running HP-UX using the PostgreSQL database.

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.




	NOTE: This option is only available on a CMS running HP-UX using the PostgreSQL database.

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 an older version of the VSE Management Software. The structure of the database used by older versions of the VSE Management Software is incompatible with the current version. If you have not yet installed the current version of the software and you intend to restore from an older version 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 updated the software and you need to restore from an older version backup, follow these steps: Remove the VSE Management Software. For instructions, see the VSE Management Software Version 4.0 Installation and Update Guide for HP-UX. Reinstall the older version of the VSE Management Software according to the installation instructions published with that release. Restore the VSE Management Software database from the older version backup. Install the VSE Management Software version A.04.00.07. For installation instructions, see the VSE Management Software Version 4.0 Installation and Update Guide for HP-UX. 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/2008-04-01:

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

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

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

The following command performs the unconfigure operation, removing the VSE Management Software tools from HP SIM. The --clobber option causes the database information to be removed without making a backup:

  vseinitconfig --unconfig --clobber

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

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

AUTHORS

vseinitconfig was developed by Hewlett-Packard Company.

FILES

The console (non-error) output from the vseinitconfig commandis written to the following log file:

HP-UX:: /var/opt/vse/logs/vseinitconfig_output.log
Windows:: install-path\logs\vseinitconfig_output.log

Errors and exceptions reported by vseinitconfig, are written to the following log file:

HP-UX:: /var/opt/vse/logs/vseinitconfig.log
Windows:: install-path\logs\vseinitconfig.log