Installing Quorum Server Software on a General-Purpose Server

Prerequisites

• You have obtained the quorum server software package and uploaded it to the quorum server.
• The following tools and components are ready: OpenSSL, useradd, groupadd, chown, tar, bzip2, dpkg, or rpm.
• The quorum server has been deployed and its hardware meets the requirements specified in "Preparing for Installation".

• The arbitration certificate is valid. The validity period of the default arbitration certificate is 10 years. Ensure the system time of the quorum server is correct so that the default arbitration certificate is valid.
• A Secure Shell (SSH) tool such as PuTTY has been prepared to log in to the quorum server.

You are advised to harden the security of your operating system. For details, see the official security operation guide of the operating system.

Context

If the quorum server software is installed in the Ubuntu system, dash must be disabled because the quorum server software must be installed in bash mode.

To disable dash, run the sudo dpkg-reconfigure dash command in any directory of the Ubuntu system. Press the → key, select No, and press Enter to change dash to bash.

The system shell is the default command interpreter for shell scripts. 
xUsing dash as the system shell will improve the system's overall performance. It does not alter the shell presented to interactive users.


Use dash as the default system shell (/bin/sh)?  

                       <Yes>                        <No> 

Procedure

1. Log in to the quorum server as the root user.
2. Decompress the installation package.
   1. In the operating system of the quorum server, run the unzip command to decompress the installation package.

      XXX@Linux:~# unzip OceanStor/QuorumServer/OceanStor_QuorumServer_VXXXRXXXCXX.zip 
      Archive: OceanStor_QuorumServer_VXXXRXXXCXX.zip  
      package/  
      package/quorum_server.sh  
      package/packages/  
      package/packages/QuorumServer-VXXXRXXXCXX-linux.x86_64.rpm  
      package/qs_version.ini  
      package/tools/      

   2. After decompressing the installation package, run the cd package command to go to its directory.

      XXX@Linux:~# cd package 

   3. (Optional) Run the ll command to list files in the directory.

3. Run the ./quorum_server.sh -install command to install the quorum server software.

   The non-root user account that is used to install the quorum server software will be used to run and manage the software in follow-up operations. If a password expiration policy is configured on the quorum server, the password of this account may expire, resulting in an access failure. Change the password regularly for security purposes.

   XXX@Linux:~# ./quorum_server.sh -install 
   Verify the QuorumServer existence. 
   The QuorumServer is not installed. 
   The current user is the root user. A quorum server administrator account needs to be provided. Continue to install? 
   <Y|N>:Y                                       #Enter "Y" to install the quorum server software. 
   Enter an administrator account for the quorum server:[default: quorumsvr]:      #Press "Enter". The system installs the quorum server software under the default user account quorumsvr. 
   Created new account: quorumsvr. 
   Changing password for quorumsvr. 
   New Password:                                               #Set the password of user quorumsvr. You are advised to periodically change your password for security.
   Reenter New Password:                                       #Repeat the password. 
   Password changed. 
   Installing the quorum server. 
   Preparing...                ########################################### [100%] 
    1:QuorumServer           ########################################### [100%] 
   [Notice] No old configuration need to resume. 
   QuorumServer install success completed.     

   quorumsvr is the default user account for the quorum server software installation. If you want to install the quorum server software under another user account, enter the user name after Enter an administrator account for the quorum server:[default: quorumsvr], for example, Enter an administrator account for the quorum server:[default: quorumsvr]:User_test.

   Non-root user permissions are restricted for security purposes. You can run the sudo command to obtain permissions for the following commands: cat, ps, sh, useradd, groupadd, userdel, groupdel, usermod, passwd, sed, rm, rpm, ls, chmod, chown, find, xargs, killall, mv, ln, and unzip. For example, run the sudo cat xxx command, where xxx indicates the name of a file in the system.

4. (Optional) Verify that the quorum server software is installed successfully.
   1. After the quorum server software is installed, it starts automatically. Enter the CLI of the quorum server, go to any directory, and run the qsadmin command to open the quorum server software. If the software page is displayed, the software has restarted successfully.

      XXX@Linux:~# qsadmin 
      start main! 
      Waiting for connecting to server... 
      admin:/>     

   2. Enter the CLI of the quorum server, go to any directory, and run the ps -elf |grep quo* command to check whether the quorum server software is installed successfully. If /opt/quorum_server/bin/quorum_serverd is displayed in the command output, the installation is successful.

      XXX@Linux:~# ps -elf |grep quo* 
      4 S testUser  1102      1  0  80  0 -  137524 hrtime Apr29 ?     01:12:14 /opt/quorum_server/bin/quorum_serverd
      0 S testUser 21885  19967  0  80  0 -  28162 pipe_w 08:55 pts/3  00:00:00 grep --color=auto quo* 

Follow-up Procedure

After the installation is successful, run the quit command to exit the CLI of the quorum server.