Job Management Partner 1/Performance Management User's Guide

8.3.4 Backing up and restoring bookmark definition information

This section describes backing up and restoring bookmark definition information in the following cases:

• When bookmark definition information is located in the default directory
• When you want to change the location of bookmark definition information to a different directory
• When you want to change the PFM - Manager host connection, and inherit the bookmarks created before the change
• When you want to migrate PFM - Manager and PFM - Web Console to a cluster configuration, and inherit the bookmarks that existed before the migration
  

  Note

  When backing up or restoring the bookmark definition information, make sure that the related directories are manually copied to an appropriate location after stopping the PFM - Web Console service. However, you should back up and restore the entire directory that contains the bookmark definition information as well as a part of files and directories at one time.

Organization of this subsection

(1) When bookmark definition information is located in the default directory

(2) When you want to change the location of bookmark definition information to a different directory

(3) When you want to change the PFM - Manager host connection, and inherit the bookmarks created before the change

(4) When you want to migrate PFM - Manager and PFM - Web Console to a cluster configuration, and inherit the bookmarks that existed before the migration

(1) When bookmark definition information is located in the default directory

The default location of the bookmark definition information and bookmark folders is as follows:

installation-folder^#\bookmarks (in Windows)

/opt/jp1pcwebcon^#/bookmarks (in UNIX)

#

When PFM - Web Console is run on a logical host in a cluster system, this directory is replaced with the environment directory. The environment directory is a directory created on the shared disk when setting up Performance Management in a logical host environment.

This subsection describes how to back up and restore the entire directory containing bookmark definition information.

This subsection assumes that the name of the host running PFM - Manager to which PFM - Web Console is connected is called hostA.

n In Windows:

Bookmark installation folder (default)

installation-folder\bookmarks\hostA\0

Backup procedure

To back up the bookmark information, copy the entire 0 folder to a different location.

Restoration procedure

To restore the bookmark information, copy the entire 0 folder into installation-folder\bookmarks\hostA.

n In UNIX:

Bookmarks installation directory

/opt/jp1pcwebcon/bookmarks/hostA/0

Backup procedure

To back up the bookmark information, copy the entire 0 directory to a different location.

Restoration procedure

To restore the bookmark information, copy the entire 0 directory into /opt/jp1pcwebcon/bookmarks/hostA.

(2) When you want to change the location of bookmark definition information to a different directory

First, change the setting for the location of the bookmark definition information to a different directory. Then, transfer the existing definition information to the new directory.

(a) Setting an installation folder for bookmark definition information

You can set a folder to store the bookmark definition information for the bookmark Repository in the Windows initialization file (config.xml).

The steps to set an installation folder for the bookmark definition information for the Windows initialization file (config.xml) are given below. For running on a logical host, use the same installation folder for both the executing node and the standby node.

To set an installation folder for the bookmark definition information for the Windows initialization file (config.xml):

1. Open the Windows initialization file (config.xml).
   The Windows initialization file (config.xml) is in the following location:
   installation-folder\conf\config.xml
   
2. Set the installation folder for the bookmark definition information.
   Set the installation folder for the <bookmark> tag immediate after the <format> tag in the <vsa> tag of the Windows initialization file (config.xml).
   The installation folder that has been specified will be automatically created when the PFM - Web Console service starts.
   
   When Running on a Non-Cluster System:
   For example, specify the following when you want the c:\common\bookmarks to be an installation folder:
   

    
   </format>
    
   <bookmark>
   <!-- The directory where bookmark repository is stored. Default : <install directory>\bookmarks -->
   <param name="bookmarkRepository" value="c:\common\bookmarks"/>
   </bookmark>
    
   </vsa>
    

   When Running on a Logical Host:
   Specify a folder on the shared disk as an installation folder for the bookmark definition information.
   For example, specify the following when you want the environment-directory\jp1pcWebCon\common\bookmarks to be an installation folder:
   

    
   </format>
    
   <bookmark>
   <!-- The directory where bookmark repository is stored. Default : <install directory>\bookmarks -->
   <param name="bookmarkRepository" value="environment-directory\jp1pcWebCon\common\bookmarks"/>
   </bookmark>
    
   </vsa>

   
   
3. Save the Windows initialization file (config.xml) edited in step 2.
4. Restart the PFM - Web Console service.
   The Windows initialization file (config.xml) is loaded when a PFM - Web Console service starts. Restart the PFM - Web Console service for the changed settings in the settings file to take effect. However, for the standby node, there is no need to restart it here because it is automatically restarted when a failback occurs.
   

Notes:

• If you change any areas other than those mentioned above in the initialization file (config.xml), PFM - Web Console might not operate correctly.
• If running the programs on a cluster system, restart the PFM - Web Console service from the cluster software.

(b) Making a new directory inherit bookmark definition information

This subsection describes how to inherit existing bookmark definition information for a new installation directory. This subsection assumes that the name of the host running PFM - Manager to which PFM - Web Console is connected is called hostB.

n In Windows:

This example assumes the following installation folders:

Old bookmark installation folder

installation-folder\bookmarks\hostB\0

New bookmark installation folder

C:\user1\bookmarks

To make a new folder inherit existing bookmarks:

1. Stop the PFM - Web Console service.
   For details on stopping services, see 1.3.2 Stopping monitoring console server services.
   
2. Back up the hostB subfolder found in the old bookmark installation folder.
   To back up the subfolder, copy it to a different location.
   
3. Change the bookmarks installation folder defined in the initialization file (config.xml) to a new bookmarks installation folder.
4. Create the new bookmark installation folder.
5. Copy the folder backed up in step 2 into the new bookmark installation folder.
   The hostB subfolder should now exist in the C:\user1\bookmarks folder.
   
6. Start the PFM - Web Console service.
   For details on starting services, see 1.2.2 Starting services on the monitoring console server.
   

n In UNIX:

This example assumes the following bookmark installation directories:

Old bookmark installation directory

/opt/jp1pcwebcon/bookmarks/hostB/0

New bookmark installation directory

/opt/user1/bookmarks

To make a new directory inherit existing bookmarks:

1. Stop the PFM - Web Console service.
   For details on stopping services, see 1.3.2 Stopping monitoring console server services.
   
2. Back up the hostB subdirectory found in the old bookmark installation directory.
   To back up the subdirectory, copy it to a different location.
   
3. Change the bookmarks installation directory defined in the initialization file (config.xml) to a new bookmarks installation directory.
4. Create the new bookmark installation directory.
5. Copy the directory backed up in step 2 into the new bookmark installation directory.
   The hostB subdirectory should now exist in the /opt/user1/bookmarks directory.
   
6. Start the PFM - Web Console service.
   For details on starting services, see 1.2.2 Starting services on the monitoring console server.
   

(3) When you want to change the PFM - Manager host connection, and inherit the bookmarks created before the change

If the PFM - Manager host connection is changed while using bookmarks, the bookmarks created before the change cannot be inherited. Recreate the bookmarks on the new PFM - Manager host.

(4) When you want to migrate PFM - Manager and PFM - Web Console to a cluster configuration, and inherit the bookmarks that existed before the migration

Contrary to case (3), where a new host connection is unable to inherit existing bookmarks, a logical host can inherit existing bookmarks when you switch over PFM - Manager and PFM - Web Console from physical host use to logical host use. This is because information from PFM - Agent and PFM - RM connected to PFM - Manager in the physical host environment is inherited by PFM - Manager running in the logical host environment.

n In Windows:

This example assumes the following conditions, including the host names:

When a physical host is used:

- PFM - Manager host name: hostE

- PFM - Manager host name for the connection destination of PFM - Web Console: hostE

- Bookmarks installation folder for PFM - Web Console:

installation-folder\jp1pcwebcon\bookmarks\0

When a logical host is used:

- PFM - Manager logical host name: lhostE

- PFM - Manager host name for the connection destination of PFM - Web Console: lhostE

- Bookmarks installation folder for PFM - Web Console:

environment-directory\jp1pcwebcon\bookmarks

To make a new folder inherit existing bookmarks:

1. Stop the PFM - Web Console service.^#
2. Back up the 0 subfolder found in the bookmark installation folder for physical host use.
   To back up the subfolder, copy it to a different location.
   
3. Change the bookmarks installation folder defined in the initialization file (config.xml) to a new bookmarks installation folder to be used when a logical host is operated.
4. Create a bookmarks installation folder to be used when a logical host is operated.
5. Create an lhostE folder under the bookmark installation folder for logical host use.
6. Copy the 0 subfolder backed up in step 2 into the new lhostE folder.
   The lhostE subfolder should now exist in the environment-directory\jp1pcwebcon\bookmarks\lhostE folder.
   
7. Start the PFM - Web Console service.^#
   

   #

   For details on stopping and starting services, see 9.6.1 Starting and stopping Performance Management in a cluster system.

n In UNIX:

This example assumes the following conditions, including the host names:

When a physical host is used:

- PFM - Manager host name: hostE

- PFM - Manager host name for the connection destination of PFM - Web Console: hostE

- Bookmarks installation directory for PFM - Web Console:

/opt/jp1pcwebcon/bookmarks/hostE/0

When a logical host is used:

- PFM - Manager logical host name: lhostE

- PFM - Manager host name for the connection destination of PFM - Web Console: lhostE

- Bookmarks installation directory for PFM - Web Console:

environment-directory/jp1pcwebcon/bookmarks

To make a new directory inherit existing bookmarks:

1. Stop the PFM - Web Console service.^#
2. Back up the 0 subdirectory found in the bookmark installation directory for physical host use.
   To back up the subdirectory, copy it to a different location.
   
3. Edit the initialization file (config.xml) so that the bookmark installation directory points to the bookmark installation directory for logical host use.
4. Create a bookmarks installation directory to be used when a logical host is operated.
5. Create an lhostE subdirectory under the bookmark installation directory for logical host use.
6. Copy the 0 subdirectory backed up in step 2 into the new lhostE directory.
   The 0 subdirectory should now exist in the environment-directory/jp1pcwebcon/bookmarks/lhostE directory.
   
7. Start the PFM - Web Console service.^#
   

   #

   For details on stopping and starting services, see 9.6.1 Starting and stopping Performance Management in a cluster system.

Note

• If the installation folder for the bookmark definition information is not changed from the default directory, the installation folder and the definition information file are deleted automatically at uninstallation. If the installation folder is changed, it is not deleted automatically. Delete it manually, if necessary.
• Bookmark definition information consists of multiple files. For this reason, when an error occurs during the creation, update, or deletion of the definition information file and the processing cannot continue, the integrity of the definition information file might be compromised. In such cases, modify or discard the corrupted information.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.