How-to guides

The user can enter the required information for MariaDB (DBaaS) and select detailed options through the Samsung Cloud Platform Console to create the service.

Creating MariaDB(DBaaS)

You can create and use the MariaDB (DBaaS) service from the Samsung Cloud Platform Console.

To create MariaDB (DBaaS), follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. You will be taken to the Service Home page of MariaDB(DBaaS).
2. Service Home on the page click the MariaDB(DBaaS) creation button. Navigate to the MariaDB(DBaaS) creation page.
3. MariaDB(DBaaS) creation on the page, enter the information required to create the service, and select detailed options.
   • Please select the required information in the Image and version selection area.

     Category	Required	Detailed description
     Image version	Required	Provide version list of MariaDB (DBaaS)

     Table. MariaDB(DBaaS) Image and Version Selection Items
   • Service Information Input Enter or select the required information in the area.

     Category	Required or not	Detailed description
     Server name Prefix	Required	Name of the server where the DB will be installed Start with a lowercase English letter, and use lowercase letters, numbers, and the special character (-) to input 3 to 13 characters Based on the server name, a postfix such as 001, 002 is attached to create the actual server name
     Cluster Name	Required	Cluster name composed of DB servers Enter using English letters, 3 to 20 characters A cluster is a unit that groups multiple servers
     Service Type > Server Type	Required	Server type where DB will be installed Standard: Standard specifications commonly used High Capacity: Large-capacity server of 24 vCore or more For detailed information about server types provided by MariaDB (DBaaS), refer to MariaDB(DBaaS) Server Type
     Service Type > Planned Compute	Select	Status of resources with Planned Compute set In Use: Number of resources with Planned Compute set that are currently in use Configured: Number of resources with Planned Compute set Coverage Preview: Amount applied by Planned Compute per resource Create Planned Compute Service: Go to the Planned Compute service application page For details, refer to Apply for Planned Compute
     Service Type > Block Storage	Required	Block Storage settings used by DB according to purpose Base OS: Area where the DB engine is installed DATA: Storage area for table data, archive files, etc. Select the storage type and then enter the capacity. (For detailed information on each Block Storage type, refer to Create Block Storage) SSD: High-performance general volume HDD: General volume SSD_KMS, HDD_KMS: Additional encrypted volumes using Samsung Cloud Platform KMS (Key Management System) encryption keys The configured storage type is applied identically to additional storage Capacity must be entered as a multiple of 8 within the range 16 ~ 5,120 Since large sorts during SQL execution or monthly batch processes can cause service interruptions, a separate TEMP storage must be allocated and used Additional: Data storage areas for DATA, Archive, TEMP, Backup After selecting Use, enter the storage’s purpose and capacity The storage type is applied the same as set for DATA, and capacity can be entered as a multiple of 8 within the range 16 ~ 5,120 Click the + button to add storage, and the x button to delete. Up to 9 can be added Temporarily store backup data in BACKUP storage before transmitting backup data If the data to be backed up exceeds 100 GB and changes frequently, it is recommended to add a separate BACKUP storage for reliable backup. It is advised to set the backup capacity to about 60% of the DATA capacity If a BACKUP storage is not added, using the /tmp area is recommended For each service, only one Block Storage is allocated for Archive, TEMP, BACKUP
     Redundancy Configuration	Selection	Redundancy Configuration Status If redundancy configuration is used, the DB instance is configured as Active DB and Standby DB
     Network > Common Settings	Required	Network settings where servers generated by the service are installed Select if you want to apply the same settings to all servers being installed Select a pre‑created VPC, Subnet, IP, and Public NAT IP can only be auto‑generated The Public NAT feature is available only when the VPC is connected to an Internet Gateway. If you check Use, you can select a reserved IP from the VPC product’s Public IP. See Create Public IP for details.
     Network > Server-specific Settings	Required	Network settings where servers generated by the service are installed Select if you want to apply different settings per installed server Select a pre-created VPC, Subnet, IP, Public NAT Enter each server’s IP The Public NAT feature is available only when the VPC is connected to an Internet Gateway. If you check Use, you can select from reserved IPs in the VPC product’s Public IP. For more details, see Create Public IP.
     IP Access Control	Select	Service Access Policy Settings Since the access policy is set for the IP entered on the page, a separate Security Group policy setting is not required. Enter in IP format (e.g., 192.168.10.1) or CIDR format (e.g., 192.168.10.0/24, 192.168.10.1/32) and click the Add button To delete an entered IP, click the x button next to the entered IP
     Maintenance Period	Select	DB Maintenance Period Use is selected, set day of week, start time, and duration It is recommended to set a maintenance period for stable DB management. Patch work is performed at the set time, causing service interruption If set to not use, Samsung SDS is not responsible for issues arising from unapplied patches.

     Table. MariaDB (DBaaS) Service Information Input Items
   • Database configuration required information input area, please enter or select the required information.

     Category	Required or not	Detailed description
     Database name	Required	Server name applied when installing DB Start with English letters, use English letters and numbers, input 3 ~ 20 characters
     Database username	Required	DB user name An account with the same name is also created on the OS Enter using lowercase English letters, 2 to 20 characters Restricted Database usernames can be checked in the Console
     Database password	Required	Password to use when accessing the DB Enter 8~30 characters including letters, numbers, and special characters (“ ‘ excluded)
     Database Password Confirmation	Required	Re-enter the same password to be used when accessing the DB
     Database Port Number	Required	Port number required for DB connection Enter DB port within the range 1,024 ~ 65,535
     Backup > Use	Select	Whether to use backup Select Use to set the backup file retention period, backup start time, and Archive backup cycle
     Backup > Retention Period	Select	Backup retention period Select backup retention period. File retention period can be set from 7 days to 35 days Backup files incur separate charges based on size
     Backup > Backup Start Period	Select	Backup Start Time Select backup start time The minutes (minutes) at which the backup runs are set randomly, and the backup end time cannot be set
     Backup > Archive backup frequency	Select	Archive backup frequency Select the Archive backup frequency Archive backup frequency is recommended at 1 hour. Selecting 5 minutes, 10 minutes, or 30 minutes may affect DB performance
     Audit Log Settings	Select	Whether to store Audit Log Enable를 선택하여 Audit Log 기능을 설정 User connection information records are stored Users can specify the types of events to audit via the server_audit_events parameter, and it can be modified through the Parameter screen Refer to the MariaDB documentation for details on this parameter Enabling Audit may degrade DB performance
     Parameter	Required	Parameters to use in the DB Lookup Click the button to view detailed information of the parameter Parameters can be modified after DB creation is complete, and after modification the DB must be restarted
     DB character set	Required	Character encoding method to use for the DB The character set used when storing text data, and the DB is created with this encoding set as the default.
     Time zone	Required	Standard time zone to be used by the Database

     Table. MariaDB(DBaaS) Database configuration items
   • Additional Information Input area: enter or select the required information.

     Category	Required or not	Detailed description
     Tag	Select	Add Tag Up to 50 can be added per resource After clicking the Add Tag button, enter or select Key, Value values

     Table. MariaDB(DBaaS) Additional Information Input Items
4. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • Once creation is complete, check the created resource on the Resource List page.

MariaDB(DBaaS) Check detailed information

MariaDB(DBaaS) service can view and edit the full resource list and detailed information. The MariaDB(DBaaS) Details page consists of Details, Tags, Activity Log tabs, and for DBs with a Replica configured, an additional Replica Information tab is included.

To view detailed information about the MariaDB (DBaaS) service, follow the steps below.

1. All Services > Database > MariaDB(DBaaS) Click the menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Click the MariaDB(DBaaS) menu on the Service Home page. You will be taken to the MariaDB(DBaaS) List page.
3. Click the resource to view detailed information on the MariaDB(DBaaS) List page. You will be taken to the MariaDB(DBaaS) Details page.

• MariaDB(DBaaS) Details At the top of the page, status information and information about additional features are displayed.

  Category	Detailed description
  Cluster Status	Cluster status with DB installed Creating: Cluster is being created Editing: Cluster is being changed to operation execution state Error: Cluster encountered a failure while performing tasks If it occurs continuously, contact the administrator Failed: Cluster failed during creation Restarting: Cluster is being restarted Running: Cluster is operating normally Starting: Cluster is being started Stopped: Cluster is stopped Stopping: Cluster is being stopped Synchronizing: Cluster is being synchronized Terminating: Cluster is being deleted Unknown: Cluster status is unknown If it occurs continuously, contact the administrator Upgrading: Cluster is changing to upgrade execution state
  Cluster Control	Button to change cluster state Start: Start a stopped cluster Stop: Stop a running cluster Restart: Restart a running cluster Switch-Over: Switch a standby cluster to active
  More additional features	Cluster related management buttons Service status synchronization: Real-time DB service status lookup Backup history: If backup is set, check whether backup runs normally and view history Database recovery: Recover DB based on a specific point in time Parameter management: DB configuration parameters can be queried and modified Replica configuration: Set up a read-only cluster called Replica DB user management: View and manage DB account (user) information registered in the DB DB access control management: Based on DB accounts registered in the DB, you can register and revoke allowed IPs Archive management: Can set archive file retention period and archive mode DB Log export: Through audit settings, stored logs can be exported to the user’s Object Storage Migration configuration: Provides migration functionality using replication method
  Service termination	Button to cancel the service

  Table. MariaDB (DBaaS) status information and additional features

Detailed Information

MariaDB(DBaaS) List page allows you to view detailed information of the selected resource and, if necessary, edit the information.

Replica Information

Replica Information tab is enabled only when a Replica is configured in the cluster. Replica Information tab allows you to check the master cluster name, number of replicas, and replica status.

Tag

MariaDB(DBaaS) List page allows you to view the tag information of the selected resource, and you can add, modify, or delete it.

Work History

You can view the operation history of the selected resource on the MariaDB(DBaaS) List page.

MariaDB(DBaaS) Manage Resources

If you need to change or restore the existing configuration options of a created MariaDB (DBaaS) resource, or need a Replica configuration, you can perform the work on the MariaDB(DBaaS) Details page.

Control Operation

If changes occur to the running MariaDB (DBaaS) resources, you can start, stop, or restart them. Also, if HA is configured, you can switch the Active-Standby servers via Switch-over.

To control the operation of MariaDB (DBaaS), follow the steps below.

1. All Services > Database > MariaDB(DBaaS) Click the menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Click the MariaDB(DBaaS) menu on the Service Home page. Go to the MariaDB(DBaaS) list page.
3. MariaDB(DBaaS) 목록 Click the resource to control operation. MariaDB(DBaaS) 상세 Navigate to the page.
4. Check the status of MariaDB (DBaaS) and complete the change using the control button below.
   • Start: The server where the DB service is installed and the DB service are running(Running).
   • Stop: The server where the DB service is installed and the DB service will be stopped (Stopped).

• Restart: Only the DB service will be restarted.
  • Switch Over: You can switch the DB’s Active server and Standby server.

Synchronize Service Status

You can synchronize the real-time service status of MariaDB (DBaaS).

To check the service status of MariaDB (DBaaS), follow the steps below.

1. All Services > Database > MariaDB(DBaaS) Click the menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Click the MariaDB(DBaaS) menu on the Service Home page. Navigate to the MariaDB(DBaaS) List page.
3. Click the resource to view the service status on the MariaDB(DBaaS) List page. Move to the MariaDB(DBaaS) Details page.
4. Click the Service Status Synchronization button. While it is being queried, the cluster changes to Synchronizing state.
5. When the query is completed, the status in the server information item is updated, and the cluster changes to Running status.

Change Server Type

You can change the configured server type.

To change the server type, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. You will be taken to the Service Home page of MariaDB(DBaaS).
2. Service Home page, click the MariaDB(DBaaS) menu. Navigate to the MariaDB(DBaaS) list page.
3. MariaDB(DBaaS) List page, click the resource to change the server type. Move to the MariaDB(DBaaS) Details page.
4. Click the Edit icon of the server type you want to change at the bottom of the detailed information. The Edit Server Type popup window will open.
5. Edit Server Type After selecting the server type in the popup window, click the Confirm button.

Add Storage

If more than 5TB of data storage space is required, you can add storage. In the case of a redundant DB configuration, all redundant servers are added simultaneously.

To add storage, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Service Home page, click the MariaDB(DBaaS) menu. Navigate to the MariaDB(DBaaS) list page.
3. MariaDB(DBaaS) List Click the resource to add storage on the page. MariaDB(DBaaS) Details Navigate to the page.
4. Click the Add Disk button at the bottom of the detailed information. The Add Storage Request popup window opens.
5. Additional Storage Request In the popup window, after entering purpose and capacity, click the Confirm button.

Expanding Storage

You can expand the storage added to the data area up to a maximum of 5 TB based on the initially allocated capacity. In the case of a redundant DB configuration, all redundant servers are expanded simultaneously.

To increase storage capacity, follow the steps below.

1. All Services > Database > MariaDB(DBaaS) Click the menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Click the MariaDB(DBaaS) menu on the Service Home page. Navigate to the MariaDB(DBaaS) List page.
3. Click the resource to change the server type on the MariaDB(DBaaS) List page. It moves to the MariaDB(DBaaS) Details page.
4. Click the Edit icon of the additional Disk you want to add at the bottom of the detailed information. The Edit Additional Storage popup window opens.
5. Add Storage Modification In the popup window, after entering the expansion capacity, click the Confirm button.

MariaDB(DBaaS) Cancel

You can cancel unused MariaDB (DBaaS) to reduce operating costs. However, if you cancel the service, the running service may be stopped immediately, so you should consider the impact of service interruption sufficiently before proceeding with the cancellation.

To cancel MariaDB (DBaaS), follow the steps below.

1. All Services > Database > MariaDB(DBaaS) Click the menu. Navigate to the Service Home page of MariaDB(DBaaS).
2. Service Home page, click the MariaDB(DBaaS) menu. Navigate to the MariaDB(DBaaS) list page.
3. MariaDB(DBaaS) List page, select the resource to cancel, and click the Cancel Service button.
4. Once the termination is complete, check whether the resource has been terminated on the MariaDB(DBaaS) list page.