Installing UltraVR Using a Software Package

This operation installs the UltraVR using the software package. This chapter takes installing the UltraVR on the CLI.

Prerequisites

A qualified VM or physical server is ready and the required operating system has been installed on it. For details about the requirements, see Product Specifications.
The software packages, reference documentation, and tools required by the UltraVR have been obtained. For details about how to obtain them, see Obtaining Installation Packages and Documentation.
The signature file and digital signature public key have been obtained and the software integrity has been verified.
1. On the page for downloading the UltraVR software package, you can download the .asc digital signature file whose name is the same as that of the software package.
2. You have used the digital signature public key and verification tool provided by the website to verify the digital signature of the software package. You can obtain the digital signature public key, verification tool, and their usage methods from:
  - Enterprise
    Software Digital Signature (OpenPGP) Verification Tool
  - Carrier
    Digital Signature Verification Method
The administrator password for the operating system running on the VM or physical server where UltraVR is to be installed has been obtained.
The system time stability of the server is important for the UltraVR. Do not change the system time during the operation of the UltraVR. If system time-hopping occurs, you need to restart the UltraVR. For details about how to restart the UltraVR, see Starting the UltraVR.

Context

To ensure normal operation of the remote DR function, ensure that the same UltraVR is installed at the production and DR centers.

This section uses UltraVR V100R003C10SPC900_for_Euler_X86.tar.gz as an example. Version numbers in the preceding software packages vary with site conditions.

The CLI mode uses command lines to instruct user operations.

Procedure

Check whether the firewall is enabled.
- If no, ensure whether the firewall is required.
- If yes, see UltraVR V100R003C10SPC900 Communication Matrix to open firewall ports on the server where the UltraVR is to be installed. For details about how to open the firewall ports, see Configuring the Firewall.
Log in as user root to the server where the UltraVR is to be installed.
Copy the UltraVR installation package to the server where the UltraVR is to be installed.
- The name of the directory where the UltraVR installation package resides can contain only letters, digits, underscores (_), hyphens (-), periods (.), and one space.
- After the software package is uploaded to the operating system, you must create a temporary directory in the system and decompress the installation package to the temporary directory.
Go to the directory where the UltraVR V100R003C10SPC900_for_Euler_X86.tar.gz installation package resides.
Run the tar -zxvf "UltraVR V100R003C10SPC900_for_Euler_X86.tar.gz" command to decompress the installation package.
Install the UltraVR.
1. Go to the decompressed installation package and run the sh cliInstall.sh command to execute the installation script.
  The following command output is displayed:
```
The operation system is : Linux 3.0.13-0.27-default 
Step 1: 
The install path is: /opt/UltraVR. Are you sure? (y/n): [y]
```
  The installation path of the UltraVR is /opt/UltraVR. The path is fixed.
2. Type y and press Enter.
  The following command output is displayed:
```
 Step 2: The data files path: [/opt/gs/app/data]  Enter the database port [6432]:
```
3. Set the database port number and press Enter. The default value is 6432.
  The following command output is displayed:
```
Please input the database admin password : 
```
  The new password must meet the following complexity requirements:
  - Contains 8 to 15 characters.
  - Contains at least one special character from ~!@#$%*-_=+\[{}];:,./?
  - Must contain at least two of the following types of characters:
    Uppercase letters
    Lowercase letters
    Digits
  - Cannot be the same as the default database password Gaussdb_123.
4. Set the database administrator password and press Enter. The database administrator has the highest database permission, including all system and object permissions. This password may be used in maintenance. Keep the password safe.
  The following command output is displayed:
```
Please confirm the database admin password:
```
5. Type the database administrator password again and press Enter.
  The following command output is displayed:
```
Enter the UltraVR DBA user [RDDBUser]:
```
6. Set a name for the account used to access the database and press Enter. The default username is RDDBUser.
  The following command output is displayed:
```
Please input the password for UltraVR DBA user:
```
  The password of the UltraVR DBA user must meet the following complexity requirements:
  - Contains 8 to 15 characters.
  - Contains at least one special character from ~!@#$%*-_=+\[{}];:,./?
  - Must contain at least two of the following types of characters:
    Uppercase letters
    Lowercase letters
    Digits
7. Set the password for the account used to access the database and press Enter.
  The following command output is displayed:
```
Please confirm the password for UltraVR DBA user:
```
8. Enter the password again and press Enter.
  The following command output is displayed:
```
Step 3: 
Total memory:  3.72(G) 
Required memory:  4(G) 
 
Warn: physical memory size is smaller than requirement. 
 
     NAME                                    DESCRIPTION                                                           VERSION        SIZE 
------------------------------------------------------------------------------------------------------------------------------------ 
 
1. FusionSphere DR Management Component Provided DR protection for FusionSphere.                              9.0.2          80MB 
 
------------------------------------------------------------------------------------------------------------------------------------ 
 
Enter the serial numbers of modules to be installed, and separate the serial numbers with blank spaces. 
All modules will be installed by default.
```
9. Press Enter.
```
Required space:  1104(M) 
Free space:  16.31(G) 
Step 4: 
Select 1 to 2 IP addresses as the management IP addresses of the DR system. Use a space to separate the IP addresses, for example, 1 2.
=================================================================================
[1] eth0  MAC=28:6E:D4:89:8C:7F  IPv4=10.183.219.30  NetMask=255.255.254.0 
=================================================================================
```
10. Enter the serial number before the desired IP address.
  The IP address is used to log in to UltraVR. It must reside on the same network segment as the devices managed by UltraVR.
11. Press Enter.
```
Please input the listening port [9443]:
```
12. Enter the port used by the UltraVR HTTPS service. The default port is 9443. Press Enter to install UltraVR. If the following information is displayed, the installation is successful.
  The installation is successful if the following command output is displayed:
```
Start install software, Please wait... 
Installation is completed. 
 
*************Install Succeed!************* 
 
 
access_privilege success. 
are you sure to start up the software immediately? (y/n):
```
Enter y to start the UltraVR.
The start is successful if the following command output is displayed:
```
System is starting. Please wait... 
0% complete... 
10% complete... 
20% complete... 
30% complete... 
40% complete... 
50% complete... 
60% complete... 
70% complete... 
80% complete... 
90% complete... 
100% complete... 
 
System started completely.     
```
If you do not want to start the UltraVR immediately, enter n. Later, if you want to start the UltraVR, you can go to the /opt/UltraVR/Runtime/bin directory and run the sh startSystem.sh command to start it.

Some ports are occupied when the UltraVR is being started. If those ports are occupied by other applications or the format of port numbers is incorrect, the UltraVR cannot be started. Under such conditions, you need to change ports and start the UltraVR again. For details about how to change ports of the UltraVR, see Changing Ports of the UltraVR.
- Run the ps -ef | grep java | grep /opt/UltraVR command to check the foreground processes on the UltraVR.
- Run the ps -ef | grep java | grep equinox.jar command to check the background processes on the UltraVR.
- Run the /etc/init.d/gaussdb status command to view the running status of the GaussDB database.

Follow-up Procedure

After the installation is complete, wait 5 to 10 minutes. After the UltraVR is started, perform operations described in Log In To UltraVR. If you can log in to UltraVR, the installation is successful.
To ensure system security, you are advised to change the passwords of DRManager and ICUser (system account), RDDBUser (database access account), and GaussDB (database administrator account) periodically after the UltraVR is installed. For details about how to change passwords, See the default password of the account for the target node on the Type A (Background) sheet in the UltraVR V100R003C10SPC900 Account List.
For security purposes, users may want to use a certificate issued by a third-party certification authority. The UltraVR Server allows users to replace user Tomcat certificates as long as users provide authentication certificates and private-public key pairs. For details about how to replace certificates, see Replacing Tomcat Certificates on the UltraVR.