4.2 Manager

This section explains the upgrading of managers.

When operating managers in clusters, transfer using upgrade installation cannot be performed. Perform the upgrade manually.

Transferred Data

The following manager data is transferred:

Resource Coordinator VE setting information (Setting information for the environment of the earlier version)
Certificates
System images and cloning images (Files in the image file storage folder)

Also, with transfer using upgrade installation the following data is also transferred:

Port number settings
Power consumption data
Batch files and script files for event-related functions

Data which is transferred during upgrade installation is backed up in the following folder. Ensure that the folder is not deleted until after the upgrade is complete.

[Windows]
Drive_name\Program Files\RCVE-upgradedata

[Linux]
/var/opt/RCVE-upgradedata
/var/opt/backupscwdir

Preparations

Perform the following preparations and checks before upgrading:

Check that the environment is one in which managers of this version can be operated.
For operating environments, refer to "Chapter 1 Operational Environment".
To enable recovery in case there is unexpected trouble during the upgrade process, please back up the admin server. For how to back up the admin server, refer to the "Systemwalker Resource Coordinator Virtual server Edition Operation Guide" or an earlier version of the "Appendix B Admin Server Backup and Restore" of the "ServerView Resource Coordinator VE Operation Guide".
As well as backing up the admin server, also back up (copy) the following information:
- Port number settings
  [Windows]
  Drive_name\WINDOWS\system32\drivers\etc\services
  [Linux]
  /etc/services
- Batch files and script files for event-related functions
  [Windows]
  Installation_folder\Manager\etc\trapop.bat
  [Linux]
  /etc/opt/FJSVrcvmr/trapop.sh

When manually performing upgrade from V13.2 or V13.3, or when operating clustered managers, perform the following preparations and checks.

To confirm that the upgrade is complete, if there are registered VM hosts on which there are VM guests, check from the RC console or earlier versions of the Resource Coordinator console that all of the VM guests are displayed and record their information.
When server switchover settings have been performed, it is not possible to upgrade when spare servers have been switched to. Restore any such servers before starting the upgrade. For how to restore, refer to the information about Server Switchover in the "Systemwalker Resource Coordinator Virtual server Edition Operation Guide" or the "ServerView Resource Coordinator VE Operation Guide" of the earlier version.
The following information is not transferred. It will need to be set again after the upgrade. Record the following information from the Resource Coordinator console of the earlier version or the RC console.
- User account information
- The registration status of the agent of each managed server and maintenance mode settings
- Spare server settings (when VM hosts have been set as spare servers)
The following assets are not transferred.
- Power consumption data
  When using power monitoring with V13.3 or later versions, collected power consumption data is not transferred. If the power consumption data is necessary, save it in CSV format. For how to export it, refer to "11.2 Exporting Power Consumption Data" of the "Systemwalker Resource Coordinator Virtual server Edition Operation Guide" or the relevant section in the "ServerView Resource Coordinator VE Operation Guide" of the earlier version.

Upgrade using Upgrade Installation

When upgrading to this version from V2.1.1, upgrade can be performed using upgrade installation. Perform the upgrade using the following procedure:

Note

Do not change the hardware settings or configurations of managers, agents, or any other devices until upgrading is completed.
When performing an upgrade installation, please do not access the installation folder of the earlier version or any of the files and folders inside it using the command prompt, Explorer, or an editor.
While it is being accessed, attempts to perform upgrade installation will fail.
If upgrade installation fails, stop accessing the files or folders and then perform the upgrade installation again.
In the event that upgrade installation fails, please resolve the cause of the failure and perform upgrade installation again. If the problem cannot be resolved and upgrade installation fails again, please contact Fujitsu technical staff.
When stopping the upgrade and restoring the earlier version, please do so by restoring the information that was backed up during the preparations.
When performing restoration and a manager of this version or an earlier version has been installed, please uninstall it.
After restoration, please delete the folder containing the backed up assets. For the restoration method (restore), refer to the "ServerView Resource Coordinator VE Operation Guide" of the earlier version.
Upgrade installation will delete patches that were applied to the earlier version.
[Linux]
When the PATH variable has not been configured to enable execution of UpdateAdvisor (Middleware) commands from a user-defined location, performing uninstallation will delete any patches that have been applied to the earlier version of Resource Coordinator VE, but it will not delete product information or component information. Refer to the UpdateAdvisor (Middleware) manual, delete software and component information from the applied modification check list.
When operating managers in clusters, transfer using upgrade installation cannot be performed. Perform the upgrade manually.

Upgrade Installation
[Windows]
Refer to "2.1.2 Installation [Windows]", and execute the Resource Coordinator VE installer.
The Resource Coordinator VE setup window will be displayed. Check the contents of the license agreement, etc. and then click <Yes>.
The setting information that will be taken over from the earlier version will be displayed. Please check it and then click <Install>. Upgrade installation will begin.
[Linux]
Refer to "2.1.3 Installation [Linux]", and execute the Resource Coordinator VE installer.
Check the contents of the license agreement, etc. and then enter "y".
The setting information that will be taken over from the earlier version will be displayed. Please check it and then enter "y". Upgrade installation will begin.
Restarting after Upgrade Installation is Finished [Windows]
After upgrade installation is finished, restart the system in order to complete the upgrade.

Note

When using backup system images or collecting cloning images without upgrading agents, either reboot managed servers after the manager upgrade is completed or restart the "Deployment service".
For restarting managed servers and the "Deployment service", refer to "5.2 Agent" of the "Systemwalker Resource Coordinator Virtual server Edition Setup Guide" or "5.2 Agent" of the "ServerView Resource Coordinator VE Setup Guide" of the earlier version.

Manual Upgrade

Upgrading to this version from V13.2, V13.3, or earlier versions of managers in clustered operation is performed by exporting and importing system configuration files for pre-configuration. Perform the upgrade using the following procedure:

See

For pre-configuration, refer to the following manuals:

"Systemwalker Resource Coordinator Virtual server Edition Setup Guide"
- "Chapter 7 Pre-configuration"
- "Appendix D Format of CSV System Configuration Files"
"ServerView Resource Coordinator VE Setup Guide"
- "Chapter 7 Pre-configuration"
- "Appendix D Format of CSV System Configuration Files"

Note

When upgrading from V13.2, do not uninstall V13.2 clients until step 2. has been completed.
Do not change the hardware settings or configurations of managers, agents, or any other devices until upgrading is completed.
When upgrading from manager operating in clusters, replace the parts referring to "Systemwalker Resource Coordinator Virtual server Edition manuals" with the earlier versions of "ServerView Resource Coordinator VE manuals" for the following procedure.

Set Maintenance Mode
Use the Resource Coordinator console of the earlier version or the RC console to place all managed servers into maintenance mode.
System Configuration File Export
Use the pre-configuration function of the earlier version and export the system configuration file in CSV format. During the export, do not perform any other operations with Resource Coordinator VE.
For the export method, refer to the "Systemwalker Resource Coordinator Virtual server Edition Setup Guide".
Back up (copy) Assets to Transfer
1. Perform backup (copying) of the certificates of the earlier version.
  Back up (copy) the following folders and directories:
  [Windows]
  - For V13.2 and V13.3
    Installation_folder\Site Manager\etc\opt\FJSVssmgr\current\certificate
    Installation_folder\Domain Manager\etc\opt\FJSVrcxdm\certificate
    Installation_folder\Manager\sys\apache\conf\ssl.crt
    Installation_folder\Manager\sys\apache\conf\ssl.key
  - For V2.1.0 or later
    Installation_folder\Manager\etc\opt\FJSVssmgr\current\certificate
    Installation_folder\Manager\etc\opt\FJSVrcxdm\certificate
    Installation_folder\Manager\sys\apache\conf\ssl.crt
    Installation_folder\Manager\sys\apache\conf\ssl.key
  [Linux]
  /etc/opt/FJSVrcvmr/opt/FJSVssmgr/current/certificate
  /etc/opt/FJSVrcvmr/sys/apache/conf/ssl.crt
  /etc/opt/FJSVrcvmr/sys/apache/conf/ssl.key
2. Back up (copy) the folder containing the system images and cloning images of the earlier version to a location other than the installation folder and image file storage folder.
  When using the default image file storage folder, back up (copy) the following folder or directory:
  [Windows]
  Installation_folder\ScwPro\depot\Cloneimg
  [Linux]
  /var/opt/FJSVscw-deploysv/depot/CLONEIMG
  When using a folder or directory other than the default, back up (copy) the "Cloneimg" folder or "CLONEIMG" directory used.
Note
- When operating managers in clusters, the above folders or directories are stored on the shared disk. Check if files, folders, or directories stored in the above locations are correctly backed up (copied).
  The backup (copy) storage target can be set to be stored in a folder or directory on the shared disk other than "RCoordinator" which is created during setup of the manager cluster service.
- When operating managers in clusters, the back up (copy) of folders or directories should be executed on the primary node.
- Before making a backup (copy) of system images and cloning images, check the available disk space. For the disk space necessary for system images and cloning images, refer to the "Systemwalker Resource Coordinator Virtual server Edition Installation Guide". When there is no storage folder for system images and cloning images, this step is not necessary.
Uninstallation of earlier version managers
Refer to the "Systemwalker Resource Coordinator Virtual server Edition Installation Guide" for the method for uninstalling the manager of the earlier version.
When operating managers in clusters, refer to "B.4 Releasing Configuration" in the "ServerView Resource Coordinator VE Installation Guide" of the earlier version, and uninstall the cluster services and the manager of the earlier versions.
Note
- Do not perform "Delete servers" as described in Preparations of the "Systemwalker Resource Coordinator Virtual server Edition Installation Guide". When managed servers using HBA address rename have been deleted, it is necessary to reboot managed servers after upgrading of the manager is completed.
- User account information is deleted when managers are uninstalled. Refer to step 6. and perform reconfiguration from the RC console.
- In environments where there are V13.2 managers and clients, uninstall V13.2 clients only after uninstalling the manager of the earlier version.
Installation of Managers of This Version
Install managers of this version.
For installation, refer to "2.1 Manager Installation".
When operating managers in cluster environments, refer to "Appendix B Manager Cluster Operation Settings and Deletion", uninstall the manager and then configure the cluster services.
Note
When installing managers, specify the same admin LAN as used for the earlier version on the [Admin LAN Selection] window.
After installing managers, use the following procedure to restore the certificates and image file storage folder backed up (copied) in step 3.
1. Stop the manager.
2. Return the image file storage folder backup (copy) to the folder specified during installation.
  When using the default image file storage folder, restore to the following folder or directory:
  [Windows]
  Installation_folder\ScwPro\depot\Cloneimg
  [Linux]
  /var/opt/FJSVscw-deploysv/depot/CLONEIMG
  When using a folder other than the default, restore to the new folder.
  When the image file storage folder was not backed up, this step is not necessary.
3. Restore the backed up (copied) certificates to the manager installation_folder.
  Restore to the following folder or directory:
  [Windows]
  Installation_folder\Manager\etc\opt\FJSVssmgr\current\certificate
  Installation_folder\Manager\etc\opt\FJSVrcxdm\certificate
  Installation_folder\Manager\sys\apache\conf\ssl.crt
  Installation_folder\Manager\sys\apache\conf\ssl.key
  [Linux]
  /etc/opt/FJSVrcvmr/opt/FJSVssmgr/current/certificate
  /etc/opt/FJSVrcvmr/sys/apache/conf/ssl.crt
  /etc/opt/FJSVrcvmr/sys/apache/conf/ssl.key
4. Restore the information that was backed up during preparations.
  - Port number settings
    Change the port numbers based on the information that was backed up during preparations.
    For details of how to change port numbers, refer to "6.3.1.2 Changing Port Numbers" of the "ServerView Resource Coordinator VE Setup Guide".
    When the port number has not been changed from the default, this step is not necessary.
  - Batch files and script files for event-related functions
    Restore them by replacing the following file.
    [Windows]
    Installation_folder\Manager\etc\trapop.bat
    [Linux]
    /etc/opt/FJSVrcvmr/trapop.sh
5. Start the manager.
  For the methods for starting and stopping managers, refer to "5.1 Manager" of the "ServerView Resource Coordinator VE Setup Guide".
Note
Take caution regarding the following when operating managers in clusters.
- Restoring the image file storage folder and certificates should be performed on shared disks are mounted on the primary node.
- Restoration of batch files and script files for event-related functions should be performed on both nodes.
Apply Attached Patches
Apply the patches provided on the Resource Coordinator VE CD-ROM.
For the patch application method, refer to the correction information file (README).
User Account Settings
Using the information recorded during preparations, perform setting of user accounts using the RC console.
For details, refer to "Chapter 4 User Accounts" of the "ServerView Resource Coordinator VE Operation Guide".
Edit System Configuration Files
Based on the environment created for the earlier version, edit the system configuration file (CSV format) exported in step 2.
Change the operation column of all resources to "new".
When upgrading from V13.3 or later, do not change the operation column of resources contained in the following sections to "new":
- ServerAgent
- ServerVMHost
- Memo
For how to edit system configuration files (CVS format), refer to the "Systemwalker Resource Coordinator Virtual server Edition Setup Guide".
Note
When VM hosts have been configured as spare servers, set hyphens ("-") for all parameters ("Spare Server Name", "VLAN Switchover", and "Automatic Switch") of the "Server Switchover Settings" of "(3) Server Blade Information".
Creating an Environment of This Version
Import the system configuration file and create an environment of this version.
Use the following procedure to configure an environment of this version.
1. System Configuration File Import
  Import the edited system configuration file.
  For the import method, refer to "7.2 Importing the System Configuration File" of the "ServerView Resource Coordinator VE Setup Guide".
2. Agent Registration
  Using the information recorded during preparations, perform agent registration using the RC console. Perform agent registration with the OS of the managed server booted.
  For agent registration, refer to "6.2.3 Software Installation and Agent Registration" of the "ServerView Resource Coordinator VE Setup Guide".
  After completing agent registration, use the RC console to check that all physical OS's and VM hosts are displayed. When there are VM hosts (with VM guests) registered, check that all VM guests are displayed.
3. Setting spare server information (only when VM hosts have been set as spare servers)
  Using the information recorded during preparations, perform registration of spare server information using the RC console.
  For registration of spare server information, refer to "9.6 Server Switchover Settings" of the "ServerView Resource Coordinator VE Setup Guide".
4. Registration of labels, comments, and contact information
  This procedure is not necessary when upgrading from V13.2.
  When label, comment, and contact information has been registered, change the contents of the operation column of the system configuration file (CSV format) that were changed to "new" in step 7. back to hyphens ("-"), and change the contents of the operation column of resources contained in the [Memo] section to "new".
  For how to edit system configuration files (CVS format), refer to the "Systemwalker Resource Coordinator Virtual server Edition Setup Guide".
  Import the edited system configuration file.
  For the import method, refer to "7.2 Importing the System Configuration File" of the "ServerView Resource Coordinator VE Setup Guide".
Set Maintenance Mode
Using the information recorded during preparation, place the managed servers placed into maintenance mode into maintenance mode again.
For maintenance mode settings, refer to "Appendix F Maintenance Mode" of the "ServerView Resource Coordinator VE Setup Guide".

Note

When using backup system images or collecting cloning images without upgrading agents, either reboot managed servers after the manager upgrade is completed or restart the "Deployment service".

For restarting the "Deployment service", refer to "5.2 Agent" of the "Systemwalker Resource Coordinator Virtual server Edition Setup Guide".