This topic describes how to install, upgrade, roll back, and uninstall OAS by using OAT.
Prerequisites
Before you install OAS, make sure that the following conditions are met:
- You have installed OAT and logged in as a super administrator or an O&M engineer. For more information, see Install OAT..
- You have added a server to install OAS. For more information, see Add a server. .
- You have created the MetaDB component for OAS. For more information, see Create MetaDB.
Install OAS
To install OAS, perform the following steps:
In the left-side navigation pane, choose Product Service > Products.
On the Product Management page, click Install the product in the upper-right corner and choose Install OAS.
On the Install OAS page, configure the parameters.
The following table describes the basic parameters of OAS.
Parameter Explanation OAS Image The OAS image. You can select the latest version or click Manage image files in the drop-down list to add a new image. Product Name The name of the product. The name must be unique. Associated OCP The OCP to be associated with OAS. Note
- If you cannot access OCP, you can enter the admin password of OCP.
- The version of the selected OCP must be V4.3.5 or later.
Server The IP address of the server on which you want to install OAS. You can select one or more IP addresses. CPU The number of CPU cores available to OAS on each server. Memory The size of memory available to OAS on each server. HTTP Port The HTTP port for OAS to provide services. The default value is 8990. AI Console Port The port for the OAS AI assistant console. The default value is 8991. AI Server Port The port for the core service of the OAS AI assistant. The default value is 8992. Log Directory The log storage path of OAS. The default value is /home/admin/logs/oas.The following table describes the MetaDB parameters of OAS.
Parameter Explanation MetaDB Type The type of MetaDB. Valid values: - Created MetaDB
- Other OB_MySQL
Select Created MetaDB The MetaDB to be associated with OAS. Tenant Name The name of the tenant. The default value is oas_meta.Tenant Password The password of the tenant. Database Name The name of the database. The default value is oas_metadb.Tenant CPU The number of CPU cores available to MetaDB on each server. The default value is 2C. Memory The size of memory available to MetaDB on each server. The default value is 5G. Load balancing:
You can choose one of the following load balancing modes:
Created NLB: NLB automatically adds load balancing rules for the HTTP service address of the product based on the VIP and VPORT that you specify. If you select MetaDB has been created., NLB also automatically adds load balancing rules for MetaDB.
Created OBDNS: OBDNS automatically adds load balancing rules for the HTTP service address of the product based on the Domain Name and VPORT that you specify. If you select MetaDB has been created., OBDNS also automatically adds domain name resolution for the servers of MetaDB.
Other Load Balancing:
Parameter Explanation MetaDB TCP Proxy IP The proxy IP address or domain name for OAS to connect to MetaDB. MetaDB TCP Proxy Port The proxy port for OAS to connect to MetaDB. The default value is 3306. HTTP Proxy IP The IP address for OAS to provide services. HTTP Proxy Port (VPORT) The HTTP proxy port for OAS. The default value is 80. Do Not Use: If you select this option, high availability is not supported. The IP address of the first server is used as the connection information by default.
After you configure the parameters, click Submit.
If you want to restore the default configurations, click Reset.
Upgrade OAS
Notice
When you upgrade OCP V4.3.5 to a later version, the OAS service is unavailable:
- After you upgrade the OCP system, immediately upgrade OAS.
- OAS is unavailable during the OCP/OAS upgrade. We recommend that you plan a maintenance window in advance.
To upgrade OAS, perform the following steps:
In the left-side navigation pane, choose Product Service > Products.
Find the OAS service that you want to upgrade and click the name in the Name column to go to the details page.
Note
You can also search for the service by name at the top of the page.
In the upper-right corner of the details page, click Upgrade.
In the Upgrade dialog box, specify the required information.
The following table describes the related parameters.
Parameter Description Upgrade Mode Select Stop Service. This option is applicable to services that do not require business continuity. During the upgrade, OAT stops the service of the previous version and cannot provide services. Select the image file for the upgrade The image file to be upgraded. Click Confirm.
Roll back the OAS version
If the OAS upgrade task is successful, perform the following steps to roll back the OAS version:
In the left-side navigation pane, choose Product Service > Products.
Find the OAS service that you want to roll back and click the name in the Name column to go to the details page.
Note
You can also search for the service by name at the top of the page.
In the upper-right corner of the details page, click Version rollback.
In the Version rollback dialog box, specify the required information.
The following table describes the related parameters.
Parameter Description Select the metadata backup file The metadata file to be used for the version rollback. Select the image file for the version rollback The image file to be used for the version rollback. The rollback will lose all monitoring and diagnostic data You can select this option. The rollback will lose all data records generated during the current version and the new features/services added in the current version may be unavailable. You can select this option. Click Sure..
Uninstall OAS
To uninstall OAS, perform the following steps:
In the left-side navigation pane, choose Product Service > Products.
Find the OAS service that you want to uninstall and click the name in the Name column to go to the details page.
Note
You can also search for the service by name at the top of the page.
In the upper-right corner of the details page, click Uninstall.
In the dialog box that appears, click Sure..