9.2.12 Backing up and restoring a bookmark definition
This subsection describes how to back up and restore bookmark definition information separately.
- Important
-
When backing up and restoring bookmark definition information separately, copy the directory manually to a location of your choice. Make sure that the PFM - Web Console service is stopped before you restore the information. 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.
The default location of the bookmark definition information and bookmark folders is as follows: By default, the bookmark definition information and bookmark directories are stored in the following location on the PFM - Web Console host:
-
In Windows:
installation-folder\bookmarks\
-
In UNIX:
/opt/jp1pcwebcon/bookmarks/
- Note:
-
If the storage directory for bookmark definition information has been changed from the default, the source and destination for backup and restoration operations is the directory specified in the bookmarkRepository parameter of the initialization file (config.xml).
- Organization of this subsection
(1) Backing up bookmark definition information
The following describes how to back up the directories containing bookmark definition information, in their entirety.
The following example assumes that bookmark definition information is stored in the default location, and that the PFM - Manager host to which PFM - Web Console connects is named hostA.
Bookmark storage folder:
-
In Windows:
installation-folder\bookmarks\hostA\0\
-
In UNIX:
/opt/jp1pcwebcon/bookmarks/hostA/0/
-
Stop the PFM - Web Console service.
For details on how to stop the service, see 1.3.2 Stopping services on the monitoring console server.
You can back up data associated with PFM - Web Console while the service is running. However, certain operations should not be performed while a backup is in progress. For details, see Table 9-12 Prohibited operations when backing up PFM - Web Console data with services running.
-
Back up the 0 directory in the bookmark storage directory.
Back up the folder by copying it to your chosen backup destination.
-
Start the PFM - Web Console service.
For details on how to start the service, see 1.2.2 Starting services on the monitoring console server.
(2) Restoring bookmark definition information
The following describes how to restore, in its entirety, a directory containing bookmark definition information. The following example assumes that bookmark definition information is stored in the default location, and that the PFM - Manager host to which PFM - Web Console connects is named hostA.
Bookmark storage directory:
-
In Windows:
installation-folder\bookmarks\hostA\0\
-
In UNIX:
/opt/jp1pcwebcon/bookmarks/hostA/0/
-
Stop the PFM - Web Console service.
For details on how to stop the service, see 1.3.2 Stopping services on the monitoring console server.
-
Copy the backed-up 0 directory to the bookmark storage directory.
-
Start the PFM - Web Console service.
For details on how to start the service, see 1.2.2 Starting services on the monitoring console server.
(3) Inheritance of bookmark definition information
- Note
-
You cannot change the PFM - Manager host for connection target and inherit the bookmarks created before the change while using bookmarks. Recreate the bookmarks on the new PFM - Manager host.
- Important
-
-
If you store bookmark definition information in the default location, the storage folder and the definition information it contains are deleted automatically at uninstallation. If you have changed the storage folder from the default, it is not deleted automatically. Delete it manually if necessary.
-
Bookmark definition information is stored in multiple files. For this reason, if an error occurs during the creation, update, or deletion of a definition information file and processing cannot continue, the integrity of the definition information files might be compromised. In such cases, modify or discard the corrupted information.
-
If a drill-down report is associated with a report registered in a bookmark, restore the report definition from the GUI.
If you use the jpcrdef create command to restore the report definition, you will be unable to display the drill-down report from the bookmark.
-
(a) Inheriting bookmarks after changing the folder in which bookmark definition information is stored (in Windows)
In this scenario, you need to change the storage folder first, and then bring the original definition information into the new folder. The following describes how to make the new folder inherit bookmark definition information. The description below assumes that the host parameter value in the initialization file (config.xml) of PFM - Web Console is hostB, and that the bookmark folders are as follows:
- Old bookmark storage folder
-
installation-folder\bookmarks\hostB\0\
- New bookmark storage folder
-
C:\user1\bookmarks\
-
Stop the PFM - Web Console service.
For details on how to stop the service, see 1.3.2 Stopping services on the monitoring console server.
-
Back up the hostB folder located in the old bookmark storage folder.
Back up the folder by copying it to a location of your choice.
-
Change the bookmark storage folder defined in the initialization file (config.xml) to the new folder.
For details on how to change the storage folder for bookmark definition information, see the chapter on installation and setup in the JP1/Performance Management Planning and Configuration Guide.
-
Create the new bookmark storage folder.
-
Copy the folder you backed up in step 2 to the folder you created in step 4.
The folder C:\user1\bookmarks now contains the folder hostB.
-
Start the PFM - Web Console service.
For details on how to start the service, see 1.2.2 Starting services on the monitoring console server.
(b) Inheriting bookmarks after migrating PFM - Manager and PFM - Web Console to a cluster configuration (in Windows)
Unlike a scenario in which you change the PFM - Manager host for connection destination, you can inherit the original bookmarks when you migrate PFM - Manager and PFM - Web Console from a non-cluster system to a cluster system. This is because PFM - Manager in a cluster system can inherit information about PFM - Agent and PFM - RM connected to PFM - Manager running in a non-cluster system. The description below assumes an environment with the following host names and other conditions:
- In the non-cluster system
-
- PFM - Manager host name: hostE
- Host name of PFM - Manager for connection destination for PFM - Web Console: hostE
- - Bookmark storage folder for PFM - Web Console:
-
installation-folder\jp1pcwebcon\bookmarks\hostE\0\
- In the cluster system
-
- PFM - Manager logical host name: lhostE
- Host name of PFM - Manager for connection destination for PFM - Web Console: lhostE
- - Bookmark storage folder for PFM - Web Console:
-
environment-directory\jp1pcwebcon\bookmarks\
-
Stop the PFM - Web Console service.#
-
Back up the 0 folder in the bookmark storage folder used in the non-cluster system.
You can back up the folder by copying it to a location of your choice.
-
Change the bookmark storage folder defined in the initialization file (config.xml) to the folder you will use in the cluster system.
For details on how to change the storage folder for bookmark definition information, see the chapter on installation and setup in the JP1/Performance Management Planning and Configuration Guide.
-
Create the bookmark storage folder for use in the cluster system.
-
Create the folder lhostE as a subfolder of the bookmark storage folder used in the cluster system.
-
Copy the folder you backed up in step 2 to the lhostE folder you created in step 5.
The folder environment-directory\jp1pcwebcon\bookmarks\lhostE now contains the folder 0.
-
Start the PFM - Web Console service.#
- #
-
For details on how to start and stop the service, see 10.6.1 Starting and stopping Performance Management in a cluster system.
(c) Inheriting bookmarks after changing the directory in which bookmark definition information is stored (in UNIX)
In this scenario, you need to change the storage directory first, and then bring the original definition information into the new directory. The following describes how to make the new directory inherit the original bookmark definition information. The description below assumes that the host parameter value in the initialization file (config.xml) of PFM - Web Console is hostB, and that the bookmark directories are as follows:
- Old bookmark storage directory
-
/opt/jp1pcwebcon/bookmarks/hostB/0/
- New bookmark storage directory
-
/opt/user1/bookmarks/
-
Stop the PFM - Web Console service.
For details on how to stop the service, see 1.3.2 Stopping services on the monitoring console server.
-
Back up the hostB directory located in the old bookmark storage directory.
Back up the directory by copying it to a location of your choice.
-
Change the bookmark storage directory defined in the initialization file (config.xml) to the new directory.
For details on how to change the storage directory for bookmark definition information, see the chapter on installation and setup in the JP1/Performance Management Planning and Configuration Guide.
-
Create the new bookmark storage directory.
-
Copy the directory you backed up in step 2 to the directory you created in step 4.
The directory /opt/user1/bookmarks now contains the directory hostB.
-
Start the PFM - Web Console service.
For details on how to start the service, see 1.2.2 Starting services on the monitoring console server.
(d) Inheriting bookmarks after migrating PFM - Manager and PFM - Web Console to a cluster configuration (in UNIX)
Unlike a scenario in which you change the PFM - Manager host for connection destination, you can inherit the original bookmarks when you migrate PFM - Manager and PFM - Web Console from a non-cluster system to a cluster system. This is because PFM - Manager in a cluster system can inherit information about PFM - Agent and PFM - RM connected to PFM - Manager running in a non-cluster system. The description below assumes an environment with the following host names and other conditions:
- In the non-cluster system
-
- PFM - Manager host name: hostE
- Host name of PFM - Manager for connection destination for PFM - Web Console: hostE
- - Bookmark storage directory for PFM - Web Console:
-
/opt/jp1pcwebcon/bookmarks/hostE/0/
- In the cluster system
-
- PFM - Manager logical host name: lhostE
- Host name of PFM - Manager for connection destination for PFM - Web Console: lhostE
- - Bookmark storage directory for PFM - Web Console:
-
environment-directory/jp1pcwebcon/bookmarks/
-
Stop the PFM - Web Console service.#
-
Back up the 0 directory in the bookmark storage directory used in the non-cluster system.
You can back up the directory by copying it to a location of your choice.
-
Change the bookmark storage directory defined in the initialization file (config.xml) to the directory you will use in the cluster system.
For details on how to change the storage directory for bookmark definition information, see the chapter on installation and setup in the JP1/Performance Management Planning and Configuration Guide.
-
Create the bookmark storage directory for use in the cluster system.
-
Create the directory lhostE as a subdirectory of the bookmark storage directory used in the cluster system.
-
Copy the directory you backed up in step 2 to the lhostE directory you created.
The directory environment-directory/jp1pcwebcon/bookmarks/lhostE now contains the directory 0.
-
Start the PFM - Web Console service.#
- #
-
For details on how to start and stop the service, see 10.6.1 Starting and stopping Performance Management in a cluster system.