This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

How-to guides

Users can enter the required information for PostgreSQL (DBaaS) through the Samsung Cloud Platform Console, select detailed options, and create the service.

Creating PostgreSQL(DBaaS)

You can create and use PostgreSQL (DBaaS) services from the Samsung Cloud Platform Console.

Guide
  • Please configure the VPC’s Subnet type as General before creating the service.
    • If the Subnet type is Local, the creation of the corresponding Database service is not possible.
  • If you load more than 2 TB of large data, backup may take a long time or the DB performance itself may degrade. To prevent this, you need to consider operational aspects such as cleaning up unnecessary data or moving old data to a statistical collection environment.

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

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Go to the Service Home page of PostgreSQL(DBaaS).

  2. Click the PostgreSQL(DBaaS) Create button on the Service Home page. Navigate to the PostgreSQL(DBaaS) Create page.

  3. PostgreSQL(DBaaS) Creation on the page, enter the information required to create the service, and select detailed options.

    • Image and version selection Select the required information in the area.
      Category
      Required or not
      Detailed description
      Image versionRequiredProvide version list of PostgreSQL (DBaaS)
      Table. PostgreSQL (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 PrefixRequiredServer name where DB will be installed
      • Start with an English lowercase 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 NameRequiredCluster name of DB servers
      • Enter using English letters, 3 ~ 20 characters
      • A cluster is a unit that groups multiple servers
      Service Type > Server TypeRequiredServer type where DB will be installed
      • Standard: Standard specifications commonly used
      • High Capacity: Large-capacity server of 24 vCore or more
      Service Type > Planned ComputeSelectStatus 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
      Service Type > Block StorageRequiredSet Block Storage used by DB according to purpose
      • Base OS: Area where DB engine is installed
      • DATA: Storage area for table data, archive files, etc.
        • After selecting storage type, enter capacity (refer to Create Block Storage for details of each Block Storage type)
          • 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
        • Because large sorts from SQL execution or monthly batch may cause service interruption, a separate TEMP storage must be allocated and used
        • Add: DATA, Archive, TEMP, Backup data storage areas
          • After selecting Use, enter the storage’s purpose and capacity
          • The storage type is the same as set for DATA, and capacity can be entered as a multiple of 8 within 16 ~ 5,120
          • Click the + button to add storage, x button to delete. Up to 9 can be added
          • Backup data is temporarily stored in BACKUP storage before transmission
            • If backup data exceeds 100 GB and changes frequently, it is recommended to add a separate BACKUP storage for reliable backup; set backup capacity to about 60% of DATA capacity
            • If BACKUP storage is not added, using the /tmp area is recommended
          • For each service, Archive, TEMP, BACKUP storages are allocated only one Block Storage
      Redundancy ConfigurationSelectRedundancy Configuration Status
      • If redundancy configuration is used, the DB instance is configured as Active DB and Standby DB
      Network > Common SettingsRequiredNetwork 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, 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 from reserved IPs in the VPC product’s Public IP. For details, see Create Public IP
      Network > Server-specific SettingsRequiredNetwork settings where servers generated by the service are installed
      • Select if you want to apply different settings for each installed server
      • Select a pre-created VPC, Subnet, IP, and Public NAT
        • Enter the IP for each server
        • 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 ControlSelectService 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 PeriodSelectDB Maintenance Period
      • If Use is selected, set the day of the week, start time, and duration.
      • It is recommended to set a maintenance period for stable DB management. Patch work will be performed at the set time, causing service interruption.
      • If set to not use, Samsung SDS is not responsible for issues arising from patches not being applied.
      Table. PostgreSQL(DBaaS) Service Information Input Items
    • Database Configuration Required Information Input In the area, please enter or select the required information.
      Category
      Required or not
      Detailed description
      Database nameRequiredServer name applied when installing DB
      • Start with English letters, use English letters and numbers, input 3 ~ 20 characters
      Database usernameRequiredDB user name
      • An account with that 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 PasswordRequiredPassword to use when accessing the DB
      • Enter 8~30 characters including letters, numbers, and special characters (excluding “ and ‘)
      Database password verificationRequiredRe-enter the same password to be used for DB access
      Database Port numberRequiredPort number required for DB connection
      • Enter DB port within the range 1,024 ~ 65,535
      Backup > UseSelectWhether to use backup
      • Use to set backup file retention period, backup start time, Archive backup cycle
      Backup > Retention PeriodSelectBackup Retention Period
      • Select the backup retention period, set the file retention period from 7 days to 35 days
      • Backup files are charged separately based on size
      Backup > Backup Start PeriodSelectBackup Start Time
      • Select backup start time
      • The minutes at which the backup runs are set randomly, and the backup end time cannot be set
      Backup > Archive Backup FrequencySelectArchive 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 SettingsSelectWhether to store Audit Log
      • Enable to configure the Audit Log feature
        • DDL, DML, and user connection information records are stored
          • Users can specify the type of SQL statements to audit via the log_statement parameter, and can modify it through the Parameter screen
        • Enabling Audit may degrade DB performance
      ParameterRequiredParameters to use in the DB
      • Click the Search button to view detailed information of the parameters
      • Parameters can be modified after DB creation is complete, and the DB must be restarted after modification
      Database EncodingRequiredCharacter encoding method to be used for the DB
      • Character set used when storing text data
      • The DB is created with the selected encoding as the default setting
      DB LocaleRequiredLocale to use for DB
      • Settings related to string processing, number/currency/date/time display formats, etc.
      • The DB is created with default settings using the selected Locale
      Time zoneRequiredStandard time zone to be used by the Database
      Table. PostgreSQL(DBaaS) Database configuration items
    • Additional Information Input Enter or select the required information in the area.
      Category
      Required or not
      Detailed description
      TagSelectAdd Tag
      • Up to 50 can be added per resource
      • After clicking the Add Tag button, enter or select Key, Value values
      Table. PostgreSQL(DBaaS) Additional Information Input Items
  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 Resource List page.

PostgreSQL(DBaaS) Check detailed information

PostgreSQL(DBaaS) service can view and edit the full resource list and detailed information. PostgreSQL(DBaaS) Details page consists of Details, Tags, Activity History tabs, and for databases with a Replica configured, a Replica Information tab is additionally provided.

To view detailed information of the PostgreSQL (DBaaS) service, follow the steps below.

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Move to the PostgreSQL(DBaaS) List page.
  3. Click the resource to view detailed information on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  • PostgreSQL(DBaaS) Details At the top of the page, status information and additional feature information are displayed.
    CategoryDetailed description
    Cluster StatusCluster status with DB installed
    • Creating: Cluster is being created
    • Editing: Cluster is changing to operation execution state
    • Error: Cluster encountered an error 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 ControlButtons 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 functionsCluster related management buttons
    • Service status synchronization: View real-time DB service status
    • 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: View and modify DB configuration parameters
    • Replica configuration: Configure a read-only cluster Replica; if there is no region to configure for the account, the button is disabled
    • Replica configuration (Other Region): Configure a disaster recovery Replica in another region
    • DB user management: View and manage DB account (user) information registered in the DB
    • DB access control management: Register and revoke allowed IPs based on DB accounts registered in the DB
    • Archive management: Set archive file retention period and archive mode
    • Export DB Log: Export logs stored via audit settings to the user’s Object Storage
    • Migration configuration: Provide migration function using replication method
    Service cancellationButton to cancel the service
    Table. PostgreSQL(DBaaS) status information and additional features

Detailed Information

PostgreSQL(DBaaS) List On the page, you can view detailed information of the selected resource and, if necessary, edit the information.

CategoryDetailed description
Server InformationServer information configured in the respective cluster
  • Category: Server type (Active, Standby, Replica)
  • Server Name: Server name
  • IP:Port: Server IP and port
  • Status: Server status
ServiceService Name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In DB service, it means cluster SRN
Resource NameResource Name
  • In DB service, it means the cluster name
Resource IDUnique resource ID in the service
CreatorUser who created the service
Creation timeService creation time
EditorUser who modified the service information
Modification DateTimeDate and time the service information was modified
Image/VersionInstalled DB image and version information
  • If a version upgrade is required, click the Edit icon to set
Cluster TypeCluster Type (Master Cluster, Replica Cluster, Migration Cluster)
Cluster NameName of the cluster composed of DB servers
Master cluster nameReplica’s Master cluster name
  • If it is detailed information of the Replica, it can be checked.
Database nameServer name applied when installing DB
Database usernameDB user name
Planned ComputeResource status with Planned Compute set
Maintenance PeriodDB Patch Work Period Setting Status
  • If maintenance period setting is required, click the Edit icon to set
BackupBackup configuration status
  • If backup configuration is needed, click the Edit icon to set
Audit Log SettingsAudit Log Settings Status
  • If Audit Log settings are needed, click the Edit icon to configure
Time zoneStandard time zone used by the Database
DB LocaleLocale to use for DB
Database EncodingCharacter encoding method to be used in DB
VIPVirtual IP information
  • Can be checked only when redundancy is configured
NetworkNetwork information where DB is installed (VPC, Subnet, VIP, NAT IP(VIP))
IP Access ControlService Access Policy Settings
  • If you need to add or delete an IP, click the Edit icon to set
Active & StandbyActive/Standby server type, default OS, additional Disk information
  • If you need to modify the server type, click the Edit icon next to the server type to set it. Refer to Change Server Type for the server type modification procedure
    • Modifying the server type requires a server reboot
  • If you need to expand storage, click the Edit icon next to the storage capacity to expand. Refer to Expand Storage for the storage expansion procedure
  • If you need to add storage, click the Add Disk button next to Additional Disk to add. Refer to Add Storage for the storage addition procedure
Table. PostgreSQL(DBaaS) Database detailed information items

Replica Information

Replica Information tab is enabled only when a Replica is configured in the cluster. Through the Replica Information tab, you can check the master cluster name, the number of replicas, and the replication status of the Replica.

CategoryDetailed description
Master informationName of the Master cluster
Replica countNumber of Replicas created in the Master cluster
Replica statusReplica server status created in the Master cluster
  • Server name, status query, status details, and status check time can be viewed
  • To query the Replica status, click the Status Query button
    • While querying, the cluster remains in Synchronizing state, and once the query is complete, the cluster changes to Running state
Table. Replica Information Tab Detailed Information Items

Tag

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

CategoryDetailed description
Tag ListTag List
  • Tag Key and Value information can be checked
  • Up to 50 tags can be added per resource
  • When entering a tag, search and select from existing Key and Value lists
Table. PostgreSQL(DBaaS) Tag tab items

Work History

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

CategoryDetailed description
Work History ListResource Change History
  • Work date and time, Resource ID, Resource name, Work details, Event topic, Work result, Operator information verification
Table. Work History Tab Detailed Information Items

PostgreSQL(DBaaS) Managing Resources

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

Operating Control

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

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

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Navigate to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) List Click the resource to control operation on the page. PostgreSQL(DBaaS) Details Navigate to the page.
  4. Check the PostgreSQL(DBaaS) status and complete the change using the control button below.
    • Start: The server where the DB service is installed and the DB service is 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 PostgreSQL (DBaaS).

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

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

Change Server Type

You can change the configured server type.

Caution
If you modify the server type, a server reboot is required. Please separately verify any changes to SW licenses or SW settings and reflections due to changes in server specifications.

To change the server type, follow the steps below.

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Navigate to the PostgreSQL(DBaaS) List page.
  3. PostgreSQL(DBaaS) 목록 Click the resource to change the server type on the page. PostgreSQL(DBaaS) 상세 Navigate to the 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. Server Type Edit After selecting the server type in the popup window, click the Confirm button.

Add storage

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

Caution
  • It is applied the same way as the selected Storage type when creating a service.
  • In the case of a DB configured for redundancy, adding storage will be applied simultaneously to the storage of the Active DB and the Standby DB.
  • If a Replica exists, the Master cluster’s storage cannot be larger than the Replica’s storage. Expand the Replica storage first, then expand the Master cluster storage.
  • When adding Archive/Temp storage, the DB restarts and is temporarily unavailable.

To add storage, follow the steps below.

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Go to the PostgreSQL(DBaaS) List page.
  3. PostgreSQL(DBaaS) List on the page, click the resource to add storage. PostgreSQL(DBaaS) Details navigate to the page.
  4. At the bottom of the detailed information, click the Add Disk button. The Add Storage Request popup window opens.
  5. Additional Storage Request After entering purpose and capacity in the popup window, 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 > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Go to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) List page, click the resource to change the server type. You will be taken to the PostgreSQL(DBaaS) Details page.
  4. Click the Edit icon of the additional Disk you want to expand at the bottom of the detailed information. Edit Additional Storage popup window opens.
  5. Add Storage Modification In the popup window, after entering the expansion capacity, click the Confirm button.

PostgreSQL(DBaaS) Cancel

You can cancel unused PostgreSQL (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.

Caution
  • In the case of a DB with a Replica configured, even if you terminate the Master DB, the Replica is not deleted together. If you also want to delete the Replica, terminate it separately from the resource list.
  • If you terminate the DB, stored data and, if backup is set, all backup data will be deleted.

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

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

1 - Managing DB Services

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

Managing Parameters

It provides a feature to easily view and modify database configuration parameters.

Viewing Parameters

To view configuration parameters, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to view and modify parameters on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the Parameter Management button. The Parameter Management popup window opens.
  5. Click the View button in the Parameter Management popup window. The View Notification popup window opens.
  6. When the View Notification popup window opens, click the OK button. It takes some time to view.

Modifying Parameters

To modify configuration parameters, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to view and modify parameters on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the Parameter Management button. The Parameter Management popup window opens.
  5. Click the View button in the Parameter Management popup window. The View Notification popup window opens.
  6. When the View Notification popup window opens, click the OK button. It takes some time to view.
  7. If modification is required, click the Modify button and enter the modification details in the custom value area of the parameter to be modified.
  8. When the input is complete, click the Save button.

Managing DB Users

It provides a management feature that allows you to view DB user information and change status information.

Viewing DB Users

To view DB users, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to view DB users on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the DB User Management button. It moves to the DB User Management page.
  5. Click the View button on the DB User Management page. It takes some time to view.

Changing DB User Status

To change the status of the viewed DB user, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to modify DB users on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the DB User Management button. It moves to the DB User Management page.
  5. Click the View button on the DB User Management page. It takes some time to view.
  6. If modification is required, click the Modify button and change the status value or enter notes.
  7. When the input is complete, click the Save button.

Managing DB Access Control

It provides an IP-based DB user access control management feature. Users can directly specify the IP that can access the database, allowing only allowed IPs to access.

Notice
Before setting DB access control, perform DB user inquiry. For DB user inquiry, refer to Managing DB Users.

Viewing DB Access Control

To view DB users with IP access control set, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to manage access control on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the DB Access Control Management button. It moves to the DB Access Control Management page.
  5. Click the View button on the DB Access Control Management page. It takes some time to view.

Adding DB Access Control

To add IP access control, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. It moves to the PostgreSQL(DBaaS) List page.
  3. Click the resource you want to add IP access control on the PostgreSQL(DBaaS) List page. It moves to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and then click the DB Access Control Management button. It moves to the DB Access Control Management page.
  5. Click the View button on the DB Access Control Management page. It takes some time to view.
  6. When the view is complete, click the Add button. The DB Access Control Add popup window opens.
  7. In the DB Access Control Add popup window, select the DB user name and enter the IP address.
  8. When the input is complete, click the Save button.

Deleting DB Access Control

To delete IP access control, follow these steps:

  1. All Services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource for which you want to delete IP access control. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the DB Access Control Management button. It moves to the DB Access Control Management page.
  5. On the DB Access Control Management page, click the Inquire button. It takes some time to inquire.
  6. Once the inquiry is complete, click the Delete button. The Delete pop-up window opens.
  7. In the Delete pop-up window, click the Confirm button.

Managing Archive

It provides functions to set Archive mode and Archive log retention period, allowing users to flexibly set Archive log management policies according to their operating environment. Additionally, it provides a function to manually delete Archive logs, allowing users to clean up unnecessary log data and effectively manage system resources.

Notice
When creating a service, the default setting is to use Archive mode, with a retention period of 3 days.

Setting Archive Mode

To set Archive mode, follow these steps:

  1. All Services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource for which you want to set Archive mode. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the Archive Settings Management button. It moves to the Archive Settings Management page.
  5. On the Archive Settings Management page, click the Inquire button. It takes some time to inquire.
  6. Click the Modify button and select the usage and retention period.
  7. Once the modification is complete, click the Save button.

Deleting Archive Files

To delete Archive files, follow these steps:

  1. All Services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource for which you want to set Archive mode. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the Archive Settings Management button. It moves to the Archive Settings Management page.
  5. On the Archive Settings Management page, click the Delete All Archives button to delete all Archive files, or click the Delete Backed-up Archives button to delete only backed-up Archive files.

Exporting DB Logs

It supports exporting audit logs that require long-term storage to Object Storage. Users can directly set the type of log to be stored, the target Bucket, and the frequency of log export. According to the set criteria, it copies the logs to the specified Object Storage for storage. Additionally, to efficiently manage disk space, it provides an option to automatically delete the original log files when exporting logs to Object Storage. By utilizing this option, users can effectively secure storage capacity while safely storing necessary log data for long-term storage.

Notice
  • To use the DB Log export function, Object Storage creation is required. Refer to the Object Storage User Guide for Object Storage creation.
  • Be sure to check the expiration date of the authentication key. If the authentication key expires, logs will not be stored in the Bucket.
  • Be cautious not to expose authentication key information to the outside.

Setting DB Log Export Mode

To set DB Log export mode, follow these steps:

  1. All Services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource for which you want to export DB logs. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the DB Log Export button. It moves to the DB Log Export page.
  5. On the DB Log Export page, click the Register button. It moves to the DB Log Export Registration page.
  6. On the DB Log Export Registration page, enter the corresponding information and click the Save button.
CategoryRequired
Detailed Description
Log TypeRequiredType of log to be stored
Storage Bucket NameRequiredName of the Object Storage Bucket to store
Authentication Key > Access KeyRequiredAccess key to access the Object Storage to store
Authentication Key > Secret KeyRequiredSecret key to access the Object Storage to store
File Creation CycleRequiredCycle to create files in Object Storage
Original Log DeletionOptionalWhether to delete the original log when exporting to Object Storage
Table. PostgreSQL(DBaaS) Migration Configuration Items

Managing DB Log Export

To modify, cancel, or immediately export DB log settings, follow these steps:

  1. All Services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource for which you want to manage DB log export. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the DB Log Export button. It moves to the DB Log Export page.
  5. On the DB Log Export page, click the More button for the log type you want to manage, and then click the Immediate Export, Modify, or Cancel button.
    • Immediate Export: Exports the selected log to the Object Storage Bucket set earlier.
    • Modify: Modifies the DB log export mode setting.
    • Cancel: Cancels the DB log export mode setting.

Upgrading DB Version

It provides a version upgrade function due to some feature improvements and security patches. Only minor version upgrades are supported within the same major version.

Caution
  • Please perform version upgrades after checking the service status through service status synchronization.
  • Please set up backups before performing version upgrades. If backups are not set up, some data may not be recoverable in case of problems during updates.
  • In DBs with Replicas configured, the Master DB version cannot be higher than the Replica version. Please check the Replica version first and perform version upgrades if necessary.
  • Backed-up data will be automatically deleted after version upgrade completion.

To upgrade the version, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource to upgrade the version. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the Modify button in the image/version item. The Version Upgrade popup window opens.
  5. In the Version Upgrade popup window, select the version to modify and whether to set backup, and then click the Confirm button.
  6. In the Version Upgrade Notification popup window, click the Confirm button.

Configuring Migration

It provides a migration function that synchronizes with the operating database in real-time and replicates in a replication manner without interrupting the service.

Notice
For a detailed migration configuration guide, please refer to Architecture Center > Migration Guide > Database Migration Procedure and Considerations.

To configure migration, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource to migrate. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the Configure Migration button. The Configure Migration popup window opens.
  5. In the Configure Migration popup window, check the instructions and click the Confirm button. It moves to the Configure Migration page.
  6. On the Configure Migration page, enter the corresponding information and click the Connect Check button.
  7. When the connection is complete, click the Complete button.
ClassificationRequired
Detailed Description
Source DB Database NameRequiredDatabase name of the source DB that is the migration target
Source DB IPRequiredIP of the source DB that is the migration target
Source DB PortRequiredPort of the source DB that is the migration target
Source DB User NameRequiredUser name of the source DB that is the migration target
Source DB PasswordRequiredPassword of the source DB that is the migration target
Table. PostgreSQL(DBaaS) Migration Configuration Items

The configured migration cluster can be promoted to a master cluster.

Caution
When promoting to master, synchronization with the source DB that is the migration target will be terminated.

To promote the migration cluster to master, follow these steps:

  1. Click the All Services > Database > PostgreSQL(DBaaS) menu. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. On the PostgreSQL(DBaaS) list page, click the resource to promote to master. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the More button and then click the Promote to Master button. The Promote to Master Notification popup window opens.
  5. In the Promote to Master Notification popup window, click the Confirm button.

2 - DB Backup and Recovery

The user can set up a backup of PostgreSQL(DBaaS) through the Samsung Cloud Platform Console and restore it with the backed-up file.

PostgreSQL(DBaaS) backup

PostgreSQL(DBaaS) provides a data backup feature based on its own backup command, and also provides an optimized backup environment for data protection and management through backup history checking and backup file deletion functions.

Setting up backup

The method of setting up a backup of PostgreSQL(DBaaS) is described in PostgreSQL(DBaaS) creation guide.

To modify the backup settings of the generated resource, follow these steps.

Caution
  • For stable backup, it is recommended to add a separate BACKUP storage or to sufficiently expand the storage capacity. Especially when the backup target data exceeds 100 GB and there are many data changes, please secure additional storage equivalent to about 60% of the data capacity. For storage addition and expansion methods, refer to the PostgreSQL(DBaaS) Add Storage, PostgreSQL(DBaaS) Expand Storage guides.
  • If backup is set, backup is performed at the specified time after the set time, and additional fees are incurred depending on the backup capacity.
  • If the backup setting is changed to unset, the backup operation will be stopped immediately, and the saved backup data will be deleted and can no longer be used.

To set up a backup, follow these steps.

  1. All Services > Database > PostgreSQL(DBaaS) menu is clicked. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) list page, click the resource to set the backup. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the Edit button of the backup item. The Backup Settings popup window will open.
  5. If you set up a backup, click Use in the Backup Settings popup window, select the retention period, backup start time, and Archive backup cycle, and then click the Confirm button.
    • If you want to stop the backup setting, uncheck Use in the Backup Setting popup window and click the OK button.

Check Backup History

Notice
To set up notifications for backup success and failure, you can set it up through the Notification Manager product. For a detailed usage guide on setting up notification policies, please refer to Creating a Notification Policy.

To view the backup history, follow these steps.

  1. 모든 서비스 > Database > PostgreSQL(DBaaS) menu should be clicked. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) list page, click the resource to check the backup history. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the Backup History button. The Backup History popup window will open.
  5. Backup History popup window where you can check the backup status, version, backup start time, backup completion time, and capacity.

Deleting backup files

Caution
Backup files cannot be restored after deletion. Please make sure to confirm if the data is unnecessary before deleting it.

To delete the backup history, follow these steps.

  1. All services > Database > PostgreSQL(DBaaS) menu, click. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) list page, click the resource to check the backup history. It moves to the PostgreSQL(DBaaS) details page.
  4. Click the Backup History button. The Backup History popup window opens.
  5. Backup History popup window, check the file you want to delete, and then click the Delete button.

PostgreSQL(DBaaS) recovery

In the event of a failure or data loss that requires restoration from a backup file, the recovery function can be used to restore to a specific point in time. When performing a PostgreSQL (DBaaS) recovery, a new server is created with the OS image at the initial provisioning time, the DB is installed with the version at the backup point, and the recovery proceeds with the DB configuration information and data.

Caution
To perform recovery, at least the same capacity as the data type Disk capacity is required. If the Disk capacity is insufficient, recovery may fail.

To restore PostgreSQL(DBaaS), follow these steps.

  1. All services > Database > PostgreSQL(DBaaS) menu is clicked. It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the PostgreSQL(DBaaS) menu. It moves to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) resource list page, click the resource you want to restore. It moves to the PostgreSQL(DBaaS) detail page.
  4. Database Recovery 버튼을 클릭하세요. Database Recovery 페이지로 이동합니다.
  5. Database Recovery Configuration area, enter the corresponding information, and then click the Complete button.
Classification
Necessity
Detailed Description
Recovery TypeRequiredSet the point in time to recover
  • Backup Point (Recommended): Recover based on the backup file. Select from the list of backup file timestamps displayed in the list
  • Custom Point: Recover to a user-desired point in time within the range where backup is possible. The recoverable period is based on the Archive backup cycle setting value, and can be recovered up to 1 hour/30 minutes/10 minutes/5 minutes before the current time from the initial backup start time. Select the date and time you want to back up
Server name prefixRequiredServer name of the recovery DB
  • Start with lowercase English letters, using lowercase letters, numbers, and special characters (-) to input 3-16 characters
  • A postfix such as 001, 002 is attached based on the server name, and the actual server name is created
Cluster NameRequiredCluster name of the recovery DB
  • Enter in English, 3-20 characters
  • Cluster is a unit that bundles multiple servers
Service Type > Server TypeRequiredServer type where the recovery DB will be installed
  • Standard: Standard specification commonly used
  • High Capacity: High-capacity server with 24vCore or more
Service Type > Planned ComputeSelectionCurrent status of resources with Planned Compute set
  • In Use: Number of resources with Planned Compute set that are in use
  • Settings: Number of resources with Planned Compute set
  • Coverage Preview: Amount applied by Planned Compute for each resource
  • Create Planned Compute Service: Move to the Planned Compute service application page
Service Type > Block StorageRequiredRecovery DB uses Block Storage settings
  • Basic OS: Area where the DB engine is installed
  • DATA: Area for storing table data, archive files, etc.
    • The storage type set in the original cluster is applied identically
    • Capacity can be entered in multiples of 8 in the range of 16 to 5,120
  • Additional: DATA, Archive, TEMP, Backup data storage area
    • The storage type set in the original cluster is applied identically
    • In the recovery DB, only DATA, TEMP, and Archive purposes can be added.
    • After selecting Use, enter the purpose and capacity of the storage
    • To add storage, click the + button, and to delete, click the x button
    • Capacity can be entered in multiples of 8 in the range of 16 to 5,120, and up to 9 can be created
Database usernamerequiredDatabase username set in the original DB
Database Port numberrequiredDatabase Port number set in the original DB
IP Access ControlSelectIP address to access the recovery DB
  • Enter in IP format (e.g., 192.168.10.1) or CIDR format (e.g., 192.168.10.1/32, 192.168.10.1/32) and click the Add button
  • To delete the entered IP, click the x button next to the entered IP
Maintenance periodSelectDB maintenance period
  • Use is selected, set the day of the week, start time, and duration
  • It is recommended to set the maintenance period for stable management of the DB. Patch work is performed at the set time and service interruption occurs
  • If set to unused, Samsung SDS is not responsible for any problems that occur due to non-application of patches.
TagSelectAdd Tag
  • Click the Add Tag button and enter or select Key, Value
Fig. PostgreSQL(DBaaS) Recovery Configuration Items

3 - Read Replica Setup

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

Replica Configure

Through the Replica configuration, you can create replica servers for read-only or disaster recovery purposes. You can create up to 5 Replicas per Database.

Notice
To configure a replica for disaster recovery, please create it via Replica Configuration (Other Region).

To configure a replica, follow these steps.

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Go to the PostgreSQL(DBaaS) List page.
  3. PostgreSQL(DBaaS) List Click the resource to configure the replica on the page. PostgreSQL(DBaaS) Detail Navigate to the page.
  4. Click the Replica configuration button. Navigate to the Replica configuration page.
  5. Replica configuration After entering information in the area, click the Complete button.
    Category
    Required
    Detailed description
    RegionRequiredRegion to configure Replica
    • Replica configuration (Other Region) displayed only when selected
    Number of ReplicasRequiredNumber of Replicas to configure
    • Up to 5 can be configured per cluster
    • If selecting more than 2 values, additionally input Replica name and service type information
    Replica nameRequiredReplica server name
    • Start with a lowercase English letter, and use lowercase letters, numbers, and the special character (-) to input 3 to 19 characters
    • The entered Replica name is displayed as the cluster name in the list
    Service Type > Server TypeRequiredReplica Server Type
    • Standard: Standard specifications commonly used
    • High Capacity: Large-capacity server with 24 vCore or more
    Service Type > Planned ComputeOptionalStatus 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
    IP Access ControlSelectService 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 PeriodSelectDB Maintenance Period
    • If Use is selected, set the day of the week, start time, and duration.
    • It is recommended to set a maintenance period for stable DB management. Patch work will be performed at the set time, causing service interruption.
    • If set to not use, we are not responsible for issues arising from patches not being applied.
    TagSelectAdd Tag
    • Add Tag button click then input or select Key, Value values
    Table. PostgreSQL(DBaaS) Replica configuration items

Replica Reconstruct

If a network failure or replication delay with the Master Cluster occurs, you can re-replicate the Master Cluster’s data using the Replica reconstruction function.

To reconstruct the Replica, follow these steps.

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Go to the Service Home page of PostgreSQL(DBaaS).
  2. Service Home page, click the PostgreSQL(DBaaS) menu. Move to the PostgreSQL(DBaaS) list page.
  3. PostgreSQL(DBaaS) list page, click the resource to reconfigure the Replica. PostgreSQL(DBaaS) details page will be opened.
  4. Replica reconstruction Click the button. Replica reconstruction notification A popup window opens.
  5. Replica Reconstruction Notification in the popup window click the Confirm button.

Promote Replica Cluster to Master Cluster

You can promote a Replica Cluster that has completed configuration to a Master Cluster.

Caution
When Master promotion occurs, synchronization with the existing Master Cluster is stopped.

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

  1. All Services > Database > PostgreSQL(DBaaS) Click the menu. Navigate to the Service Home page of PostgreSQL(DBaaS).
  2. Click the PostgreSQL(DBaaS) menu on the Service Home page. Navigate to the PostgreSQL(DBaaS) List page.
  3. Click the resource to promote to Master on the PostgreSQL(DBaaS) List page. You will be taken to the PostgreSQL(DBaaS) Details page.
  4. Click the More button and click the Master promotion button. The Master promotion notification popup window opens.
  5. Master Promotion Notification in the popup window click the Confirm button.

4 - Connect to DB Server

Scenario Overview

The PostgreSQL(DBaaS) server connection scenario is a scenario where a Bastion host (Virtual Server) and Database service are created, and the DB service is accessed through the Bastion host. To securely access PostgreSQL(DBaaS) in the Samsung Cloud Platform environment, it is necessary to create a Bastion host and use it for network connection. To maintain a stable and high level of security, it is recommended to configure the Database service in a Private Subnet environment and configure the Bastion host in a limited Public Subnet environment.

This scenario largely describes the process of creating Bastion host and Database services, and configuring the network environment for Bastion host and Database connection, to connect through a DB access client.

Architecture
Figure. PostgreSQL(DBaaS) server connection architecture

Scenario Components

You can configure the scenario using the following services.

Service Group
Service
Detailed Description
NetworkingVPCA service that provides an isolated virtual network in a cloud environment
NetworkingVPC > SubnetA service that allows users to subdivide the network into smaller parts for specific purposes/scales within the VPC
NetworkingVPC > Public IPA service that reserves public IP and assigns and returns it to Compute resources
NetworkingVPC > Internet GatewayA service that connects VPC resources to the internet
NetworkingSecurity GroupA virtual firewall that controls the server’s traffic
DatabasePostgreSQL(DBaaS)A service that easily creates and manages EPAS in a web environment
ComputeVirtual ServerVirtual server optimized for cloud computing
ComputeVirtual Server > KeypairEncryption file used to connect to Virtual Server
Table. List of scenario components
Reference
The default policy of the * Security Group is Deny All, so only allowed IPs must be registered. The All Open policy of In/Outbound can expose cloud resources to external threats as is, with any IP and any port. * By specifying the necessary IP and Port to set the policy, you can enhance security.

Scenario composition method

To configure the scenario, create the necessary services through the following procedure.

1. Configuring the Network

This describes the process of configuring the network environment for Bastion Host and Database service connection.

1-1. Creating a VPC

For detailed creation methods, please refer to the Networking > VPC > How-to guides guide.
  1. Click All services > Networking > VPC menu. It moves to the Service Home page of VPC.
  2. On the Service Home page, click the Create VPC button. It moves to the Create VPC page.
  3. VPC Creation page, please enter the information required for service creation.
    • IP range should be entered as 192.168.x.0/16.
  4. In the Summary panel, review the detailed information and estimated charges, then click the Complete button.
    • After creation is complete, check the created resource on the VPC list page.

1-2. Creating a Subnet

For detailed creation methods, please refer to the Networking > VPC > How-to guides > Subnet guide.
  1. Click on the menu for all services > Networking > VPC. It moves to the Service Home page of VPC.
  2. Service Home page, click the Subnet menu. It moves to the Subnet list page.
  3. Click the Subnet Creation button. It moves to the Subnet Creation page.
  4. Subnet Creation page where you enter the information needed to create a service.
    • Subnet type should be selected as General.
    • Please select a pre-created VPC.
    • IP range should be entered as 192.168.x.0/24.
  5. In the Summary panel, review the detailed information and estimated charges, then click the Complete button.
    • Once creation is complete, check the created resource on the Subnet list page.

1-3. Creating an Internet Gateway

For detailed creation methods, please refer to the Networking > VPC > How-to guides > Internet Gateway guide.
  1. Click All services > Networking > VPC menu. It moves to the Service Home page of VPC.
  2. Service Home page, click the Internet Gateway menu. It moves to the Internet Gateway list page.
  3. Click the Create Internet Gateway button. It moves to the Create Internet Gateway page.
  4. Internet Gateway creation page, please enter the required information necessary for service creation.
    • Please select a pre-created VPC.
    • Select Use in the Firewall usage item.
  5. In the Summary panel, review the detailed information and the estimated charge, then click the Complete button.
    • Once the creation is complete, check the created resource on the Internet Gateway list page.

1-4. Creating a Public IP

For detailed creation methods, please refer to the Networking > VPC > How-to guides > Public IP guide.
  1. Click All services > Networking > VPC menu. It moves to the Service Home page of VPC.
  2. Service Home page, click the Public IP menu. It moves to the Public IP list page.
  3. Public IP Reservation button, click. Move to the Public IP Reservation page.
  4. Public IP Reservation page, enter the required information necessary for service reservation.
  5. In the Summary panel, review the detailed information and estimated charges, then click the Complete button.
    • After creation is complete, check the created resource on the Public IP List page.

1-5. Creating a Security Group

For detailed creation methods, please refer to the Networking > Security Group > How-to guides guide.
  1. Click on the menu for all services > Networking > Security Group. It moves to the Service Home page of Security Group.
  2. Click the Security Group creation button on the Service Home page. It moves to the Security Group creation page.
  3. Security Group creation page where you enter the required information necessary for service creation.
  4. Check the input information and click the Complete button.
    • After creation is complete, check the created resource on the Security Group list page

2. Creating a Bastion Host

This describes the process of configuring the Bastion Host where the database connection client should be installed.

2-1. Creating a Server Keypair

For detailed creation methods, please refer to the Compute > Virtual Server > How-to guides > Keypair guide.
  1. Click All Services > Compute > Virtual Server menu. It moves to the Service Home page of Virtual Server.
  2. Click the Keypair menu on the Service Home page. It moves to the Keypair list page.
  3. Keypair creation button should be clicked. It moves to the Keypair creation page.
  4. Keypair creation page, please enter the required information necessary for service creation.
  5. Check the creation information and click the Complete button.
    • The key can only be downloaded for the first time, and re-issuance is not provided.
    • Please keep the downloaded key in a safe place.

2-2. Creating a Bastion Host

For detailed creation methods, please refer to the Compute > Virtual Server > How-to guides guide.
  1. Click All Services > Compute > Virtual Server menu. It moves to the Service Home page of Virtual Server.
  2. Click the Virtual Server Creation button on the Service Home page. It moves to the Virtual Server Creation page.
  3. Virtual Server creation page where you enter the required information necessary for service creation.
  4. Summary panel, check the detailed information generated and the expected billing amount, and click the Complete button.
    • Once creation is complete, check the created resource on the Virtual Server list page.

2-3. Check Bastion host connection ID and PW

  1. Click on the menu for all services > Compute > Virtual Server. It moves to the Service Home page of Virtual Server.
  2. Service Home page, click the Virtual Server menu. Move to the Virtual Server list page.
  3. Virtual Serve list page, click on the resource created in 2-2. Bastion host creation. It moves to the detailed information page of the corresponding resource.
  4. Click the RDP password inquiry button in the Keypair item on the detailed information page. The RDP password inquiry popup window will open.
  5. RDP password inquiry popup window, attach the keypair file downloaded from 2-1. Creating a server keypair.
  6. After attaching, click the Password Check button. The ID and password required to access the resource will be displayed.

3. Creating a Database

Describes the process of creating a database service.

3-1. Creating PostgreSQL(DBaaS) Service

For detailed creation methods, please refer to the Database > PostgreSQL(DBaaS) > How-to guides guide.
  1. Click on the menu for all services > Database > PostgreSQL(DBaaS). It moves to the Service Home page of PostgreSQL(DBaaS).
  2. On the Service Home page, click the Create PostgreSQL(DBaaS) button. It moves to the Create PostgreSQL(DBaaS) page.
  3. PostgreSQL(DBaaS) creation page, please enter the required information needed for service creation.
    • Select and connect the pre-created VPC and Subnet.
    • Enter database-related creation information on the essential information input screen.
    • Add the Bastion host IP to the IP access control items.
    • Database Port is 2866 by default, but you can specify it as you want.
  4. In the Summary panel, review the detailed information and estimated charges, then click the Complete button.
    • After creation is complete, check the created resource on the PostgreSQL(DBaaS) list page.

4. Setting Rules

This describes the process of setting rules for users to access the Bastion host and rules for the Bastion host to access the Database.

4-1. Adding Security Group Security Rules

For detailed creation methods, please refer to the Networking > Security Group > How-to guides guide.
  1. Click on the menu for all services > Networking > Security Group. It moves to the Service Home page of Security Group.
  2. Service Home page, click the Security Group menu. Move to the Security Group list page.
  3. 1-5. Creating a Security Group Select the Security Group resource created from. It will move to the detailed information page of the resource.
  4. Click the Rules tab on the detail information page. It moves to the Rules tab.
  5. Click the Rules tab and click the Add Rule button. It moves to the Add Rule popup window.
  6. Add Rule popup window, enter the rules below, and click the OK button
DirectionRemoteDestination AddressProtocolPortDescription
InboundCIDRUser PC IPTCP3389 (RDP)Bastion access PC → Bastion host
OutboundCIDRDB IPTCPDatabase Port (direct input)Bastion host → Database
Fig. Security Group security rules to be added

4-2. Adding IGW Firewall Rules

For detailed creation methods, please refer to the Networking > Firewall > How-to guides guide.
  1. Click All services > Networking > Firewall menu. It moves to the Service Home page of Firewall.
  2. Service Home page, click the Firewall menu. It moves to the Firewall list page.
  3. Firewall list page, select the Internet Gateway resource name created in 1-3. Creating Internet Gateway, and move to the detailed information page of the corresponding resource.
  4. Click the Rules tab on the detailed information page. It moves to the Rules tab.
  5. Click the Rule tab and click the Add Rule button. It moves to the Add Rule popup window.
  6. Add Rule In the popup window, enter the rules below and click the OK button.
Departure AddressDestination AddressProtocolPortActionDirectionDescription
Bastion access PC IPBastion host IPTCP3389(RDP)AllowInboundUser PC → Bastion host
Table. Internet Gateway Firewall rules to be added

5. Connect to Database

This describes the process of a user accessing the Database through a DB connection client program.

This guide provides instructions on how to connect using pgAdmin. There are various database client programs and CLI utilities, so you can install and use the tools that are suitable for the user.

5-1. Connect to the Bastion host

  1. Run Remote Desktop Connection in the Windows environment of the PC you want to connect to the Bastion host, enter the NAT IP of the Bastion Host, and click the Connect button.
  2. After a successful remote desktop connection, the User Credential Input Window opens. Enter the ID and Password confirmed in 2-3. Checking Bastion Host Access ID and PW and click the Confirm button.

5-2. Installing DB connection client program (pgAdmin) on the Bastion host

  1. Go to the official pgAdmin page and download the pgAdmin program.
  2. Connect the hard drive of the user PC to upload the file to the Bastion host.
  3. Click the Details button for local devices and resources entries in the Local Resources tab of Remote Desktop Connection.
  4. Select the local disk where the file was downloaded to the drive and click the Confirm button.
  5. Copy the downloaded file and upload it to the Bastion Host, then click the pgAdmin installation file to install it.

5-3. Using DB connection client program (pgAdmin) to connect to the database

  1. Run pgAdmin and click the Add New Server button.
  2. In the Register - Server popup window, enter the Database server information created in 3-1. PostgreSQL(DBaaS) service creation in the General tab and Connection tab, and click the Save button.
    Screen (Tab)Required Input Element ItemsInput Value
    GeneralNameCustom (ex. Service Name)
    ConnectionHost name/addressDatabase server IP
    ConnectionPortDatabase Port
    ConnectionMaintenance databaseDatabase name
    ConnectionPasswordDatabase password
    DB connection client program input items
  3. Click the database name created on pgAdmin to connect.
    • You can try simple queries after connecting.

5 - Using Extensions

PostgreSQL(DBaaS) Extension usage

Note
The list of extensions included in each version of PostgreSQL can be found on the PostgreSQL official page.

The list of extensions that can be installed in the current database can be checked with the following SQL statement.

SQL> select * from pg_available_extensions;

PostgreSQL(DBaaS) has the following additional installation items outside of the default extension by version:

Extension namedescription
pgauditprovides detailed audit logging functionality at the session and object level
pg_crona scheduler that allows job scheduling with cron syntax within the database
pg_hint_planProvides a feature to apply hint clauses to SQL execution plans
pgvectorVector data type and similarity search, etc. AI vector operation function provided
postgisGIS (Geographic Information System) provides spatial object storage and spatial query functionality
Table. PostgreSQL(DBaaS) Extension Additional Installation Items

In addition to the above items, if additional Extension installation is required, please refer to Support Center > 문의하기 and inquire.

  • Once the inquiry is received, we will proceed with the installation after review. Please note that some Extensions may not work normally during Replica configuration and recovery.