How-to guides

• 1: Managing DB Services
• 2: Backing up and restoring the DB
• 3: Configure Read Replica
• 4: MariaDB(DBaaS) server connection

1 - Managing DB Services

Users can manage MariaDB (DBaaS) through the Samsung Cloud Platform Console.

Parameter Management

Provides a feature that allows you to easily view and modify database configuration parameters.

Parameter View

To view configuration parameters, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Go to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource whose parameters you want to view or modify. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the Parameter Management button. 4. Parameter Management The popup window opens.
5. Parameter Management in the popup window, click the Search button. 5. View Notification popup window opens.
6. When the View Notification popup appears, click the Confirm button. 6. Retrieving may take a short amount of time.

Edit Parameter

To modify the configuration parameters, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List page, click the resource whose parameters you want to view or modify. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button and click the Parameter Management button. 4. Parameter Management The popup window opens.
5. Parameter Management In the popup window, click the Search button. 5. View Notification The popup window opens.
6. View Notification when the popup window opens, click the Confirm button. 6. Retrieving may take a short amount of time.
7. If editing is required, click the Edit button and enter the changes in the custom value area of the Parameter to be edited.
8. When the input is complete, click the Complete button.

SQL> SHOW COLLATION WHERE Charset = 'character set name';

Managing DB Users

Provides administrative features for viewing DB user information and modifying status information.

Query DB Users

Follow these steps to query DB users.

1. All Services > Database > MariaDB(DBaaS) Click the menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB (DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List page, click the resource whose DB users you want to view. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the DB User Management button. 4. Navigate to the DB User Management page.
5. DB User Management on the page, click the Search button. 5. Retrieving may take a short amount of time.

Change DB user status

To change the status of the retrieved DB user, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List On the page, click the resource you want to edit the DB user for. 3. MariaDB(DBaaS) Details Navigate to the page.
4. Click the More button, then click the DB User Management button. 4. Navigate to the DB User Management page.
5. On the DB User Management page, click the Search button. 5. Retrieving may take a short amount of time.
6. If modification is required, click the Edit button, and change the status area value or enter remarks.
7. When the input is complete, click the Done button.

Managing DB Access Control

Provides IP-based DB user access control management functionality. Users can directly specify the IP addresses that can access the database, configuring it so that only authorized IPs are allowed access.

View DB Access Control

To view DB users with IP access control enabled, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List On the page, click the resource you want to manage access control for. 3. MariaDB(DBaaS) Details Navigate to the page.
4. Click the More button, then click the DB Access Control Management button. 4. Navigate to the DB Access Control Management page.
5. On the DB Access Control Management page, click the Search button. 5. Retrieving may take a short amount of time.

Add DB access control

To add IP access control, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource for which you want to add IP access control. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button and then click the DB Access Control Management button. 4. Navigate to the DB Access Control Management page.
5. Click the Search button on the DB Access Control Management page. 5. Retrieving may take a short amount of time.
6. When the query is complete, click the Add button. 6. Add DB Access Control The popup window opens.
7. Add DB Access Control In the popup window, select the DB username and enter the IP address.
8. When the input is complete, click the Done button.

Delete DB Access Control

To delete IP access control, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List page, click the resource for which you want to delete the IP access control. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the DB Access Control Management button. 4. Navigate to the DB Access Control Management page.
5. Click the Search button on the DB Access Control Management page. 5. Retrieving may take a short amount of time.
6. When the query is complete, click the Delete button. 6. Delete popup window opens.
7. Click the Confirm button on the Delete popup.

Configure Archive mode

Provides the ability to configure Archive mode and set the retention period for Archive logs, allowing users to flexibly configure Archive log management policies to suit their operating environment.

To set the Archive mode, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List Click the resource on the page for which you want to set Archive mode. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button and then click the Archive Settings Management button. 4. Navigate to the Archive Settings Management page.
5. On the Archive Settings Management page, click the Search button. 5. Retrieving may take a short amount of time.
6. Click the Edit button and select the usage status and retention period.
7. When the edit is complete, click the Complete button.

Modify Audit Settings

You can change the Audit log storage settings of MariaDB (DBaaS).

Follow these steps to change the Audit log storage settings for MariaDB (DBaaS).

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List On the MariaDB(DBaaS) List page, click the resource to view the service status. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Edit icon of the Audit settings at the bottom of the detailed information. 4. Edit Audit Settings The popup window opens.
5. Modify Audit Settings After changing the usage status in the popup window, click the Confirm button.
   • Select Use to enable the Audit log feature. * Enabling audit logging may degrade database performance.
   • If you disable use, the Audit log storage file will be deleted. * Back up the Audit log file separately before disabling.

DB Log Export

Supports exporting log data that requires long-term retention among audit (Audit) logs to Object Storage. Users can directly configure the log types that need to be stored, the destination Bucket for export, and the log export interval. Copies logs to the designated Object Storage for retention according to the configured criteria. Additionally, to efficiently manage disk space, we also provide an option that exports logs to Object Storage while automatically deleting the original log files. By using this option, you can effectively free up storage capacity while safely retaining the necessary log data for the long term.

Setting DB Log Export Mode

Follow these steps to set the DB Log export mode.

1. All Services > Database > MariaDB(DBaaS) Click the menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List On the page, click the resource for which you want to export the DB Log. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the DB Log Export button. 4. Navigate to the DB Log Export page.
5. On the DB Log Export page, click the Register button. 5. Navigate to the Register DB Log Export page.
6. After entering the required information on the DB Log Export Registration page, click the Complete button.

   Category	Required	Detailed description
   Log type	Required	Log type to be saved
   Save bucket name	Required	Object Storage bucket name to be saved
   Authentication key > Access key	Required	Access key for accessing the Object Storage you want to store
   Authentication key > Secret key	Required	Secret key for accessing the Object Storage you want to store
   File creation cycle	Required	File creation frequency in Object Storage
   Whether to delete the original log	Selection	Whether to delete the original logs when exporting to Object Storage

   Table. MariaDB (DBaaS) DB Log Export Configuration Items

Manage DB Log Export

To modify, cancel, or immediately export the DB Log export settings, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List On this page, click the resource for which you want to manage DB Log export. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the Export DB Log button. 4. Navigate to the DB Log Export page.
5. On the DB Log Export page, depending on the log type you want to manage, click the More button and then click the Export Now, Edit, Terminate buttons.
   • Export Immediately: The selected logs are exported to the bucket of the previously configured Object Storage.
   • Edit: Modify the DB Log export mode setting.
   • Cancel: Cancel the DB Log export mode setting.

Upgrade version

If a latest patch that includes security enhancements and feature improvements is available, you can apply it using the version upgrade feature.

Major version upgrade

To perform a Major version upgrade, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to upgrade the Major version. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Edit icon of the Image version item. 4. Version Upgrade A popup window opens.
5. Version Upgrade In the popup window, select the upgrade type and patch version, then click the Confirm button.
6. Version Upgrade Notification: Click the Confirm button in the popup window.

Minor version upgrade

Supports minor version upgrades within the same major version.

To perform a minor version upgrade, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to upgrade the Minor version. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Edit icon of the Image version item. 4. Version Upgrade A popup window opens.
5. Version Upgrade In the popup window, select the upgrade type and the patch version, then click the Confirm button.
6. Version Upgrade Notification In the popup window, click the Confirm button.

Configure Migration

Provides a Migration feature that synchronizes in real time with the operational database and replicates using a Replication method without service interruption.

To configure Migration, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Go to the page.
3. MariaDB(DBaaS) List page, click the resource to migrate. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the Configure Migration button. 4. Migration configuration The popup window opens.
5. Migration configuration In the popup window, review the instructions and click the Confirm button. 5. Go to the Migration configuration page.
6. Migration configuration After entering the required information on the page, click the Check Connection button.
7. When the connection is complete, click the Done button.

   Category	Required	Detailed description
   Source DB Database name	Required	Database name of the source DB to be migrated
   Source DB IP	Required	IP of the Source DB that is the migration target
   Source DB Port	Required	Port of the Source DB to be migrated
   Source DB username	Required	User name of the Source DB to be migrated
   Source DB password	Required	Password of the source DB for migration

   Table. MariaDB (DBaaS) migration configuration items

Promote Migration Cluster to Master Cluster

You can promote a fully configured Migration Cluster to a Master Cluster.

To promote the Migration Cluster to Master, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to promote to Master. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the Master Promotion button. 4. Master Promotion Notification The popup window opens.
5. Master Promotion Notification Click the Confirm button in the popup window.

Managing Block Storage Usage

You can view the usage of Block Storage by type allocated to the DB instance.

To view Block Storage usage, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to view Block Storage usage. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button, then click the Block Storage Usage Management button. 4. Block Storage Usage Management Navigate to the page.
5. On the Block Storage Usage Management page, click the Search button. 5. Block Storage Usage Management The page displays usage by Block Storage type.
   • Retrieving usage by Block Storage type takes a short amount of time.

OS Kernel Upgrade

You can upgrade the OS Kernel to enhance the functionality of the operational database and apply security patches.

Follow these steps to upgrade the OS Kernel.

1. All Services > Database > MariaDB(DBaaS) Click the menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to upgrade the OS Kernel. 3. MariaDB(DBaaS) Details Navigate to the page.
4. Click the More button, then click the OS(Kernel) Upgrade button. 4. OS (Kernel) Upgrade Notification A popup window opens.
5. OS(Kernel) Upgrade Notification Check the instructions in the popup window and click the Confirm button.

2 - Backing up and restoring the DB

Users can set up backups for MariaDB (DBaaS) through the Samsung Cloud Platform Console and restore from the backed‑up files.

Backing up MariaDB(DBaaS)

PostgreSQL (DBaaS) provides data backup functionality based on its own backup commands. Additionally, it provides an optimized backup environment for data protection and management through backup history verification and backup file deletion features.

Configure Backup

For backup configuration of MariaDB (DBaaS), please refer to MariaDB(DBaaS) 생성하기.

To modify the backup settings of the created resource, follow the steps below.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Go to the page.
3. MariaDB(DBaaS) List Click the resource for which you want to set up a backup. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Edit button of the backup item. 4. Backup Settings The popup window opens.
5. When configuring a backup, click Use in the Backup Settings popup, select retention period, backup start time, and Archive backup interval, then click the Confirm button.
   • If you wish to stop the backup configuration, deselect Use in the Backup Settings popup and authenticate using the logged-in user’s mobile phone.
     Once user authentication is complete, the backup configuration is disabled and backup execution stops.

Perform backup immediately

If additional data protection is needed, you can quickly create a backup using the instant backup feature.

To perform an immediate backup, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. On the MariaDB(DBaaS) List page, click the resource to perform an immediate backup. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Immediate Backup button of the backup item. 4. Immediate backup settings The popup window opens.
5. In the Immediate backup setup popup, click the Confirm button.

Check backup history

To check the backup history, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Go to the page.
3. MariaDB(DBaaS) List On the page, click the resource to view the backup history. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Backup History button. 4. Backup History The popup window opens.
5. Backup History In the popup window, you can view the backup status, version, backup start date and time, backup completion date and time, and size.

Delete backup file

To delete the backup file, follow these steps.

1. All Services > Database > MariaDB(DBaaS) Click the menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Navigate to the page.
3. MariaDB(DBaaS) List page, click the resource to view the backup history. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Backup History button. 4. Backup History The popup window opens.
5. Backup History In the popup window, select the files you wish to delete, then authenticate via the logged-in user’s mobile phone.
   • When user authentication is completed, the backup file will be deleted.

Recover MariaDB(DBaaS)

If a failure or data loss requires restoration from a backup file, recovery can be performed based on a specific point in time using the recovery feature. When you perform a MariaDB(DBaaS) recovery, a new server is created using the OS image from the initial provisioning point, the database is installed with the version from the backup point, and the recovery proceeds with the database’s configuration information and data.

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

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB(DBaaS) List Go to the page.
3. On the MariaDB(DBaaS) List page, click the resource you want to recover. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Database Recovery button. 4. Database Recovery Navigate to the page.
5. After entering information in the Database recovery configuration area, click the Complete button.

   Category	Required	Detailed description
   Recovery type	Required	Set the point in time the user wants to recover Backup point (recommended): Recover based on the backup file. Select from the list of backup points displayed in the list Custom point: Recover to a user‑desired point within the recoverable backup time range. The recoverable period depends on the Archive backup interval setting, allowing recovery from the start of the first backup up to 1 hour/30 minutes/10 minutes/5 minutes before the current time. Select the date and time to back up
   Server name prefix	Required	Recovery DB server name Start with a lowercase English letter and use lowercase letters, numbers, and special characters (-) to enter 3 to 16 characters Based on the server name, a postfix such as 001, 002 is appended to generate the actual server name
   Cluster name	Required	Cluster name of the recovery DB Enter using English letters, 3 ~ 20 characters A cluster is a unit that groups multiple servers
   Service Type > Server Type	Required	Server type for the recovery DB installation Standard: Standard specifications commonly used High Capacity: Large-capacity server of 24vCore or more (to be provided later)
   Service Type > Planned Compute	Selection	Status of resources with Planned Compute set In Use: Number of resources with Planned Compute that are currently in use Configured: Number of resources with Planned Compute set Coverage Preview: Amount applied per resource by Planned Compute Create Planned Compute Service: Go to the Planned Compute service application page For more details, refer to Planned Compute 신청하기
   Service Type > Block Storage	Required	Block Storage settings used by the recovery DB Basic OS: Area where the DB engine is installed DATA: Storage area for table data, archive files, etc. Apply the same storage type as set in the original cluster Enter capacity as a multiple of 8 within the range 16 to 5,120 Add: Storage area for DATA, Archive, TEMP, Backup data Apply the same storage type as set in the original cluster In the recovery DB, only DATA, TEMP, and Archive purposes can be added After selecting Use, enter the storage purpose and capacity To add storage, click the Add button; to delete, click the x button Capacity can be entered as a multiple of 8 within the range 16 to 5,120, and up to 9 can be created
   Database username	Required	Database username set in the source DB
   Database Port number	Required	Database Port number set in the source DB
   IP access control	Selection	IP address for accessing the recovery DB Enter in IP format (example: 192.168.10.1) or CIDR format (example: 192.168.10.1/32, 192.168.10.1/32), then click the Add button To delete an entered IP, click the x button next to the entered IP
   maintenance period	Selection	DB maintenance window If you select Use, you can set the day, start time, and duration The maintenance window is a feature that allows the user to set the time slot for performing patch operations, and patch tasks within that time are the user’s responsibility. We ask you to set a maintenance window for the stable operation of the system, and we are not responsible for any issues arising from not setting it or failing to perform tasks within the window.
   tag	Selection	Add Tag Add Tag after clicking the button, enter or select Key, Value values

   Table. MariaDB (DBaaS) Recovery Configuration Items

3 - Configure Read Replica

Users can enter the required information for a Read Replica through the Samsung Cloud Platform Console and create the service using detailed options.

Configure Replica

Through replica configuration, you can create replica servers for read-only or disaster recovery purposes. You can create up to 5 replicas per database.

To configure a Replica, follow these steps.

1. All Services > Database > MariaDB (DBaaS) Click the menu. 1. Go to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. MariaDB (DBaaS) List page is accessed.
3. On the MariaDB (DBaaS) List page, click the resource to configure a Replica. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Replica configuration button. 4. Replica configuration Navigate to the page.
5. After entering information in the Replica configuration area, click the Complete button.

   Category	required status	Detailed description
   Region	Required	Region to configure the Replica Replica configuration (Other Region) is displayed only when selected
   Replica count	Required	Number of Replicas to configure Up to 5 can be configured per cluster If you select more than one value, additionally enter the Replica name and service type information
   Replica name	Required	Replica server name must start with a lowercase English letter, and use lowercase letters, numbers, and special characters (-) to enter 3 to 19 characters The entered Replica name is displayed as the cluster name in the list
   Service Type > Server Type	Essential	Replica server type Standard: standard specification commonly used High Capacity: large-capacity server with 24vCore or more (to be provided later)
   Service Type > Planned Compute	Select	Status of resources with Planned Compute configured In Use: Number of resources with Planned Compute configured that are currently in use Configured: Number of resources with Planned Compute configured Coverage Preview: Amount applied per resource by Planned Compute Create Planned Compute Service: Navigate to the Planned Compute service application page For more details, see Planned Compute 신청하기
   Service Type > Block Storage	Required	Block Storage configuration using Replica DB Basic OS: Area where the DB engine is installed DATA: Storage area for table data, archive files, etc. Applied identically with the storage type set in the source cluster Capacity cannot be set Additional: DATA, Archive, TEMP, Backup data storage area Applied identically with the storage type set in the source cluster In a Replica, only DATA and TEMP can be added After selecting Use, input the storage purpose and capacity To add storage, click the Add button, and to delete, click the x button Capacity can be entered in multiples of 8 within the range 16–5,120, and up to a maximum of 9 can be created, including the number set in the source cluster
   IP access control	Selection	Service Access Policy Configuration Since the access policy is set for the IP entered on the page, a separate Security Group policy configuration is not required Enter in IP format (example: 192.168.10.1) or CIDR format (example: 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	Database maintenance window If you select Use, set the day of week, start time, and duration It is recommended to set a maintenance window for stable management of the DB. Patch operations will be performed at the scheduled time, causing service interruptions If set to unused, we are not responsible for issues arising from patches not being applied.
   tag	Select	Add Tag after clicking the Add Tag button, Key, Value enter or select

   Table. MariaDB (DBaaS) Replica configuration items

Reconfigure Replica

If a network outage or replication delay with the Master Cluster occurs, you can use the Replica reconstruction function to replicate the Master Cluster’s data again.

To reconfigure the Replica, follow these steps.

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Go to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. Navigate to the MariaDB(DBaaS) List page.
3. On the MariaDB(DBaaS) List page, click the resource to reconfigure the Replica. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the Replica Reconstruction button. 4. Replica Reconfiguration Notice A popup window opens.
5. Replica Reconfiguration Notification In the popup window, click the OK button.

Promote Replica Cluster to Master Cluster

You can promote a fully configured Replica Cluster to a Master Cluster.

To promote a Replica Cluster to Master, follow these steps.

1. All Services > Database > MariaDB(DBaaS) Click the menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the MariaDB(DBaaS) menu. 2. Navigate to the MariaDB(DBaaS) List page.
3. On the MariaDB(DBaaS) List page, click the resource to promote to Master. 3. MariaDB(DBaaS) Details Go to the page.
4. Click the More button and then click the Master Promotion button. 4. Master Promotion Notification The popup window opens.
5. Master Promotion Notification in the popup window, click the Confirm button.

4 - MariaDB(DBaaS) server connection

Scenario Overview

MariaDB(DBaaS) Server Connection scenario involves creating a Bastion host (Virtual Server) and a Database service, and accessing the DB service through the Bastion host. To reliably connect to MariaDB (DBaaS) in the Samsung Cloud Platform environment, you need to create a Bastion host and establish a network connection using it. To maintain stability and a high level of security, we recommend configuring the Database service in a Private Subnet environment and setting up the Bastion host in a restricted Public Subnet environment.

This scenario primarily describes creating a Bastion host and Database service, configuring the network environment for Bastion host and Database access, and connecting through a DB client.

Scenario components

You can build the scenario using the following services.

Scenario setup method

Create the services needed to build the scenario by following the procedure below.

1. ## Configure Network

Describes the process of configuring the network environment for accessing the Bastion Host and Database services.

1-1. ### Create VPC

1. All Services > Networking > VPC menu, click it. 1. Navigate to the VPC’s Service Home page.
2. On the Service Home page, click the Create VPC button. 2. Go to the Create VPC page.
3. On the VPC creation page, enter the information required to create the service.
   • Enter the IP range as 192.168.x.0/16.
4. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • When creation is complete, check the created resources on the VPC List page.

1-2. ### Create Subnet

1. All Services > Networking > VPC Click the menu. 1. Navigate to the VPC’s Service Home page.
2. On the Service Home page, click the Subnet menu. 2. Navigate to the Subnet list page.
3. Create Subnet Click the button. 3. Go to the Subnet Creation page.
4. On the Subnet Creation page, enter the information required to create the service.
   • Select the Subnet type as General.
   • Select a pre‑created VPC.
   • Enter the IP range as 192.168.x.0/24.
5. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • After creation is complete, check the created resources on the Subnet List page.

1-3. ### Create Internet Gateway

1. All Services > Networking > VPC Click the menu. 1. Navigate to the VPC’s Service Home page.
2. On the Service Home page, click the Internet Gateway menu. 2. Internet Gateway List Navigate to the page.
3. Internet Gateway creation Click the button. 3. Go to the Create Internet Gateway page.
4. On the Internet Gateway Creation page, enter the required information needed to create the service.
   • Select a pre‑created VPC.
   • In the Firewall usage option, select Use.
5. 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 Internet Gateway List page.

1-4. ### Create Public IP

1. All Services > Networking > VPC Click the menu. 1. Navigate to the VPC’s Service Home page.
2. On the Service Home page, click the Public IP menu. 2. Go to the Public IP List page.
3. Public IP reservation Click the button. 3. Go to the Public IP reservation page.
4. On the Public IP reservation page, enter the required information for service reservation.
5. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • When creation is complete, check the created resources on the Public IP List page.

1-5. ### Create Security Group

1. Click the All Services > Networking > Security Group menu. 1. Go to the Service Home page of the Security Group.
2. On the Service Home page, click the Create Security Group button. 2. Go to the Security Group Creation page.
3. On the Security Group creation page, enter the required information to create the service.
4. Check the input information and click the Done button.
   • After creation is complete, verify the created resources on the Security Group List page.

2. ## Create Bastion host

Explains the process of configuring a Bastion Host where the Database access client must be installed.

2-1. ### Create Server Keypair

1. All Services > Compute > Virtual Server Click the menu. 1. Navigate to the Service Home page of the Virtual Server.
2. On the Service Home page, click the Keypair menu. 2. Go to the Keypair List page.
3. Create Keypair button, click it. 3. Go to the Keypair creation page.
4. On the Keypair Creation page, enter the required information needed to create the service.
5. Verify the creation information and click the Complete button.
   • The key can be downloaded only for the first time, and reissuance is not provided.
   • Please store the downloaded key in a secure location.

2-2. ### Create Bastion host

1. All Services > Compute > Virtual Server Click the menu. 1. Navigate to the Service Home page of the Virtual Server.
2. On the Service Home page, click the Create Virtual Server button. 2. Go to the Create Virtual Server page.
3. On the Virtual Server Creation page, enter the required essential information needed to create the service.
   • Select Windows for the image.
   • Select the pre-created VPC and Subnet.
   • Click Use NAT, and select the reserved Public IP from 1-4. Public IP 생성하기.
   • Connect the Keypair created in 2-1. Create Server Keypair.
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 resources on the Virtual Server List page.

2-3. ### Check Bastion host login ID and PW

1. All Services > Compute > Virtual Server Click the menu. 1. Navigate to the Service Home page of the Virtual Server.
2. On the Service Home page, click the Virtual Server menu. 2. Go to the Virtual Server List page.
3. Virtual Serve List page, click the resource you created in 2-2. Bastion host 생성하기. 3. Go to the detailed information page for the resource.
4. Click the RDP password view button in the Keypair name field on the detail information page. 4. RDP password lookup A popup window opens.
5. RDP password lookup in the popup window, attach the keypair file downloaded from 2-1. 서버 Keypair 생성하기.
6. After attaching, click the Password verification button. 6. The ID and password required to access the resource are displayed.
   • The ID and Password are used later as credentials to access the Bastion host in 5-1. Bastion host 접속하기.

3. ## Create Database

Describes the process of creating a Database service.

3-1. ### MariaDB(DBaaS) Create Service

1. Click the All Services > Database > MariaDB(DBaaS) menu. 1. Navigate to the Service Home page of MariaDB (DBaaS).
2. On the Service Home page, click the Create MariaDB (DBaaS) button. 2. Go to the MariaDB(DBaaS) Create page.
3. On the MariaDB(DBaaS) Creation page, enter the required information needed to create the service.
   • Select the pre‑created VPC and Subnet and connect them.
   • Enter database-related creation information on the required information input screen.
   • Add the Bastion host IP in the IP access control item.
   • The database port defaults to 2866, but users can also specify a different one.
4. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • After creation is complete, verify the created resource on the MariaDB(DBaaS) list page.

4. ## Configure Rules

Describes the process of setting rules for users to connect to the Bastion host and rules for connecting to the Database from the Bastion host.

4-1. ### Security Group Add security rule

1. Click the All Services > Networking > Security Group menu. 1. Go to the Service Home page of the Security Group.
2. On the Service Home page, click the Security Group menu. 2. Navigate to the Security Group List page.
3. 1-5. 3. Security Group CreateSelect the Security Group resource created in 3. Go to the detailed information page for the resource.
4. On the detail information page, click the Rules tab. 4. Go to the Rules tab.
5. Click the Add Rule button on the Rule tab. 5. Add Rule Navigate to the popup window.
6. Add Rule In the popup window, enter the rule below, and click the Confirm button.

   Direction	Remote	Target address	Protocol	Port	Explanation
   Inbound	CIDR	User PC IP	TCP	3389 (RDP)	Bastion access PC → Bastion host
   Outbound	CIDR	DB IP	TCP	Database Port (manual entry)	Bastion host → Database

   Table. Security Group rules that need to be added

4-2. ### Add IGW Firewall rule

1. Click the All Services > Networking > Firewall menu. 1. Navigate to the Firewall’s Service Home page.
2. On the Service Home page, click the Firewall menu. 2. Go to the Firewall List page.
3. On the Firewall List page, select the Internet Gateway resource name created in 1-3. Internet Gateway 생성하기. 3. Go to the detailed information page for the resource.
4. On the detail information page, click the Rules tab. 4. Go to the Rules tab.
5. Click the Add Rule button on the Rule tab. 5. Add Rule Navigate to the popup window.
6. Add Rule In the popup window, enter the rule below, and click the Confirm button.

   Origin address	Destination address	Protocol	Port	Operation	Direction	Explanation
   Bastion connection PC IP	Bastion host IP	TCP	3389(RDP)	Allow	Inbound	User PC → Bastion host

   Table. Internet Gateway Firewall rules to be added

5. ## Database Connect

Describes the process of a user connecting to a database through a DB client program.

This guide provides instructions on how to connect using MySQL Workbench. Database client programs and CLI utilities are diverse, so you can install and use the tool that best suits your needs.

5-1. ### Connecting to Bastion host

1. In the Windows environment of the PC that will connect to the Bastion host, run Remote Desktop Connection, then enter the NAT IP of the Bastion Host and click the Connect button.
2. When the remote desktop connection succeeds, user credential input window opens. 2. Enter the ID and Password verified in 2-3. Bastion host 접속 ID 및 PW 확인하기 and click the Confirm button.

5-2. ### Install the DB client program (MySQL Workbench) on the Bastion host

1. Go to the official MySQL page and download the MySQL Workbench program.
   • MySQL Workbench program download URL: https://dev.mysql.com/downloads/workbench
2. Connect the user’s PC hard drive to upload the file to the Bastion host.
3. Click the Details button of the Local devices and resources item on the Local Resources tab of the Remote Desktop Connection.
4. Select the local disk of the location where the file was downloaded on the drive, and click the Confirm button.
5. Copy the downloaded file, upload it to the Bastion Host, and click the MySQL Workbench installer to install it.

5-3. ### Connect to the database using a DB client program (MySQL Workbench)

1. Run MySQL Workbench and click Database > Manage connections. 1. Manage Server Connection A popup window appears.
2. Manage Server Connection In the popup window, click the New button at the lower left, enter the Database server information created in 3-1. MariaDB(DBaaS) 서비스 생성하기, and click the Test Connection button. 2. Password a popup window appears.

   Required input element item	input value
   Connection Name	Custom (ex. service name)
   Host name	Database server IP
   Port	Database Port
   Username	Database username

   Table DB connection client program input fields
3. Password In the popup window, enter the password set in 3-1. MariaDB(DBaaS) 서비스 생성하기 and click the OK button. 3. When the operation succeeds, click the OK button in the Manage Server Connection popup window.
4. Click Database > Connect to Database. 4. Connect to Database A popup window appears.
5. Select the Connection Name registered in Stored Connection to perform a Database connection. 5. After connecting, you can perform simple queries, etc.