How-to guides

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

1 - Managing DB Services

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

Parameter Management

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

Parameter lookup

To view configuration parameters, follow these steps.

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List On the page, click the resource whose parameters you want to view or modify. 3. Navigate to the MySQL(DBaaS) Details page.
4. Click the More button, then click the Parameter Management button. 4. Parameter Management The popup window opens.
5. In the Parameter Management popup, 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.

Edit Parameter

To modify the configuration parameters, follow the steps below.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource whose parameters you want to view or modify. 3. MySQL(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. In the Parameter Management popup, click the Search button. 5. View Notification The popup window opens.
6. When the View Notification popup opens, click the Confirm button. 6. Retrieving may take a short amount of time.
7. If modification 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 to view DB user information and modify status information.

Query DB users

To view DB users, follow these steps.

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Go to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource for which you want to view the DB user. 3. MySQL(DBaaS) Details Go to the page.
4. Click the More button, then click the DB User Management button. 4. Go 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.

Change DB user status

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

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List Click the resource on the page for which you want to modify the DB user. 3. MySQL(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. 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 Complete 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.

View DB access control

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

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List Click the resource you want to manage access control for on this page. 3. MySQL(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.

Add DB Access Control

Follow these steps to add IP access control.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL (DBaaS) List Click the resource on the page where you want to add IP access control. 3. MySQL(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. On the DB Access Control Management page, click the Search button. 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 > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List page, click the resource for which you want to delete IP access control. 3. MySQL(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. On the DB Access Control Management page, click the Search button. 5. Retrieving may take a short amount of time.
6. When the query is complete, click the Delete button. 6. Delete The popup window opens.
7. Delete popup, click the Confirm button.

Configure Archive mode

Provides Archive mode configuration and Archive Log retention period settings, allowing users to flexibly configure Archive log management policies to suit their operational environment.

To set the Archive mode, follow these steps.

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Go to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource you want to set Archive mode for. 3. MySQL(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 usage status and retention period.
7. When the edit is complete, click the Complete button.

DB Log Export

Supports exporting log data that requires long-term retention among 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 specified Object Storage for storage 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. Click the All Services > Database > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List page: click the resource whose DB Log you want to export. 3. Navigate to the MySQL(DBaaS) Details page.
4. Click the More button and then click the DB Log Export button. 4. DB Log Export Go to the page.
5. On the DB Log Export page, click the Register button. 5. Navigate to the Register DB Log Export page.
6. DB Log Export Registration page, after entering the required information, click the Complete button.

   Category	Required	Detailed description
   Log type	Required	Log type to be saved
   Save bucket name	Essential	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. MySQL(DBaaS) DB Log Export Configuration Items

Managing DB Log Export

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

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource you want to manage DB Log export for. 3. MySQL(DBaaS) Details Go to the page.
4. Click the More button, then click the DB Log Export button. 4. Go 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: Disables 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 > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List navigate to the page.
3. MySQL(DBaaS) List page, click the resource to upgrade the Major version. 3. Navigate to the MySQL(DBaaS) Details 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. All Services > Database > MySQL(DBaaS) menu, click it. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource to upgrade the Minor version. 3. MySQL(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.

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. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List page, click the resource you want to migrate. 3. MySQL(DBaaS) Details Go to the page.
4. Click the More button, then click the Migration Setup button. 4. Migration configuration 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 Verify 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	Username of the Source DB to be migrated
   Source DB password	Required	Password of the source DB that is the migration target

   Table. MySQL (DBaaS) migration configuration items

Promote Migration Cluster to Master Cluster

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

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

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource to promote to Master. 3. MySQL(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 popup, click the Confirm button.

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. All Services > Database > MySQL(DBaaS) menu, click it. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Go to the page.
3. MySQL (DBaaS) List page, click the resource to view Block Storage usage. 3. MySQL(DBaaS) Details Navigate to the page.
4. Click the More button, then click the Block Storage Usage Management button. 4. Go to the Block Storage Usage Management page.
5. On the Block Storage Usage Management page, click the Search button. 5. Block Storage Usage Management page shows usage by Block Storage type.
   • Retrieving usage by Block Storage type may take a short while.

OS Kernel Upgrade

You can upgrade the OS kernel to improve the functionality of the running database and apply security patches.

To upgrade the OS Kernel, follow these steps.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. Please click the resource to upgrade the OS Kernel on the MySQL(DBaaS) List page. 3. Navigate to the MySQL(DBaaS) Details 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 In the popup window, review the instructions and click the Confirm button.

2 - Backing up and restoring the DB

Users can configure backups of MySQL (DBaaS) through the Samsung Cloud Platform Console and restore from the backed‑up files.

Backing up MySQL (DBaaS)

PostgreSQL(DBaaS) provides a data backup feature 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 instructions on configuring backup settings for MySQL(DBaaS), see MySQL(DBaaS) 생성하기.

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

To set up a backup, follow these steps.

1. Click the All Services > Database > MySQL(DBaaS) menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List On the page, click the resource to configure a backup. 3. MySQL(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 the retention period, backup start time, and Archive backup interval, then click the Confirm button.
   • If you stop the backup setting, uncheck Use in the Backup Settings popup window and authenticate via the logged-in user’s mobile phone.
     Once user authentication is completed, the backup setting is disabled and backup execution stops.

Perform immediate backup

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. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL(DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List page, click the resource to perform an immediate backup. 3. MySQL(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 setting popup, click the Confirm button.

Check backup history

To view the backup history, follow these steps.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource to view the backup history. 3. MySQL(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, start time, completion time, and size.

Delete backup file

To delete the backup history, follow these steps.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Go to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) List page, click the resource to view the backup history. 3. MySQL(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, check the files you want to delete, then authenticate using the logged-in user’s mobile phone.
   • When user authentication is completed, the backup file will be deleted.

MySQL(DBaaS) Recover

If a failure or data loss necessitates restoration from a backup file, the recovery function can restore based on a specific point in time. When performing a MySQL(DBaaS) recovery, a new server is created with the OS image from the initial provisioning point, the database is installed with the version from the backup point, and the recovery proceeds using the database’s configuration information and data.

To recover MySQL (DBaaS), follow these steps.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. MySQL(DBaaS) Resource Click the resource you want to restore on the list page. 3. MySQL(DBaaS) Details Go to the page.
4. Click the Database Recovery button. 4. Go to the Database Recovery page.
5. After entering the relevant information in the Database Recovery Configuration area, click the Complete button.

   Category	Required status	Detailed description
   Recovery type	Required	Set the point in time the user wants to restore Backup point (recommended): Restore based on the backup file. Select from the list of backup points displayed in the list. Custom point: Restore to a user‑desired point within the range of recoverable backup times. The recoverable period depends on the Archive backup interval setting, allowing restoration from the initial backup start time 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 specification commonly used High Capacity: large-capacity server with 24vCore or more (to be provided later)
   Service Type > Planned Compute	Selection	Planned Compute가 설정된 자원 현황 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 request 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. Applied identically with the storage type set in the original cluster Enter capacity as a multiple of 8 within the range 16 to 5,120 Additional: Storage area for DATA, Archive, TEMP, Backup data Applied identically with the storage type 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 Click the Add button to add storage, or click the x button to delete 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), and 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, set the day of the week, start time, and duration The maintenance window is a feature that lets the user define the time slot for performing patch operations, and any patch work within that period must be carried out by the user. 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 from failure to perform tasks within the window.
   tag	Selection	Add tag After clicking the Add tag button, enter or select Key, Value values

   Table. MySQL(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

You can create replica servers for read‑only or disaster‑recovery purposes through replica configuration. You can create up to 5 replicas per database.

To configure a Replica, follow these steps.

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Navigate to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) menu. 2. MySQL(DBaaS) List Navigate to the page.
3. On the MySQL(DBaaS) List page, click the resource to configure a Replica. 3. MySQL(DBaaS) Details Navigate to the page.
4. Click the Replica configuration button. 4. Go to the Replica configuration page.
5. After entering information in the Replica configuration area, click the Done 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 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	Required	Replica server type Standard: standard specification commonly used High Capacity: large-capacity server with 24 vCores or more
   Service Type > Planned Compute	Selection	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 Apply for Planned Compute
   IP access control	Select	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 Add Tag after clicking the button, enter or select Key, Value values

   Table. MySQL (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 the steps below.

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

Promoting a Replica Cluster to a Master Cluster

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

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

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

4 - MySQL (DBaaS) server connection

Scenario Overview

MySQL(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 MySQL (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

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

1-1. ### Create VPC

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 Create VPC button. 2. Create VPC navigate to the 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.
   • After 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, check the created resources on the Security Group List page.

2. ## Create Bastion host

Explains the process of configuring a Bastion Host that requires the Database access client to 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.
   • When creation is complete, check the created resources on the Virtual Server list page.

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

1. Click the All Services > Compute > Virtual Server 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. ### MySQL(DBaaS) Create Service

1. All Services > Database > MySQL(DBaaS) Click the menu. 1. Go to the Service Home page of MySQL (DBaaS).
2. On the Service Home page, click the MySQL(DBaaS) Create button. 2. MySQL(DBaaS) Creation Navigate to the page.
3. MySQL(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.
   • When creation is complete, check the created resource on the MySQL(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. Go 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. All Services > Networking > FirewallClick the 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 bottom left, enter the Database server information created in 3-1. MySQL(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 you set in 3-1. MySQL(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.