This section explains installation of Linux managers.
This section explains the preparations and checks required before commencing installation.
Software preparation and checks are explained in the following sections.
This section explains the preparations and checks required before commencing the installation of Resource Orchestrator.
Host Name Checks
It is necessary to set the host name (FQDN) for the admin server to operate normally. Describe the host name in the hosts file, using 256 characters or less. In the hosts file, for the IP address of the admin server, configure the host name (FQDN) and then the computer name.
hosts File
/etc/hosts
Note
When configuring the hosts file, note the following.
Do not set the host name (FQDN) and the computer name to "127.0.0.1".
Example
When configuring the admin server with the IP address "10.10.10.10", the host name (FQDN) "remote1.example.com", and the computer name "remote1"
10.10.10.10 remote1.example.com remote1 127.0.0.1 localhost.localdomain localhost
For the admin client, either configure the hosts file so access to the admin server is possible using the host name (FQDN), or name resolution using a DNS server.
System Time Checks
Set the same system time for the admin server and managed servers.
Exclusive Software Checks
Uninstall exclusive software before installing Resource Orchestrator.
For details of exclusive software, refer to "6.1.1.5 Exclusive Software" in "Overview".
Note
When uninstalling exclusive software, there are cases where other system operation administrators might have installed the software, so check that deleting the software causes no problems before actually doing so.
Required Software Preparation and Checks
Before installing Resource Orchestrator, perform the following operations.
In addition, check that the required software, such as ServerView Operations Manager, given in "6.1.1.4 Required Software" in the "Overview" has been installed. If it has not been installed, install it before continuing.
When operating managers in cluster environments, refer to "Appendix C Manager Cluster Operation Settings and Deletion" and "C.2.1 Preparations", and perform preparations and checks in advance.
In order to open the console screen of the managed server, register the account of the Remote Management Controller with the ServerView Operations Manager.
For the setting method, refer to the ServerView Operations Manager manual.
In order for Resource Orchestrator to operate correctly to operate correctly, ensure that the following settings are made for the "/etc/snmp/snmptrapd.conf" file, when installing the net-snmp package. When there is no file, add the following setting after creating the file.
disableAuthorization yes |
It is also necessary to enable the automatic startup setting for the snmptrapd daemon.
When using ESC, configure the Fibre Channel switch settings in advance.
When both of the following apply, it is necessary to install a DHCP server on a Windows server other than the admin server.
I/O virtualization using ISM is used
PXE boot is used in ISM
After installing the manager, perform "6.2 Settings for ISM Coordination".
When managing managed servers that belong to different subnets from the admin server, it is necessary to perform the following:
DHCP server installation
Install a DHCP server.
When it is necessary to perform configuration for ISM coordination and both of the following apply, it is necessary to install the DHCP server on a Windows server other than the admin server.
I/O virtualization using ISM is used
PXE boot is used in ISM
After installing the manager, perform "6.2 Settings for ISM Coordination".
In all other cases, it is necessary to install a standard Linux DHCP server on the admin server.
Install the DHCP server following the procedure below:
Install the dhcp package.
Execute the following command to modify the setting so the DHCP server service (dhcpd) is not automatically started.
# chkconfig dhcpd off <RETURN> |
Execute the following command to stop the DHCP server service (dhcpd):
# /etc/init.d/dhcpd stop <RETURN> |
Router configuration
Depending on the functions used, it may be necessary to configure the router settings.
For details, refer to "9.2.4.2 Admin LAN Settings" in the "Design Guide CE".
Registration of admin LAN subnets
It is necessary to register admin LAN subnets in advance.
For details, refer to "5.11 Registering Admin LAN Subnets" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
Required Patch Checks
Before installing Resource Orchestrator, check that the required patches for the manager listed in "6.1.1.2 Required Patches" in the "Overview" have been applied.
If they have not been applied, apply them before continuing.
Required Package Checks
Before installing Resource Orchestrator, check that the required packages for the manager [Linux manager] listed in "6.1.1.3 Required Packages" in the "Overview" have been applied.
If they have not been installed, install them before continuing.
User Account Checks
This product automatically creates the user accounts listed below - if an application is using these OS user accounts, ensure there is no impact on the application before deleting them:
rcxdb (for connecting to the database)
Single Sign-On Preparation and Checks (when used)
To use Single Sign-On (SSO) coordination, before installing Resource Orchestrator, certificate preparation and user registration of an administrator (privileged user) with the directory service are required.
For details, refer to "Chapter 10 Configuring Single Sign-On" in the "Design Guide VE".
Tuning System Parameters (Admin Server)
Before installation, it is necessary to tune up system parameters for the admin server. See the table below for the system parameters that need to be tuned and their values.
Point
Set the values according to the "type" of each parameter as follows:
When the type is "setup value"
Modification is not necessary if already set value (default or previous value) is equal to or larger than the value in the table. If it is smaller than the value in the table, change the value to the one in the table.
When the type is "additional value"
Add the value in the table to already set value. Before adding the value, check the upper limit for the system, and set either the resulting value or the upper limit for the system, whichever is smaller.
For details, refer to the Linux manual.
Shared Memory
Parameter | Description | Value | Type |
|---|---|---|---|
shmmax | Maximum Segment Size of Shared Memory | 55155880 | Setup value |
shmall | Total amount of shared memory available for use | 13466 | Setup value |
shmmni | Maximum number of shared memory segments | 1 | Additional value |
Semaphores
To configure semaphores, specify the value for each parameter in the following format:
kernel.sem = para1 para2 para3 para4
Parameter | Description | Value | Type |
|---|---|---|---|
para1 | Maximum number of semaphores for each semaphore identifier | 17 | Setup value |
para2 | Total number of semaphores in the system | 1071 | Additional value |
para3 | Maximum number of operators for each semaphore call | 32 | Setup value |
para4 | Total number of semaphore operators in the system | 63 | Additional value |
[Tuning Procedure]
Use the following procedure to perform tuning:
Use the following command to check the values of the corresponding parameters currently configured for the system.
# /sbin/sysctl -a
Example
# /sbin/sysctl -a ... (omitted) ... kernel.sem = 250 32000 32 128 kernel.msgmnb = 65536 kernel.msgmni = 16 kernel.msgmax = 65536 kernel.shmmni = 4096 kernel.shmall = 4294967296 kernel.shmmax = 68719476736 ... (omitted) ...
For each parameter, compare the current value to that in the above table, and then calculate the appropriate value, based on its value type (setup or additional value).
Edit /etc/sysctl.conf. Edit the content as in the following example:
Example
kernel.sem = 250 33071 32 191 kernel.shmmni = 4097
Confirm that edited content is reflected in /etc/sysctl.conf, using the following command:
# /bin/cat /etc/sysctl.conf
Enable the configuration on 4. using one of the following methods:
Reboot the system to reflect the settings
# /sbin/shutdown -r now
Use /sbin/sysctl -p to reflect the settings
# /sbin/sysctl -p /etc/sysctl.conf (*)
*: When using this command, reboot is not necessary.
Confirm that configured parameters are reflected, using the following command:
# /sbin/sysctl -a
Example
# /sbin/sysctl -a ... (omitted) ... kernel.sem = 250 33071 32 191 kernel.msgmnb = 65536 kernel.msgmni = 16 kernel.msgmax = 65536 kernel.shmmni = 4097 kernel.shmall = 4294967296 kernel.shmmax = 68719476736 ... (omitted) ...
Before installing Resource Orchestrator, collect required information and check the system status, then determine the information to be specified on the installation window. The information that needs to be prepared is given below.
Installation Folder
The installation directory of Resource Orchestrator is as below. It cannot be changed.
/opt
/etc/opt
/var/opt
Check that the necessary disk space can be secured on the drive for installation.
For the amount of disk space necessary for Resource Orchestrator, refer to "6.1.1.6 Static Disk Space" and "6.1.1.7 Dynamic Disk Space" in the "Overview".
Image File Storage Folder
The image file storage folder is located in the installation folder.
Check that sufficient disk space can be secured on the drive where the storage folder will be created.
For the necessary disk space, refer to "6.1.1.7 Dynamic Disk Space" in the "Overview".
For details of how to change the image file storage folder, refer to "5.8 rcxadm imagemgr" in the "Reference Guide (Command) VE".
Port number
For details on port numbers, refer to "2.1.2.4 Checking Used Port Numbers".
Directory Service Connection Information for Single Sign-On of ServerView Operations Manager
Confirm that the directory service used for Single Sign-On of ServerView Operations Manager is correctly configured.
This can be performed using either of the following procedures:
Log in to ServerView Operations Manager.
Refer to the following manuals:
Manual for ServerView Operations Manager:
"ServerView user management via an LDAP directory service" in "FUJITSU ServerView Suite User Management in ServerView"
Manual for ServerView Operations Manager:
"Starting ServerView Operations Manager" in "FUJITSU Software ServerView Suite ServerView Operations Manager" (User's guide)
Perform modification installation of ServerView Operations Manager.
When performing modification installation, the settings of directory service can be checked.
Refer to the following manuals:
Manual for ServerView Operations Manager:
"ServerView user management via an LDAP directory service" in "FUJITSU ServerView Suite User Management in ServerView"
Manual for ServerView Operations Manager:
"Installing the Operations Manager software" in "FUJITSU Software ServerView Suite ServerView Operations Manager Installation ServerView Operations Manager Software under Linux"
If the settings of the directory service for ServerView Operations Manager are correct, exit the modification installation without making any changes.
If there are errors in the settings of the directory service for ServerView Operations, perform modification installation of ServerView Operations Manager to correct the errors.
Parameters Used for Installation
The following table contains the parameters used for installation.
No. | Window | Entry | Description |
|---|---|---|---|
1 | Admin LAN Selection | Network to use for the admin LAN | This is the network to be used as the admin LAN. Select it from the list. |
2 | Authentication Method Selection | Authentication Method | Select one of the following options.
|
3 | Administrative User Creation | User Account | This is the user account name to be used for logging into Resource Orchestrator as an administrative user. The name must start with an alphabetic character and can be up to 16 alphanumeric characters long, including underscores ("_"), hyphens ("-"), and periods ("."). Input is case-sensitive. |
Password | The password of the administrative user. The string must be composed of alphanumeric characters and symbols (excluding blank spaces), and can be up to 16 characters long. | ||
Retype password | |||
Administrative User Settings | User Account | This is the user account name to be used for logging into Resource Orchestrator as an administrative user. Specify the user registered in the directory service in "Single Sign-On Preparation and Checks (when used)" in "2.1.2.2 Software Preparation and Checks". When using the directory service provided with ServerView Operations Manager, specifying "administrator", which is the administrator account of ServerView Operations Manager, enables Single Sign-On coordination with ServerView Operations Manager. The name must start with an alphabetic character and can be up to 16 alphanumeric characters long, including underscores ("_"), hyphens ("-"), and periods ("."). Input is case-sensitive. |
Ports Automatically Set in the services File of the System
When Resource Orchestrator is installed, the port numbers used by it will automatically be set in the services file of the system.
If the port numbers used by Resource Orchestrator are being used for other applications, a message indicating that the numbers are in use is displayed when the installer is started, and installation will stop.
In that case, describe the entries for the following port numbers used by Resource Orchestrator in the services file using numbers not used by other software, and then start the installer.
# service name port number/protocol name nfdomain 23455/tcp nfagent 23458/tcp rcxmgr 23460/tcp rcxweb 23461/tcp rcxtask 23462/tcp rcxmongrel1 23463/tcp rcxmongrel2 23464/tcp rcxdb 23465/tcp
Checking Port Usage Status
Execute the "Environment setup conditions check tool" in "2.1.2.5 Configuration Parameter Checks" to check the port usage status.
For ports with "is in use" displayed for the result of "Port status", confirm that those ports are used with the purpose of usage for Resource Orchestrator defined in /etc/services.
When ports are being used for something other than Resource Orchestrator, change the ports to use.
For the port information used by Resource Orchestrator, refer to "Appendix A Port List" in the "Design Guide VE".
Changing Port Numbers
To change port numbers after installing the manager, refer to the following:
"8.2 Changing Port Numbers" in the "User's Guide VE"
Check configuration parameters following the procedure below:
Log in to the system as the OS administrator (root).
Boot the admin server in multi-user mode to check that the server meets requirements for installation, and then log in to the system using root.
Set the first Resource Orchestrator DVD-ROM.
Execute the following command to mount the DVD-ROM. If the auto-mounting daemon (autofs) is used for starting the mounted DVD-ROM, the installer will fail to start due to its "noexec" mount option.
# mount -t iso9660 -r /dev/hdc DVD-ROM_mount_point <RETURN>
Execute the following installation command:
# DVD-ROM_mount_point/RcSetup.sh <RETURN>
Select "Environment setup conditions check tool" from the menu to execute the tool.
For the check items with the edition name displayed in the check results, check only the items corresponding to the edition to be installed.
When the check is completed, the result will be sent to standard output.
The following items are displayed as the items to be checked:
Required Software (ETERNUS SF Storage Cruiser)
Disk Space (Express/Virtual Edition)
Disk Space (Cloud Edition)
Memory Size (Express/Virtual Edition)
Memory Size (Cloud Edition)
cpu
SNMP Service
Port Status (Express/Virtual Edition)
Port Status (Cloud Edition)
Confirm that "Warning" or "NG" is not included in the check results. If there are check items that were determined as "Warning" or "NG", resolve the cause of the problem based on the output message. For details of the corrective actions, refer to "2.1.2.1 Preparations" and "6.1 Software Environment" and "6.2 Hardware Environment" in the "Overview".
The procedure for manager installation is given below.
Before installation, check if "2.1.2.1 Preparations" have been performed.
Settings in Single User Mode
In single user mode, X Window System does not start, and one of the following operations is required.
Switching virtual consoles (using the [Ctrl] + [Alt] + [Fn] keys)
Making commands run in the background
Nullifying Firewall Settings for Ports to be used by Resource Orchestrator
When installing Resource Orchestrator on systems with active firewalls, in order to enable correct communication between the manager, agents, and clients, disable the firewall settings for the port numbers to be used for communication.
For the port numbers used by Resource Orchestrator and required software, refer to "Appendix A Port List" in the "Design Guide VE".
However, when port numbers have been changed by editing the services file during installation of Resource Orchestrator, replace the default port numbers listed in "Appendix A Port List" in the "Design Guide VE" with the port numbers changed to during installation.
Installation
The procedure for manager installation is given below.
Log in to the system as the OS administrator (root).
Boot the admin server that the manager is to be installed on in multi-user mode, and then log in to the system using root.
Set the first Resource Orchestrator DVD-ROM.
Execute the following command to mount the DVD-ROM.
# mount -t iso9660 -r /dev/hdc DVD-ROM_mount_point <RETURN>
Note
If the auto-mounting daemon (autofs) is used for DVD-ROM auto-mounting, the installer fails to start due to its "noexec" mount option.
Execute the following installation command:
# cd DVD-ROM_mount_point <RETURN> # ./RcSetup.sh <RETURN>
Select "Virtual Edition".
Select "Manager installation".
Perform installation according to the installer's interactive instructions.
Enter the parameters designed and checked in "Parameters Used for Installation" in "2.1.2.3 Collecting and Checking Required Information".
Settings when SELinux is Used
When enabling SELinux, it is necessary to perform configuration of SELinux after installing Resource Orchestrator.
For details on configuration, refer to "H.1.1 Manager".
Note
Corrective Action for Installation Failure
In the event of installation failure, restart the OS and then log in as the user that performed the installation, and perform uninstallation following the uninstallation procedure.
After that, remove the cause of the failure referring to the meaning of the output message and the suggested corrective actions, and then perform installation again.
If there are internal inconsistencies detected during installation, the messages "The problem occurred while installing it" or "It failed in the installation" will be displayed and installation will fail. In this case, uninstall the manager and reinstall it. If the problem persists, please contact Fujitsu technical staff.
Uninstall the Related Services
When locating ServerView Deployment Manager in the same subnet, it is necessary to uninstall the related services.
For the method for uninstalling the related services, please refer to "5.1 deployment_service_uninstall" in the "Reference Guide (Command) VE".
Post-installation Cautions
The following users are added. When installing Resource Orchestrator, do not delete these accounts.
Account Name | Usage |
|---|---|
rcxdb | rcxdb is used as the OS account for connecting to the database service of Resource Orchestrator. |
The user group below is added.
User Group Name | Usage |
|---|---|
Deployment Admin | This user group is used to perform backup, restoration, and cloning for Resource Orchestrator. |
rcxdb | rcxdb is used as a user group for connecting to the database service of Resource Orchestrator. |
