Add a server

This topic describes how to add a server to an OAT resource pool.

Prerequisites

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

Procedure

1. Log in to OAT.

2. In the left-side navigation pane, click Server to go to the Server Management page. In the upper-right corner of the page, click Add Server.

3. On the Add Server page, enter the basic information of the server.

   The following table describes the parameters:

   Parameter	Description
   Server IP	The external IP address of the server to be added.
   SSH Port	The SSH port of the server to be added.
   IDC	The IDC to which the server to be added belongs.
   Credential	The access credentials of the server to be added. Currently, username and password and key are supported.
   Description (Optional)	The comment on the server, which is useful for better host management.

4. On the Add Server page, perform initial configuration.

   The following table describes the parameters:

   Parameter	Description
   Purpose	The purpose of the server.
   OS Owner	The operating system user for installing and running OBServer and OB services. Custom users are supported.
   User Password	The password corresponding to the OS owner user.
   User UID:GID	The UID and GID of the OS owner user.
   Docker Root Dir	The root directory for storing Docker data.

   • Clock Synchronization (Optional): By default, clock synchronization is disabled. If clock synchronization is enabled, specify the following parameters:

     Notice

     Clock source synchronization is required 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 time interval in seconds for the chrony client to request time synchronization from the clock source.
     maxpoll:	The maximum time interval in seconds for the chrony client to request time synchronization from the clock source.
     maxslewrate:	The maximum adjustment rate in PPM (10−6) for the chrony client's clock.
     Serve as a secondary clock source (Optional)	After this parameter is set, the server can serve as a clock source for external clients that meet the allowlist criteria but not the blacklist criteria.

   • Automatic Synchronization to OCP (Optional): By default, automatic synchronization is disabled. If automatic synchronization is enabled, select the OCP that has been installed. If no OCP is available for selection, the option will be grayed out. After you complete the initialization setup of the server in OAT, the system automatically calls the API of the OCP to add the server to the specified OCP for future use.

     Notice

     • The OCPs listed here are from those installed in Product Services > Products > OCP. For more information, see Deploy OCP.
     • Before you use OCP to deploy an OceanBase cluster, add the server where you want to deploy the OceanBase cluster to the OCP resource pool.

   • Disk Initialization (Optional): To ensure the stability of OceanBase Database and related product services, it is generally recommended to configure the service directories on independent disks. After you select a disk for initialization, the system will automatically use lvm to create a corresponding vg, and a corresponding lv will be mounted to the specified mount directory.

     • Select Disk or Partition: The system automatically recognizes the unmounted disk devices and you can select the devices to mount. Multiple devices can be selected.
     • Mount Purpose: The options are Software Installation Path, Data Disk Path, Log Disk Path, and Docker Root Dir. You can select the appropriate option based on your business requirements.
     • Mount Point: You can specify the mount path based on your business requirements.
     • Space (/GB): You can specify the space size based on your business requirements. The unit is GB.

5. Click OK.

   • If you enable the disk initialization feature, a dialog box displaying the check items will appear when you submit the request. After the check items are verified, click OK to add the server.

   • If you disable the disk initialization feature, you can directly submit the request and then perform the initialization operation.

After the server is successfully submitted, you can view it in the server list in the server management page. The status of the server is Initializing. On the Server Management page, you can find the added server and click Actions in the View Tasks column to view the task progress. If there are many servers, you can search for the target server by IP address at the top of the page.

If an error occurs during the task execution and the error does not affect your business, you can view the log information and manually set the failed task to success.

Next steps

After the server is added, you can deploy OCP as needed:

• Deploy OCP

After OCP is deployed and the server is added, you can deploy an OceanBase cluster as needed:

• Deploy an OceanBase cluster with OCP
• Deploy an OceanBase cluster with one replica using OCP
• Deploy an OceanBase cluster with three replicas using OCP

References

• For more information about how to add servers, see Add servers.
• For more information about how to maintain servers, see Maintain servers.