p2vassist(1M)

NAME

p2vassist — Physical to virtual migration assistant.

SYNOPSIS

p2vassist function-number

DESCRIPTION

The p2vassist command is a menu-driven application that helps migrate applications from a running physical or virtual machine to another. To start the script, enter the p2vassist command:

# p2vassist
P2V Assistant Manager
======================================

 1 ) General Configurations
 2 ) Manage Applications
 3 ) Manage O.S. Images
 -----
 0 ) Exit

Enter Option Number:

The choose from the following menu options:

1

General Configurations

This function sets the server from where the installation depot will be obtained. The format accepted is the same as option -s to the swinstall command. The following example configures a server called server.abc.com and a depot location on /release/1123.0706/ic054 as the depot server:

General Configurations
======================================

 1 ) Set Source Depot
 -----
 0 ) Return

Enter Option Number: 1

In this option you can set the location of the depots
of the application to be installed on the target system.
It can be a hostname or a local directory.

Depots source currently configured: NONE
Depots source (type 'q' to return)

Enter the full path for the depot location. For example:

server.abc.com:/release/1123.0706/ic054

2

Manage Applications

Use this menu to list the depots installed on the server, and to select the depots to consolidate and the directories with the application data. Entering this option displays the following menu:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

List Applications

This option lists the products installed on the server. You can obtain the names of the depots to consolidate from this listing. The list returned does not contain Operational Environment related packages. The list of packages to exclude is stored in a configuration file (see the Add Data Directories/Files item in this list). For example:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 1

  ACXX                  C.06.00        HP aC++
  BullseyeCoverIA       7.5.61         HP-UX IA
  C-ANSI-C              C.06.10        HP C/ANSI C Compiler
  C-Dev-Tools           B.11.23.11     C Language Development Tools
  gcc                   4.1.0          gcc
  gdbm                  1.8.3          gdbm
  .
  .
  vim                   7.0            vim
  xpm                   3.4k           xpm
  zlib                  1.2.3          zlib

The listing shown on your system might differ from this example.

Select Applications

A list of depots (space separated) is the input to this option. The script verifies whether the depots displayed belong to the list of installed software. The following example shows the addition of four depots (belonging to the web server suite):

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 2


  Select Applications
==============================

Please enter the list of depots to be installed on the target
system, separated by spaces.
You can list the applications using the first option of this menu.
Depots list (type 'q' to return):

Enter the names of the depots. For example:

hpuxwsAPACHE hpuxwsTOMCAT hpuxwsWEBMIN hpuxwsXML

Add Data Directories/Files

Specifies the directories or files that contain the application configuration and data. Enter absolute paths that refer to directories and files that already exist. Some known, system-level directories are rejected by default (such as ./, /var, and /usr). If you specify a software depot, p2vassist reads the data directories from the depot definition. These directories appear as a suggestion to the user.

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 3

Please enter the list of directories/files to be transferred to the
target system, separated by spaces.

The following directories are obtained by examining the depot configuration, you may copy them to the prompt
below in order to be used:

 /opt/hpws/apache /opt/hpws/tomcat /opt/hpws/webmin

List (type ENTER to return):

For example:

List (type <Enter> to return): /opt/hpws/apache /opt/hpws/tomcat /opt/hpws/webmin

Consolidate Applications

Consolidates the selected applications, along with their directories and files, to the specified server. For example:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 4

Consolidate Applications
==============================

This option will consolidate application(s) installed
on the current system and then migrate into another a
suitable target system. The target system is the machine
which will host the consolidated application(s).
This wizard requires that non-interactive Secure Shell
(ssh) access be set up between this system and the
target server.


Depots source currently configured: depsrv.hp.com:/release/1123.0706/ic054
Depots to be installed: hpuxwsAPACHE hpuxwsTOMCAT hpuxwsWEBMIN hpuxwsXML

Dirs/Files to be transferred: /opt/hpws/apache /opt/hpws/tomcat /opt/hpws/webmin

Please enter the hostname/IP of the target system (type 'q' to return): vmp2V

After you press Enter, the process continues:

Querying the system vmp2v for current status, this may take a few moments...
Installing depots...

Press <Enter> to continue and begin transferring files.

Transferring Configuration files...
Checking application disk space...
Application disk space Ok.
Transferring /opt/hpws/apache directory to vmp2v, please wait...
Transferring /opt/hpws/tomcat directory to vmp2v, please wait...
Transferring /opt/hpws/webmin directory to vmp2v, please wait...
Application Sucessfully consolidated on host: vmp2v
Press <Enter> to return to menu:

3

Manage Operating System Images

This option is not supported in the current version of Integrity VM.

RETURN VALUES

Upon completion, the p2vassist command returns with one of the following values:

0: Successful completion. The application was successfully consolidated.
1: An error occurred.

EXAMPLES

The following example shows how to consolidate applications:

# p2vassist
P2V Assistant Manager
======================================

 1 ) General Configurations
 2 ) Manage Applications
 3 ) Manage O.S. Images
 -----
 0 ) Exit

Enter Option Number: _1_

General Configurations
======================================

 1 ) Set Source Depot
 -----
 0 ) Return

Enter Option Number: 1

In this option you can set the location of the depots
of the application to be installed on the target system.
It can be a hostname or a local directory.

Depots source currently configured: NONE

Depots source (type 'q' to return): server.abc.com:/release/1123/ic054

After the depot source is defined, select the application depots to be installed. To obtain the correct name of the depots, list the installed applications:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 1

  ACXX                  C.06.00        HP aC++
  AudioDevKit           B.11.23.10     HP-UX Audio Desktop Developer Kit
  C-ANSI-C              C.06.10        HP C/ANSI C Compiler
  C-Dev-Tools           B.11.23.11     C Language Development Tools
  gcc                   4.1.0          gcc
  gdbm                  1.8.3          gdbm
  .
  .
  hpuxwsAPACHE          B.2.0.55.03    HP-UX Apache-based Web Server
  hpuxwsTOMCAT          B.5.5.9.04     HP-UX Tomcat-based Servlet Engine
  hpuxwsWEBMIN          A.1.070.07     HP-UX Webmin-based Admin
  hpuxwsXML             A.2.00         HP-UX XML Web Server Tools
  .
  .
  vim                   7.0            vim
  xpm                   3.4k           xpm
  zlib                  1.2.3          zlib

This example shows the correct names of the depots that can be obtained. In this example, consolidates the web server suite (hpuxwsAPACHE, hpuxwsTOMCAT, hpuxwsWEBMIN and hpuxwsXML).

To enter these names, choose Option 2 from the Manage Applications menu. Then type the depot names at the prompt. For example:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 2


  Select Applications
==============================

Please enter the list of depots to be installed on the target
system, separated by spaces.
You can list the applications using the first option of this menu.

Depots list (type 'q' to return): hpuxwsAPACHE hpuxwsTOMCAT hpuxwsWEBMIN hpuxwsXML

After setting the depots, choose the directories to be transferred, along with the installed product. The p2vassist utility scans the configuration of the depots to make a list of the directories. To specify a directory, copy the string to the prompt. For example:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 3

Please enter the list of directories/files to be transferred to the
target system, separated by spaces.

The following directories are obtained by examining the depot configuration, you may copy them to the prompt
below in order to be used:

 /opt/hpws/apache /opt/hpws/tomcat /opt/hpws/webmin

Please enter directories or files: /opt/hpws/apache /opt/hpws/tomcat /opt/hpws/webmin

Finally, consolidate the application on the new host:

Manage Applications
======================================

 1 ) List Applications
 2 ) Select Applications
 3 ) Add Data Directories/Files
 4 ) Consolidate Applications
 -----
 0 ) Return

Enter Option Number: 4

         Consolidate Applications
        ==============================

        This option will consolidate application(s) installed
        on the current system and then migrate into another a
        suitable target system. The target system is the machine
        which will host the consolidated application(s).
        This wizard requires that non-interactive Secure Shell
        (ssh) access be set up between this system and the
        target server.

        Depots to be installed: Firefox

        Dirs/Files list not defined.
        Please enter the hostname/IP of the target system: vmp2v

        Querying the system vmp2v for current status,
        this may take a few moments...
        Installing depots...

        Transferring Configuration files...
        Checking application disk space...
        Application successfully consolidated on host: vmp2v

        Press <Enter> to return to menu:

AUTHORS

The p2vassist command was developed by the HP.

p2vassist(1M)

Technical documentation

» Table of Contents

» Glossary