Add a server

This topic describes how to add a server to the resource pool of OceanBase Admin Toolkit (OAT).

Prerequisites

You have installed OAT. For more information, see Deploy OAT.

Procedure

1. Log on to the OAT console.

2. In the left-side navigation pane, click Server.

3. In the upper-right corner of the Server Management page, click Add Server.

4. In the Add Server dialog box, specify the basic information.

   The following table describes the parameters.

   Parameter	Description
   Server IP	The public IP address of the server to be added.
   SSH Port	The SSH port number of the server to be added.
   IDC	The IDC where the server to be added is located.
   Credentials	The access credentials of the server to be added. At present, two types of credentials are supported: (1) username + password and (2) key.
   Description	The description of the server that can help facilitate host management. This parameter is optional.

5. Toggle on Initialize configuration, and specify the parameters.

   The following table describes the parameters.

   Parameter	Description
   Server Usage	The purpose of the server to be added.
   OceanBase OS User	The OS user that installs and runs OBServer and OceanBase services. A custom user is supported.
   Password	The password of the OS user.
   UID:GID	The UID and GID of the OS user.
   Docker Root Directory	The data directory of Docker.

   • Clock Synchronization: Specifies whether to enable clock synchronization. This parameter is optional and is disabled by default. To enable clock synchronization, you need to specify the following information:

     Notice

     The clock sources must be synchronized between the server where the OceanBase cluster is deployed and the server where OCP is deployed.

     Parameter	Description
     Clock source IP address	The IP address of the clock source.
     minpoll	The minimum interval between time synchronization requests sent from the chrony client to the clock source, in seconds.
     maxpoll	The maximum interval between time synchronization requests sent from the chrony client to the clock source, in seconds.
     maxslewrate	The maximum slew rate for the clock of the chrony client, in parts per million (ppm).
     Use this server as a secondary clock source	After this option is selected, the server can provide services as the clock source before requests from clients on the allowlist are allowed and requests from clients on the blocklist are blocked. This parameter is optional.

   • Automatically Synchronize to OCP: This parameter is optional and is disabled by default. After you enable this option, you must select an installed OCP. If no OCP is available, this option is disabled. If you enable Automatically Synchronize to OCP, OAT automatically calls an API of OCP to synchronize server information to the OCP that you specified during initialization for future use.

     Note

     The installed OCPs refer to those available on the page that appears after you choose Product Services > Products > OCP in the OAT console. For more information about how to install OCP, see Deploy OCP.

   • Disk initialization settings: To ensure the stability of OceanBase Database and other OceanBase services, we recommend that you configure the directories of the services on independent disks or partitions . If you select the disk initialization option, OAT automatically creates the corresponding volume group (VG) by using a logical volume manager (LVM), and mounts the logical volumes (LVs) of the corresponding size to the specified mounting directories.

     • Select a disk or partition: The system automatically identifies unmounted disks. You can select one or more disks to mount.
     • Mounting Purpose: Select a mounting purpose. Valid values are Software Installation Path, Data Disk Path, Log Disk Path, and Docker Root Directory.
     • Mounting Point: Select the mounting path based on the actual situation.
     • Space (/GB): Specify the space size based on the actual situation, in GB.

6. Click OK.

   • If disk initialization is enabled, a dialog box that shows the check items will appear after you click Submit. If all check items pass, click OK to add the server.

   • If disk initialization is disabled, the configurations are directly submitted and the system starts server initialization after you click Submit.

Then you can view the new server in the server list. The server is in the Initializing state. On the Server Management page, you can find the new server and click View Tasks in the Actions column to view the initialization progress. At the top of the page, you can search for a server by IP address.

If an error is returned for a subtask that does not affect business, you can view the logs and manually mark the subtask as success.

References

• For more information about how to add a server, see Add a server.
• After a server is initialized, you can perform O&M operations on it. For example, you can change the purpose of the server and configure clock synchronization and disk initialization for the server. For more information about server O&M operations, see Perform O&M operations on a server.