We provide data storage services that enhance reliability and efficiency through various storage configurations.
This is the multi-page printable view of this section. Click here to print.
Storage
- 1: Block Storage(BM)
- 1.1: Overview
- 1.1.1: Monitoring Metrics
- 1.2: How-to Guides
- 1.2.1: Connect to Server
- 1.2.2: Use Snapshot
- 1.2.3: Use Replication
- 1.2.4: Use Volume Group
- 1.3: API Reference
- 1.4: CLI Reference
- 1.5: Release Note
- 2: File Storage
- 2.1: Overview
- 2.1.1: Monitoring Metrics
- 2.1.2: ServiceWatch Metrics
- 2.2: How-to guides
- 2.2.1: Connect to Server
- 2.2.2: Use Snapshot
- 2.2.3: File-level Recovery
- 2.2.4: Use Disk Backup
- 2.2.5: Use Replication
- 2.3: API Reference
- 2.4: CLI Reference
- 2.5: Release Note
- 3: Object Storage
- 3.1: Overview
- 3.1.1: Amazon S3 Usage Guide
- 3.1.2: Monitoring Metrics
- 3.1.3: ServiceWatch Metrics
- 3.2: How-to guides
- 3.2.1: Access Control
- 3.2.2: File and Folder Management
- 3.2.3: Version Management
- 3.2.4: Permission Management
- 3.2.5: Replication Policy Management
- 3.3: Release Note
- 4: Archive Storage
- 4.1: Overview
- 4.1.1: ServiceWatch Metrics
- 4.2: How-to guides
- 4.2.1: Manage Archiving Policy
- 4.2.2: Use Version Management
- 4.2.3: Archive Recovery
- 4.3: API Reference
- 4.4: CLI Reference
- 4.5: Release Note
- 5: Backup
- 5.1: Overview
- 5.2: How-to guides
- 5.2.1: Instant Backup
- 5.2.2: Recovery
- 5.2.3: Use Backup Agent
- 5.2.4: Install Backup Agent
- 5.2.5: Use Replication
- 5.3: API Reference
- 5.4: CLI Reference
- 5.5: Release Note
- 6: Parallel File Storage
- 6.1: Overview
- 6.2: How-to guides
- 6.2.1: Use Snapshot
- 6.2.2: Install Agent
- 6.2.3: File-level Recovery
- 6.3: API Reference
- 6.4: CLI Reference
- 6.5: Release Note
1 - Block Storage(BM)
1.1 - Overview
Service Overview
Block Storage is a high-performance storage that stores data in block units arranged in a fixed size and order.
Suitable for large-scale, high-performance requirements such as databases and mail servers, and users can directly allocate volumes on the server for use.
Features
- Large volume provision: You can create volumes up to 16 TB in size.
- Full SSD-based high performance: Provides high durability and availability based on redundant controllers and Disk Array RAID. Since a Full SSD disk is provided by default, it is suitable for high-speed data processing tasks such as database workloads.
- Snapshot Backup: Data that has been modified or deleted can be recovered using the image snapshot feature. The user selects a snapshot created at the desired point in time from the list and performs the recovery.
- Replication: Creates an identical replica volume at a different location, and users can set the data replication schedule. If the original volume becomes unavailable due to failures or disasters, services can be provided through the replica volume.
Configuration diagram
Provided features
Block Storage provides the following features.
- Volume Name: Users can set or edit the name for each volume.
- Capacity: Volumes can be created with capacities ranging from a minimum of 1 GB up to a maximum of 16 TB.
- Connection Server : You can select Bare Metal Server or Multi Node GPU Cluster to connect or disconnect.
- Multi-Server Connection (Multi Attach): Supports up to 5 server connections, with no limit on the number of volumes that can be attached to a Bare Metal Server.
- Encryption: All volumes are encrypted with the AES-256 algorithm by default, regardless of disk type.
- Snapshot: Using the image snapshot feature, you can create a snapshot at a specific point in time or generate snapshots at regular intervals.
- Capacity: the capacity of the snapshot storage space
- Schedule: Snapshot auto-creation interval
- Recovery: Recover the original volume to the latest snapshot, or select a snapshot at a specific point in time to create a recovery volume
- Recovery copy a separate volume created with the same capacity as the original (additional cost incurred)
- Replication: It replicates the volume to another location, and the user can set the replication schedule.
- A replicated volume can also serve as the primary using the snapshot feature in the event of a disaster.
- Volume Group: Set up to 16 Block Storage volumes as a group. Snapshots and replication can be configured at the group level.
- Monitoring: You can view monitoring information such as IOPS, latency, and throughput through the Cloud Monitoring service.
Component
You can create a volume by entering the size and selecting the disk type according to the user’s service scale and performance requirements.
When using the snapshot feature, you can restore data to the desired point in time.
Volume
A volume (Volume) is the basic creation unit of the Block Storage service and is used as data storage space. Users create a volume by setting the name, capacity, disk type, snapshot, etc., and then connect it to a Bare Metal Server for use.
The volume name generation rules are as follows.
- It must start with an English letter and can be set using English letters, numbers, and special characters (
-) within 3 to 28 characters.
Snapshot
Snapshot is an image backup of a volume at a specific point in time. Users can view the snapshot name and creation time in the snapshot list to select the snapshot they want to restore, and can recover data that was modified or deleted using that snapshot.
The following are considerations when using snapshots.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00).
- Snapshots can be created up to a maximum of 1,023. (Automatic creation via schedule is limited to a maximum of 128.)
- Automatic creation is possible through snapshot schedule configuration.
- Because snapshot capacity is added to Block Storage (BM) charges, adjust the size of your snapshot storage.
Volume Group
A Volume Group is a group-level management feature that allows users who configure databases and applications across two or more volumes to create consistent-point snapshots and replications. Users can create a Volume Group by selecting a name and a target Block Storage.
Preceding Service
This is a list of services that must be pre-configured before creating the service. For details, refer to the guide provided for each service and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Compute | Bare Metal Server | High-performance physical server used without virtualization |
1.1.1 - Monitoring Metrics
According to Samsung Cloud Platform’s policy, the Cloud Monitoring service is scheduled to be discontinued.
Accordingly, Starting after the September 2026 release, monitoring of Samsung Cloud Platform resources via Cloud Monitoring will no longer be possible.
With the new alternative service, you can continuously perform resource monitoring by using ServiceWatch, released in October 2025.
ServiceWatch provides more modern and powerful features, replacing Cloud Monitoring to deliver a smooth monitoring environment.
Block Storage is planned to be integrated with ServiceWatch from after the July 2026 release.
Detailed information about ServiceWatch can be found in the ServiceWatch Overview.
Block Storage BM Monitoring Metrics
The table below shows the monitoring metrics for Block Storage BM that can be viewed through Cloud Monitoring. For detailed usage of Cloud Monitoring, refer to the Cloud Monitoring guide.
| Performance Item Name | Explanation | unit |
|---|---|---|
| Instance Status | Block Storage volume status | status |
| Volume Total | Total byte count | bytes |
| IOPS [Total] | iops(total) | iops |
| IOPS [Read] | iops(read) | iops |
| IOPS [Write] | iops(write) | iops |
| IOPS [Other] | iops(other) | iops |
| Latency Time [Total] | Total latency | usec |
| Latency Time [Read] | Read latency | usec |
| Latency Time [write] | Latency (write) | usec |
| Latency Time [Other] | Latency (Other) | usec |
| Throughput [Total] | Throughput (total) | bytes/s |
| Throughput [Read] | Throughput (read) | bytes/s |
| Throughput [Write] | Throughput (write) | bytes/s |
| Throughput [Other] | Throughput (Other) | bytes/s |
1.2 - How-to Guides
Users can create the service by entering the required information for Block Storage (BM) and selecting detailed options through the Samsung Cloud Platform Console.
Block Storage(BM) Create
You can create and use the Block Storage (BM) service in the Samsung Cloud Platform Console.
To create Block Storage (BM), follow the steps below.
Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
Click the Block Storage(BM) Create button on the Service Home page. You will be taken to the Block Storage(BM) Create page.
Block Storage(BM) Creation page, input the information needed to create the service, and choose detailed options.
Category Required statusDetailed description Volume name Required Volume name - must start with an English letter and be 3~28 characters using English letters, numbers, and special characters (
-)
- cannot be modified after service creation
Disk type Required Select Disk Type - SSD: High-performance general volume
- HDD: General volume
- Cannot be modified after service creation
capacity Required Capacity setting - Enter a number between 1~16,384 GB
- Cannot be modified after service creation
Max IOPS Required Enter IOPS value - Enter a number between 5,000~20,000
- HDD type does not provide performance metric setting function
Max Throughput Required Enter the throughput speed (MB/s) - Enter a number between 250~1,000
- HDD type does not provide performance metric configuration functionality
Connection server Required Connect Bare Metal Server selection - Provides up to 8 Bare Metal Server connections
- No limit on the number of volumes that can be attached to a Bare Metal Server
Table. Block Storage (BM) Service Information Input Items- must start with an English letter and be 3~28 characters using English letters, numbers, and special characters (
Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
- Once creation is complete, check the created resources on the Block Storage(BM) List page.
- Regardless of disk type, all volumes have server-side encryption based on the AES-256 algorithm applied by default.
- The snapshot schedule can be set on the detail page.
- The performance metrics (IOPS, Throughput) of the configured storage are based on maximum values and do not guarantee consistent values.
Configure iSCSI
Volumes created by the user in addition to the OS’s default volume must be configured with iSCSI.
After checking the IP provided in the iSCSI Information on the Block Storage(BM) Details page, follow the iSCSI configuration steps for each OS.
Linux operating system
The iSCSI information (Storage Target IP) was written assuming 10.40.40.41, 10.40.40.42.
- Check the iSCSI information on the Block Storage (BM) detail page.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to be used on the connected server. You will be taken to the Block Storage(BM) Details page.
- Connection Server item, verify the server and then connect.
- Proceed with iSCSI configuration by referring to the steps below.
- Discover the connection information for the Storage (target IP).Color mode
[root@localhost ~]# iscsiadm -m discovery -t st -p 10.40.40.41 10.40.40.41:3260,1024 iqn.2000-05.com.3pardata:20210002ac026169 [root@localhost ~]# iscsiadm -m discovery -t st -p 10.40.40.42 10.40.40.42:3260,1025 iqn.2000-05.com.3pardata:20220002ac026169[root@localhost ~]# iscsiadm -m discovery -t st -p 10.40.40.41 10.40.40.41:3260,1024 iqn.2000-05.com.3pardata:20210002ac026169 [root@localhost ~]# iscsiadm -m discovery -t st -p 10.40.40.42 10.40.40.42:3260,1025 iqn.2000-05.com.3pardata:20220002ac026169code block. Storage (target IP) connection information Discovery - Connect to the storage (target IP). If it is already connected, proceed to the next step.Color mode
[root@localhost ~]# iscsiadm -m node -p 10.40.40.41:3260 --login Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] (multiple) Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] (multiple) Login to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] successful. Login to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] successful [root@localhost ~]# iscsiadm -m node -p 10.40.40.42:3260 --login Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] (multiple) Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] (multiple) Login to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] successful. Login to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] successful.[root@localhost ~]# iscsiadm -m node -p 10.40.40.41:3260 --login Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] (multiple) Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] (multiple) Login to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] successful. Login to [iface: default, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] successful [root@localhost ~]# iscsiadm -m node -p 10.40.40.42:3260 --login Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] (multiple) Logging in to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] (multiple) Login to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] successful. Login to [iface: default, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] successful.Code block. Storage (target IP) connection - To minimize search time, delete all unused Storage (target IP).Color mode
[root@localhost ~]# iscsiadm -m node show 100.100.100.10:3260,1026 iqn.1992-08.com.netapp:sn.c9adbd09cf301d039ea2bc878:vs.3 10.40.40.41:3260,1024 iqn.2000-05.com.3pardata:20210002ac026169 10.40.40.42:3260,1025 iqn.2000-05.com.3pardata:20220002ac026169 [root@localhost ~]# iscsiadm -m node -o delete -p 100.100.100.10:3260[root@localhost ~]# iscsiadm -m node show 100.100.100.10:3260,1026 iqn.1992-08.com.netapp:sn.c9adbd09cf301d039ea2bc878:vs.3 10.40.40.41:3260,1024 iqn.2000-05.com.3pardata:20210002ac026169 10.40.40.42:3260,1025 iqn.2000-05.com.3pardata:20220002ac026169 [root@localhost ~]# iscsiadm -m node -o delete -p 100.100.100.10:3260Code block. Delete unused Storage (target IP) - Please rescan to verify the additional disk.Color mode
[root@localhost ~]# iscsiadm -m session --rescan Rescanning session [sid: 65, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] Rescanning session [sid: 66, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] Rescanning session [sid: 67, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] Rescanning session [sid: 68, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260][root@localhost ~]# iscsiadm -m session --rescan Rescanning session [sid: 65, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] Rescanning session [sid: 66, target: iqn.2000-05.com.3pardata:20210002ac026169, portal: 10.40.40.41,3260] Rescanning session [sid: 67, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260] Rescanning session [sid: 68, target: iqn.2000-05.com.3pardata:20220002ac026169, portal: 10.40.40.42,3260]code block. Rescan - Configure Auto Login to log in automatically even after a reboot.Color mode
[root@localhost ~]# iscsiadm -m node --op=update -n node.conn[0].startup -v automatic [root@localhost ~]# iscsiadm -m node --op=update -n node.startup -v automatic[root@localhost ~]# iscsiadm -m node --op=update -n node.conn[0].startup -v automatic [root@localhost ~]# iscsiadm -m node --op=update -n node.startup -v automaticCode block. Auto Login setting - Verify the configuration using the following command.Color mode
[root@localhost ~]# lsblk[root@localhost ~]# lsblkCode block. Verify configuration.
- Discover the connection information for the Storage (target IP).
Windows operating system
The iSCSI information (Storage Target IP) was assumed to be 10.40.40.41, 10.40.40.42.
- Check the iSCSI information on the Block Storage (BM) detail page.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to be used on the connected server. You will be taken to the Block Storage(BM) Details page.
- After checking the server in the Connection Server item, connect.
- Proceed with iSCSI configuration by referring to the steps below.
- Open Command Prompt (Admin) and run powershell.Color mode
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. PS C:\Users> cd .. PS C:\>Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. PS C:\Users> cd .. PS C:\>Code block. powershell execution - Start the volume service.Color mode
PS C:\> Set-Service -Name MSiSCSI -StartupType Automatic PS C:\> Start-Service -Name MSiSCSI PS C:\> get-service -Name MSiSCSI | select -Property Name, DisplayName, Status, StartType Name DisplayName Status StartType ------- -------------- ------- ----------- MSiSCSI Microsoft iSCSI Initiator Service Running AutomaticPS C:\> Set-Service -Name MSiSCSI -StartupType Automatic PS C:\> Start-Service -Name MSiSCSI PS C:\> get-service -Name MSiSCSI | select -Property Name, DisplayName, Status, StartType Name DisplayName Status StartType ------- -------------- ------- ----------- MSiSCSI Microsoft iSCSI Initiator Service Running AutomaticCode block. Start volume service - Install Multipath I/O. If the Restart Needed item is displayed as Yes, a restart is required.Color mode
PS C:\> Install-WindowsFeature -name Multipath-IO Success Restart Needed Exit Code Feature Result ------- -------------- --------- ----------------- True No Success {Multipath I/O}PS C:\> Install-WindowsFeature -name Multipath-IO Success Restart Needed Exit Code Feature Result ------- -------------- --------- ----------------- True No Success {Multipath I/O}code block. Multipath I/O installation - Modify the Initiator Port Address.
If you are not an Active Directory member, skip this procedure. The Initiator Port Address only needs to be modified when you are an Active Directory member.- iqn is generated based on the hostname, but when joined to Active Directory, it is changed to DNS format.
Since it is registered in Storage based on the default hostname, for iqn.1991-05.com.microsoft:iqn01.scp.com, iqn01 is the hostname. Remove the DNS information and change it to the name registered when creating the OS in the user Console, such as iqn.1991-05.com.microsoft:iqn01. - If you are not an AD member, no changes are required.Color mode
PS C:\> $address = (Get-InitiatorPort | select NodeAddress) PS C:\> echo $address NodeAddress ----------- iqn.1991-05.com.microsoft:iqn01.scp.com PS C:\> Set-InitiatorPort -NodeAddress $address.NodeAddress -NewNodeAddress "iqn.1991-05.com.microsoft:iqn01" PS C:\> Get-InitiatorPort | select NodeAddress NodeAddress ----------- iqn.1991-05.com.microsoft:iqn01PS C:\> $address = (Get-InitiatorPort | select NodeAddress) PS C:\> echo $address NodeAddress ----------- iqn.1991-05.com.microsoft:iqn01.scp.com PS C:\> Set-InitiatorPort -NodeAddress $address.NodeAddress -NewNodeAddress "iqn.1991-05.com.microsoft:iqn01" PS C:\> Get-InitiatorPort | select NodeAddress NodeAddress ----------- iqn.1991-05.com.microsoft:iqn01Code block. Modify Initiator Port Address
- iqn is generated based on the hostname, but when joined to Active Directory, it is changed to DNS format.
- Set the Storage (target Portal) address as a variable.Color mode
PS C:\> $TargetPortalAddresses = @("10.40.40.41", "10.40.40.42")PS C:\> $TargetPortalAddresses = @("10.40.40.41", "10.40.40.42")Code block. Set the Storage (target Portal) address as a variable. - Discover Storage (target Portal).Color mode
PS C:\> Foreach ($TargetPortalAddress in $TargetPortalAddresses){ New-IscsiTargetPortal -TargetPortalAddress $TargetPortalAddress } InitiatorInstanceName : InitiatorPortalAddress : IsDataDigest : False IsHeaderDigest : False TargetPortalAddress : 10.40.40.41 TargetPortalPortNumber : 3260 PSComputerName : InitiatorInstanceName : InitiatorPortalAddress : IsDataDigest : False IsHeaderDigest : False TargetPortalAddress : 10.40.40.42 TargetPortalPortNumber : 3260 PSComputerName :PS C:\> Foreach ($TargetPortalAddress in $TargetPortalAddresses){ New-IscsiTargetPortal -TargetPortalAddress $TargetPortalAddress } InitiatorInstanceName : InitiatorPortalAddress : IsDataDigest : False IsHeaderDigest : False TargetPortalAddress : 10.40.40.41 TargetPortalPortNumber : 3260 PSComputerName : InitiatorInstanceName : InitiatorPortalAddress : IsDataDigest : False IsHeaderDigest : False TargetPortalAddress : 10.40.40.42 TargetPortalPortNumber : 3260 PSComputerName :code block. Storage (target Portal) Discovery - Connect the disk (target).Color mode
PS C:\> Foreach ($TargetPortalAddress in $TargetPortalAddresses){ Get-IscsiTarget | Connect-IscsiTarget -IsMultipathEnabled $true -IsPersistent $true -TargetPortalAddress $TargetPortalAddress } AuthenticationType : NONE InitiatorInstanceName : ROOT\ISCSIPRT\0000_0 InitiatorNodeAddress : iqn.1991-05.com.microsoft:iqn01 InitiatorPortalAddress : 0.0.0.0 InitiatorSideIdentifier : 400001370000 IsConnected : True IsDataDigest : False IsDiscovered : True IsHeaderDigest : False IsPersistent : True NumberOfConnections : 1 SessionIdentifier : ffffcd0b7ba58010-4000013700000006 TargetNodeAddress : iqn.1992-08.com.netapp:sn.f807925eeae311ec9270d039ea38b250:vs.3 TargetSideIdentifier : 1100 PSComputerName : AuthenticationType : NONE InitiatorInstanceName : ROOT\ISCSIPRT\0000_0 InitiatorNodeAddress : iqn.1991-05.com.microsoft:iqn01 InitiatorPortalAddress : 0.0.0.0 InitiatorSideIdentifier : 400001370002 IsConnected : True IsDataDigest : False IsDiscovered : True IsHeaderDigest : False IsPersistent : True NumberOfConnections : 1 SessionIdentifier : ffffcd0b7ba58010-4000013700000007 TargetNodeAddress : iqn.1992-08.com.netapp:sn.f807925eeae311ec9270d039ea38b250:vs.3 TargetSideIdentifier : 1000 PSComputerName :IsHeaderDigest : False TargetPortalAddress : 10.40.40.42 TargetPortalPortNumber : 3260 PSComputerName :PS C:\> Foreach ($TargetPortalAddress in $TargetPortalAddresses){ Get-IscsiTarget | Connect-IscsiTarget -IsMultipathEnabled $true -IsPersistent $true -TargetPortalAddress $TargetPortalAddress } AuthenticationType : NONE InitiatorInstanceName : ROOT\ISCSIPRT\0000_0 InitiatorNodeAddress : iqn.1991-05.com.microsoft:iqn01 InitiatorPortalAddress : 0.0.0.0 InitiatorSideIdentifier : 400001370000 IsConnected : True IsDataDigest : False IsDiscovered : True IsHeaderDigest : False IsPersistent : True NumberOfConnections : 1 SessionIdentifier : ffffcd0b7ba58010-4000013700000006 TargetNodeAddress : iqn.1992-08.com.netapp:sn.f807925eeae311ec9270d039ea38b250:vs.3 TargetSideIdentifier : 1100 PSComputerName : AuthenticationType : NONE InitiatorInstanceName : ROOT\ISCSIPRT\0000_0 InitiatorNodeAddress : iqn.1991-05.com.microsoft:iqn01 InitiatorPortalAddress : 0.0.0.0 InitiatorSideIdentifier : 400001370002 IsConnected : True IsDataDigest : False IsDiscovered : True IsHeaderDigest : False IsPersistent : True NumberOfConnections : 1 SessionIdentifier : ffffcd0b7ba58010-4000013700000007 TargetNodeAddress : iqn.1992-08.com.netapp:sn.f807925eeae311ec9270d039ea38b250:vs.3 TargetSideIdentifier : 1000 PSComputerName :IsHeaderDigest : False TargetPortalAddress : 10.40.40.42 TargetPortalPortNumber : 3260 PSComputerName :code block. Disk (target) connection - Refresh the storage (target) information.Color mode
PS C:\> Update-IscsiTargetPS C:\> Update-IscsiTargetCode block. Storage (target) information Refresh - Register the Multipath I/O DSM and create an MPIO Disk.
When creating an MPIO disk, a prompt appears if a reboot is required. Press Y or the Enter key to reboot.Color modePS C:\> New-MSDSMSupportedHW -VendorId MSFT2005 -ProductId iSCSIBusType_0x9 PS C:\> Update-MPIOClaimedHW Confirm Are you sure you want to perform this action? The operation may require a system restart. [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): FalsePS C:\> New-MSDSMSupportedHW -VendorId MSFT2005 -ProductId iSCSIBusType_0x9 PS C:\> Update-MPIOClaimedHW Confirm Are you sure you want to perform this action? The operation may require a system restart. [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Falsecode block. Multipath I/O DSM registration, MPIO Disk creation - Check the list and path of Multipath I/O disks.
You can check MPIO disk information using the mpclaim.exe command. Enter the generated MPIO disk number to view the disk path and status.Color modePS C:\> mpclaim.exe -s -d For more information about a particular disk, use 'mpclaim -s -d #' where # is the MPIO disk number. MPIO Disk System Disk LB Policy DSM Name ------------------------------------------------------------------------------- MPIO Disk3 Disk 1 RR Microsoft DSM PS C:\> mpclaim.exe -s -d 3 MPIO Disk3: 02 Paths, Round Robin, Symmetric Access Controlling DSM: Microsoft DSM SN: 600A098038314853475D543544614131 Supported Load Balance Policies: FOO RR RRWS LQD WP LB Path ID State SCSI Address Weight --------------------------------------------------------------------------- 0000000077040001 Active/Optimized 004|000|001|000 0 TPG_State : Active/Optimized , TPG_Id: 1000, : 25 0000000077040000 Active/Optimized 004|000|000|000 0 TPG_State : Active/Optimized , TPG_Id: 1001, : 26PS C:\> mpclaim.exe -s -d For more information about a particular disk, use 'mpclaim -s -d #' where # is the MPIO disk number. MPIO Disk System Disk LB Policy DSM Name ------------------------------------------------------------------------------- MPIO Disk3 Disk 1 RR Microsoft DSM PS C:\> mpclaim.exe -s -d 3 MPIO Disk3: 02 Paths, Round Robin, Symmetric Access Controlling DSM: Microsoft DSM SN: 600A098038314853475D543544614131 Supported Load Balance Policies: FOO RR RRWS LQD WP LB Path ID State SCSI Address Weight --------------------------------------------------------------------------- 0000000077040001 Active/Optimized 004|000|001|000 0 TPG_State : Active/Optimized , TPG_Id: 1000, : 25 0000000077040000 Active/Optimized 004|000|000|000 0 TPG_State : Active/Optimized , TPG_Id: 1001, : 26Code block. Check Multipath I/O Disk list and path - Check in Disk Management.
- Open Command Prompt (Admin) and run powershell.
View detailed information of Block Storage (BM)
Block Storage(BM) service allows you to view and edit the full resource list and detailed information. Block Storage(BM) Details page consists of Details, Snapshot List, Replication, Operation History tabs.
To view detailed information about the Block Storage(BM) service, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to view detailed information. You will be taken to the Block Storage(BM) Details page.
- Block Storage(BM) Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Tags, Operation History tabs.
Category Detailed description Volume status Volume status - Creating: In progress
- Available: Creation completed, server connection possible
- Attaching: Connecting to server
- Detaching: Disconnecting from server
- In Use: Server connection established
- Deleting: Service termination in progress
- Editing: Changing settings
- Error Deleting: Abnormal state while deleting
- Error: Abnormal state while creating
Clone creation Create a replica in a different location - For more information on creating a replica, see Creating a Replica
Create snapshot Create a snapshot at a specific point in time - For detailed information on creating snapshots, refer to Creating a Snapshot
Service termination Cancel service button Table. Status information and additional features
- Block Storage(BM) Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Tags, Operation History tabs.
Detailed information
Block Storage(BM) List page lets you view detailed information of the selected resource and, if necessary, edit the information.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource Name | Resource name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation Date/Time | Service creation timestamp |
| Editor | User who modified the service |
| Modification date | Date and time the service was modified |
| Volume name | Volume Name
|
| Category | Distinguish original status regarding duplication |
| Storage volume name | Volume name within the storage device
|
| capacity | Volume size
|
| Max IOPS | The IOPS value set when creating the service
|
| Max Throughput | Throughput speed (MB/s) set when creating the service
|
| Disk type | Disk type |
| Encryption | Encryption status
|
| Volume Group | Name of the Volume Group the volume belongs to |
| iSCSI information | Storage Target IP information for server connection |
| Snapshot capacity | Snapshot storage capacity
|
| Snapshot schedule | Snapshot auto-creation interval
|
| Recovery copy | Snapshot name
|
| Connection server | Connected Bare Metal Server
|
Snapshot list
Block Storage(BM) List page lets you view the snapshot of the selected resource.
| Category | Detailed description |
|---|---|
| Snapshot usage | Total size of stored snapshots |
| Snapshot name | Snapshot name |
| capacity | Snapshot capacity |
| Creation Date/Time | Snapshot creation time |
| Additional features > More | Snapshot management button
|
| Delete | Select the snapshots to delete from the snapshot list and delete them all at once. |
- If the maximum number of snapshots or the snapshot space threshold (around 90%) is exceeded, older snapshots are deleted first.
- If the snapshot capacity usage is high (around 90%), replication may be stopped.
- Snapshots can be created up to a maximum of 1,023 (with up to 128 automatically created via schedule), and if the maximum number is exceeded, no further snapshots can be created.
- Snapshot recovery must be performed while all connected servers are disconnected (Umount, Disk Offline), and the restored volume can be used after it is reconnected (Mount, Disk Online).
- A recovery copy can only be created once, and it is a separate volume that incurs charges identical to the original.
- The snapshot creation date and time is based on Asia/Seoul (GMT +09:00).
- When using replication, snapmirror files cannot be deleted.
- When using a Volume Group, set the snapshot schedule on the Volume Group (BM) detail information screen. The created snapshots can be viewed in the Block Storage (BM) snapshot list.
Clone
Block Storage(BM) List page lets you view the replication information of the selected resource.
| Category | Detailed description |
|---|---|
| Replication Policy | User-configured replication policy
|
| Replication cycle | Replication interval of the source set by the user
|
| Replication status | Replication progress status according to policy settings |
| Lag Time | Time elapsed since the last successful replication
|
| Volume information | Volume information for original and replica
|
- When a replica is created, a copy with the same disk type is generated.
- Replication can be created after configuring the snapshot size.
- If you are using a Volume Group, check the replication information on the Volume Group(BM) list page.
- A replica can modify the connected server when the replication policy is stopped or deleted.
- A replica can use the snapshot feature after the replication policy is deleted.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and schedule in the replica.
tag
On the Block Storage(BM) List page, you can view the tag information of the selected resource and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
Block Storage(BM) List page allows you to view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Block Storage(BM) Managing Resources
If you need to modify the settings of a created Block Storage (BM) or add or remove connected servers, you can perform the tasks on the Block Storage(BM) Details page.
Edit volume name
You can modify the name of a volume. To rename a volume, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource whose volume name you want to edit. You will be taken to the Block Storage(BM) Details page.
- Click the Edit button for Volume name. The Edit Volume Name popup opens.
- Enter the volume name and click the Confirm button.
-) within 3 to 28 characters.Increase capacity
You can increase the volume size. To increase the size, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to expand its capacity. You will be taken to the Block Storage(BM) Details page.
- Click the capacity edit button. The Capacity Edit popup opens.
- After adding the capacity you want to expand (1/~16,384 GB) to the current capacity and entering the total, click the Confirm button.
- Capacity can be expanded only for the original volume that does not use the snapshot feature.
- Size reduction is not provided.
Modify Snapshot Size
You can modify the capacity of the snapshot storage. To modify the snapshot capacity, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Block Storage(BM) List page: click the resource to modify the snapshot capacity. You will be taken to the Block Storage(BM) Details page.
- Click the Edit button of the Snapshot Capacity item. The Snapshot Capacity Edit popup window opens.
- Set the Use status and generation capacity (%), then click the Confirm button.
- Generation Capacity(%) can be selected in increments of 50 between 100 and ~500.
- Charges vary depending on snapshot usage and size. (Example: with a volume size of 10 GB and snapshot creation size of 100%, a total of 20 GB is billed.)
- If the maximum number of snapshots or the snapshot space threshold (around 90%) is exceeded, older snapshots are deleted first.
- If the size after modification is smaller than the original, older snapshots will be deleted first.
- When changed to unused, all snapshots will be deleted.
- Replication can be created after setting the snapshot capacity.
- After configuring the snapshot size, it can be added to the Volume Group.
- If the snapshot capacity usage is high (around 90%), replication may be stopped.
- Replicas can use the snapshot feature after the replication policy has been deleted.
Edit Snapshot Schedule
You can modify the automatic snapshot creation interval. To modify the snapshot schedule, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to edit the snapshot schedule. You will be taken to the Block Storage(BM) Details page.
- Click the Edit button for the Snapshot Schedule item. The Snapshot Schedule Edit popup opens.
- Set the snapshot auto creation status and creation interval, then click the Confirm button.
- If you want to automatically create snapshots based on the creation cycle, select automatic creation as enabled.
- Select the generation cycle as daily, hourly, or as weekly, day of week, hourly.
- The snapshot schedule is based on Asia/Seoul (GMT +09:00).
- You can register a schedule after configuring the snapshot capacity.
- You cannot add it to a Volume Group when configuring a snapshot schedule.
Edit Max IOPS
You can modify the Max IOPS value. To modify the Max IOPS value, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Block Storage(BM) List page, click the resource whose IOPS value you want to modify. You will be taken to the Block Storage(BM) Details page.
- Click the Edit button of Max IOPS. The Max IOPS Edit popup opens.
- After entering the Max IOPS value to change, click the Confirm button.
- The Max IOPS value can be set to a value between 5,000 and 20,000.
- The Max IOPS value can be modified after the server is initially attached.
- For a recovery copy, the Max IOPS value cannot be modified.
Edit Max Throughput
You can modify the Max Throughput speed. To modify the Max Throughput speed, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- From the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Block Storage(BM) List on the page, click the resource to modify the Throughput speed. You will be taken to the Block Storage(BM) Details page.
- Click the Edit button of Max Throughput. The Max Throughput Edit popup opens.
- After entering the Max Throughput speed to change, click the Confirm button.
- The Max Throughput speed can be set to a value between 250 and 1,000.
- The Max Throughput speed can be modified after the initial server attach.
- For recovery copies, the Max Throughput speed cannot be adjusted.
Edit Connection Server
You can connect or disconnect the Bare Metal Server, Multi Node GPU Cluster. To modify the connected server, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to edit the connected server. You will be taken to the Block Storage(BM) Details page.
- When adding a connection server, click the Add button in the Connection Server item. The Add Connection Server popup opens.
- After selecting the server you want to connect to, click the Confirm button.
- If you need to disconnect the server, click the Disconnect button in the Connection Server field.
- Be sure to log into the server, perform the disconnect operations (Umount, Disk Offline), and then disconnect.
- Connect to the server and be sure to perform the disconnect operations (Umount, Disk Offline) before detaching the connected server. Detaching without OS operations may cause a status error (Hang) on the connected server. For detailed information on detaching the server, refer to Detaching the Server.
- You can connect up to eight Bare Metal Servers created in the same location as the Block Storage.
- There is no limit on the number of volume connections for a Bare Metal Server.
- When adding a connected server, you can use it after performing the connection tasks (Mount, Disk Online) on the server. For detailed information about server connections, refer to Server Connection Guide.
- Connect to the server and be sure to perform the disconnect operations (Umount, Disk Offline) before detaching the connected server. Detaching without OS operations may cause a status error (Hang) on the connected server. For detailed information on detaching the server, refer to Detach Server.
- A replica can modify the connected server when the replication policy is stopped or deleted.
Cancel Block Storage(BM)
You can reduce operating costs by terminating unused Block Storage(BM). However, terminating the service may cause the running service to stop immediately, so you should carefully consider the impact of service interruption before proceeding with the termination.
- Please note that data cannot be recovered after termination.
- If a connected server exists, you can terminate it after removing all associated resources.
- You can only delete the volume when it is in the Available or Error state.
- If a replication policy is in use, you can cancel it after removing the policy from the associated replica.
- If a Volume Group is being used, you can cancel after disconnecting the associated Volume Group.
- If a recovery copy of the original exists, you can delete the recovery copy before terminating.
To cancel Block Storage, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. Navigate to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, select the resource to terminate and click the Terminate Service button.
- After termination is complete, verify on the Block Storage(BM) List page that the resource has been terminated.
1.2.1 - Connect to Server
When using a volume on the server, a connect or disconnect operation is required.
On the Block Storage(BM) Details page, after adding a connected server, log in to the server to configure Multi Path and perform connection tasks (Mount, Disk Online). After use, perform disconnection tasks (Umount, Disk Offline) and remove the connected server.
Configure Multi Path
Before using the volume on the connected server, Multi Path configuration is required. Follow the steps below.
Linux operating system
Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
On the Block Storage(BM) List page, click the resource to configure Multi Path. You will be taken to the Block Storage(BM) Details page.
In the Connection Server item, verify the server and then connect. Configure Multi Path according to the guide below.
Device Check
- The created volume can be verified with the
fdisk -lcommand.
- The created volume can be verified with the
Verify DM-Multipath configuration
- In the volume detection process, the Linux system automatically applies Multi Path, which can be verified with the
multipath –llcommand. - Volumes with Multi Path applied use Multipath device names such as
/dev/mapper/#####instead of the/dev/sd#format, and can be verified with thefdisk –lcommand.
- In the volume detection process, the Linux system automatically applies Multi Path, which can be verified with the
iSCSI replacement timeout value setting
- When connecting iSCSI, set the
replacement timeout.
# vi /etc/iscsi/iscsid.conf node.session.timeo.replacement_timeout = 5 (default 120 값을 5 로 변경)- After modifying the above, restart the iscsi service.
# systemctl restart iscsid- When connecting iSCSI, set the
Windows operating system
Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
On the Block Storage(BM) List page, click the resource to set Multi Path. You will be taken to the Block Storage(BM) Details page.
In the Connection Server item, verify the server and then connect. Configure Multi Path according to the guide below.
Device Check
- Click the Start > Server Manager menu to launch Server Manager.
- When you click the Server Manager > File and Storage Services > Volumes > Disks menu, you can view the iscsi device.
- Since Multi-Path is not yet configured, a single device appears as multiple devices for each path.
Install MPIO (Reboot required)
Click Server Manager > DashBoard > Add roles and features.
Add Roles and Features Wizard When the popup window opens, click the Next button.
On the Select installation type page, select Role-based or feature-based installation, and click the Next button.
Select destination server(Server selection) On the page, the current server is automatically detected. Verify the information and click the Next button.
Select features(Feature selection) page, select Features from the left menu, check Multipath I/O, then click the Next button.
Confirm installation selections(Confirm installation selections) on the page, after checking Restart the destination server automatically if required, when the popup appears, click Yes and click the Install button.
The installation starts and automatically reboots.
When reconnecting to the server, the installation is already complete. Click the close button to close the wizard popup window.
Click Server Manager > DashBoard > tools > MPIO.
In the Discover Multi-Paths tab, check Add support for iSCSI devices and click the Add button.
- If the message appears, reboot the server.
After the reboot, you can check NETAPP Devices in MPIO devices.
In the Windows Run dialog (Command Prompt), run diskmgmt.msc to open the Disk management popup window.
- You can confirm that MPIO is applied by checking the properties of the volume created in the Block Storage (BM) service.
- You can confirm that MPIO is applied by checking the properties of the volume created in the Block Storage (BM) service.
Connect to Server (Mount, Disk Online)
To use the volume added to the connected server, you must log into the server and perform the connection tasks (Mount, Disk Online). Follow the steps below.
Linux operating system
- Server OS: LINUX
- Mount location: /data
- Volume size: 24 GB
- File system: ext3, ext4, xfs etc
- Additional allocated disk: /dev/vdb
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to which you want to connect the server. You will be taken to the Block Storage(BM) Details page.
- Connected Server item, check the server and then connect. Mount the volume according to the guide below.
- Switch to root privilegesColor mode
$ sudo -i$ sudo -iCode block. Switch to root privileges - Check DiskColor mode
# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 diskCode block. Check disk - Create partitionColor mode
# fdisk /dev/vdb Command (m for help): n Partition type: p primary (0 primary, 0 extended, 4 free) e extended Select (default p): p Partition number (1-4, default 1): 1 First sector (2048-50331646, default 2048): Last sector, +/-sectors or +/-size{K,M,G,T,P} (2048-50331646, default 50331646): Created a new partition 1 of type 'Linux' and of size 24 GiB. Command (m for help): w The partition table has been altered! Calling ioctl() to re-read partition table. Syncing disks.# fdisk /dev/vdb Command (m for help): n Partition type: p primary (0 primary, 0 extended, 4 free) e extended Select (default p): p Partition number (1-4, default 1): 1 First sector (2048-50331646, default 2048): Last sector, +/-sectors or +/-size{K,M,G,T,P} (2048-50331646, default 50331646): Created a new partition 1 of type 'Linux' and of size 24 GiB. Command (m for help): w The partition table has been altered! Calling ioctl() to re-read partition table. Syncing disks.Code block. Create partition - Partition format setting (example: ext4)Color mode
# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part # mkfs.ext4 /dev/vdb1 mke2fs 1.46.5 (30-Dec-2021) Writing superblocks and filesystem accounting information: done# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part # mkfs.ext4 /dev/vdb1 mke2fs 1.46.5 (30-Dec-2021) Writing superblocks and filesystem accounting information: doneCode block. Partition format setting - Volume MountColor mode
# mkdir /data # mount /dev/vdb1 /data # lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part /data # vi /etc/fstab (add) /dev/vdb1 /data ext4 defaults 0 0# mkdir /data # mount /dev/vdb1 /data # lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part /data # vi /etc/fstab (add) /dev/vdb1 /data ext4 defaults 0 0Code block. Volume mount Item Explanation cat /etc/fstab This is the filesystem information file for the Linux system. It is used when the server starts. df -h Check the total disk usage mounted on a Linux system. fdisk -l Check partition information. - Physical disks are displayed as
/dev/sda,/dev/sdb,/dev/sdcwith letters such asa,b,c
- Disk partitions are displayed as
/dev/sda1,/dev/sda2,/dev/sda3with numbers such as1,2,3
Table. Refer to the Mount commandcommand Explanation m Check the usage of the fdisk command. n Create a new partition. p Verify the updated partition information. t Change the system ID of the partition. w Save the partition information and exit the fdisk configuration. Table. Refer to the partition creation command (fdisk). - Physical disks are displayed as
- Switch to root privileges
Windows operating system
Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
On the Block Storage(BM) List page, click the resource to connect the server. You will be taken to the Block Storage(BM) Details page.
From the Connected Server item, verify the server and then connect. Follow the guide below to attach the volume (Disk Online).
- Right-click the Windows Start icon and run Computer Management.
- In the Computer Management tree structure, select Storage > Disk Management.
- Check Disk
- Disk Online
- Disk initialization
- Partition format
- Check volume
Disconnect Server (Umount, Disk Offline)
Connect to the server and perform the disconnect operations (Umount, Disk Offline), then you must disconnect the server from the Console. Follow the steps below.
Linux operating system
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to detach the server connection. You will be taken to the Block Storage(BM) Details page.
- After checking the server in the Connected Server item, connect. Follow the guide below to unmount the volume (Umount).
- Volume UmountColor mode
# umount /dev/vdb1 /data # lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part # vi /etc/fstab (delete) /dev/vdb1 /data ext4 defaults 0 0# umount /dev/vdb1 /data # lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT vda 252:0 0 24G 0 disk ├─vda1 252:1 0 23.9G 0 part [SWAP] └─vda14 252:14 0 4M 0 part / └─vda15 252:15 0 106M 0 part /boot/efi vdb 252:16 0 24G 0 disk └─vdb1 252:17 0 24G 0 part # vi /etc/fstab (delete) /dev/vdb1 /data ext4 defaults 0 0code block. volume Umount
- Volume Umount
Windows operating system
Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
On the Service Home page, click the Block Storage(BM) menu. Navigate to the Block Storage(BM) List page.
On the Block Storage(BM) List page, click the resource to detach the server connection. You will be taken to the Block Storage(BM) Details page.
In the Connected Server item, verify the server before connecting. Follow the guide below to detach the volume (Disk Offline).
- Windows Start icon right-click, then run Computer Management
- In the Computer Management tree structure, select Storage > Disk Management
- Right-click the disk to be removed, then run Offline.
- Check disk status
1.2.2 - Use Snapshot
You can create, delete, or recover a snapshot of a created Block Storage (BM). You can perform these actions on the Block Storage (BM) Details page and the Snapshot List page.
Create Snapshot
Users can create a snapshot at the desired point in time.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Click the resource to create a snapshot on the Block Storage(BM) List page. Navigate to the Block Storage(BM) Details page.
- Check the setting status of the Snapshot Capacity item.
- Snapshots can be created only when storage space has been secured by configuring snapshot capacity.
- For detailed information, refer to Modify Snapshot Capacity.
- Click the Create Snapshot button. The Create Snapshot popup opens.
- Click the Create button. It creates a snapshot of the current point in time.
- Click the Snapshot List page. You will be taken to the Block Storage(BM) Snapshot list page.
- Check the generated snapshot.
- If the maximum number of snapshots or the snapshot space threshold (around 90%) is exceeded, older snapshots are deleted first.
- If the usage rate within the snapshot capacity is high (around 90%), replication may be stopped.
- If there is a volume in the Volume Group with snapshot capacity not set, you cannot create a snapshot. Set the snapshot capacity for all volumes first.
- Snapshots can be created up to a maximum of 1,023 (with up to 128 automatically generated via schedule), and if the maximum number is exceeded, no further snapshots can be created.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00).
- If you want to automatically create snapshots using a schedule, set the snapshot schedule on the Block Storage(BM) Details page.
- For detailed information about the snapshot schedule, refer to Modify Snapshot Schedule.
- Capacity can be expanded only for the original volume that does not use the snapshot feature.
Recover Snapshot
Block Storage(BM) volumes can be restored from a snapshot. To restore a snapshot, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Block Storage(BM) List Click the resource to restore from a snapshot. Block Storage(BM) Details page will be opened.
- If a server has been added in the Connected Server item, connect to the server and then perform the disconnect tasks (Umount, Disk Offline).
- For more details, refer to Disconnect Server.
- Click the Snapshot List page. Navigate to the Block Storage(BM) Snapshot List page.
- After checking the Snapshot name and Creation timestamp, click the More button of the snapshot you want to restore.
- Recover button, click it. The snapshot recovery popup opens.
- After verifying the snapshot name and creation time, click the Confirm button. Recover the Block Storage volume from the snapshot.
- Click the Details button. Navigate to the Block Storage(BM) Details page.
- Connection Server If a server has been added to this item, connect to the server and perform the connection tasks (Mount, Disk Online).
- For detailed information, refer to Connect to Server.
- Snapshot recovery must be performed while all connected servers are disconnected (Umount, Disk Offline), and the restored volume can be used after it is reconnected (Mount, Disk Online).
- After the snapshot recovery is completed, all snapshots created after the snapshot used for recovery are deleted.
- When restoring a snapshot, the volume is restored to that point in time.
- If you are using Volume Group(BM), you can perform snapshot recovery from the detail page of Volume Group(BM).
Create a recovery copy
You can create a recovery copy from a snapshot of a Block Storage (BM) volume. To create a snapshot recovery copy, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to restore from a snapshot. You will be taken to the Block Storage(BM) Details page.
- If a server has been added in the Connected Server item, connect to the server and then perform the disconnect tasks (Umount, Disk Offline).
- For more details, refer to Disconnect Server.
- Click the Snapshot List page. Go to the Block Storage(BM) Snapshot List page.
- After confirming the Snapshot name and Creation timestamp, click the More button of the snapshot you want to create a recovery copy for.
- Click the Create Recovery button. The snapshot recovery creation popup opens.
- After entering the Recovery volume name, click the Create button. A popup notifying the creation of the recovery image will appear.
- Click the Confirm button. The recovery copy creation request is complete.
- Only one recovery copy can be created per original.
- A recovery copy is a separate volume created with the same capacity as the original, and it incurs additional costs.
- If you are using Volume Group(BM), you can create a recovery copy on the detail page of Volume Group(BM).
Delete Snapshot
You can select a snapshot to delete. To delete a snapshot, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to delete the snapshot. You will be taken to the Block Storage(BM) Details page.
- Click Snapshot List. It navigates to the Block Storage(BM) Snapshot List page.
- After confirming the Snapshot name and creation time, click the More button of the snapshot you want to delete.
- Click the Delete button. The snapshot will be removed from the Snapshot List page.
- After selecting the snapshots to delete from the snapshot list, you can click the Delete button at the top of the list to delete them all at once.Reference
- Snapshots that contain snapmirror in the snapshot name cannot be deleted. snapmirror is included in the snapshot name when a replication is created.
- If you are using Volume Group(BM), you can delete snapshots from the detail page of Volume Group(BM).
- After selecting the snapshots to delete from the snapshot list, you can click the Delete button at the top of the list to delete them all at once.
1.2.3 - Use Replication
After creating a replica of the generated Block Storage(BM) in another location, you can synchronize it periodically. You can perform the tasks on the Block Storage(BM) Details page and the Replication page.
- The kr-south region does not provide Block Storage (BM) replication functionality.
Create Clone
You can create a replica volume in a different location.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource for which you want to create a replica. You will be taken to the Block Storage(BM) Details page.
- Check the setting status of the Snapshot Capacity item.
- Replication can be created only when storage space is available through snapshot capacity configuration.
- For detailed information, refer to Modify Snapshot Capacity.
- Click the Create Clone button. The Create Clone popup opens.
- Enter the Replication location, Replication volume name, and Replication schedule, then click the Create button. It creates a replica with the same disk type.
- Replication Location: Select a location different from the original Block Storage(BM) volume.
- Replication Volume Name: Start with an English letter and use English letters, numbers, and special characters (
-) to enter 3 to 28 characters. - Replication interval: Select from 5 minutes, 1 hour, daily, weekly, monthly. Replication will be performed using the interval below.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Click the Clone page.
You will be taken to the Clone page. - Check the replication information.
- When selecting the volume name of the source or replica, you are taken to the volume’s Block Storage(BM) Details page.
- When a replica is created, a copy with the same disk type is generated.
- After setting the snapshot size, you can create a replica, and the disk type of the created replica is the same as the original.
- If the snapshot capacity utilization is high (around 90%), replication may be stopped.
- After setting the snapshot capacity, volumes added to the Volume Group can be replicated at the group level on the Volume Group page.
- You can create one replica per volume, and data transfer charges apply for cross‑region replication.
- A volume created by cloning cannot be added to a Volume Group.
- If you are using a Volume Group, you can view replication information in the Volume Group (BM).
Edit replication policy
You can change the replication status by modifying the replication policy.
To modify the replication policy, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- On the Block Storage(BM) List page, click the resource to edit the replication policy. You will be taken to the Block Storage(BM) Details page.
- Click the Replication page. Go to the Block Storage(BM) Replication page.
- Click the Edit button of the Replication Policy. The Edit Replication Policy popup opens.
- Use: performs replication. If it is Paused, you can change it to Use.
- Pause: Temporarily stops replication. If use, you can modify to Pause.
- Delete: Delete the replica. If Paused, it can be changed to Delete, and after deletion, replication cannot be used again.
- Check the updated Replication Policy on the Block Storage(BM) Replication page.
- When deleting a policy, please note the following.
- After the policy is deleted, the replica will not be reverted to the original, and you cannot create a replica.
- After deleting the policy, you cannot connect to existing replicas, and you can only create new replicas.
- Data stored only in the replica after a pause will be deleted when replication is used again.
- When using a replication policy, replicas are in Read only state and cannot be modified. Unmount from all connected resources before using replication.
- You can mount on the connected server only when the replication policy is deleted or paused.
Edit replication cycle
You can change the synchronization interval between the original and the replica by modifying the replication interval.
To modify the replication interval, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Block Storage(BM) menu. You will be taken to the Block Storage(BM) List page.
- Click the resource to modify the replication interval on the Block Storage(BM) List page. You will be taken to the Block Storage(BM) Details page.
- Click the Replication page. Go to the Block Storage(BM) Replication page.
- Click the Edit button of Replication Cycle. Replication Cycle Edit popup opens.
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, monthly. Replication will be performed using the interval below.
- Daily: 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, monthly. Replication will be performed using the interval below.
- Check the modified Replication Interval on the Block Storage(BM) Replication page.
1.2.4 - Use Volume Group
The Volume Group(BM) service allows you to configure up to 16 Block Storage(BM) volumes as a group, enabling the creation of consistent point-in-time snapshots and replications.
Users can create the service by entering the required information for the Volume Group (BM) and selecting detailed options through the Samsung Cloud Platform Console.
Create Volume Group (BM)
You can create and use a Volume Group (BM) service in the Samsung Cloud Platform Console.
To create a Block Storage, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- Click the Volume Group(BM) menu. Navigate to the Volume Group(BM) List page.
- On the Volume Group(BM) page, click the Volume Group(BM) Create button. You will be taken to the Volume Group(BM) Create page.
Category RequiredDetailed description Volume Group name Required Volume Group name - must start with an English letter and be 3 to 28 characters using English letters, numbers, and special characters (
-)
- cannot be modified after service creation
target volume Required Add target volume to Volume Group - After clicking the Add button, select the target volume in the add target popup
- Target volume criteria
- Snapshot size: Set
- Snapshot auto-creation, creation interval: Not used
- Replication: Not used
- Up to 16 can be added
Table. Volume Group (BM) Service Information Input Items - must start with an English letter and be 3 to 28 characters using English letters, numbers, and special characters (
- Click the Create button.
- When creation is complete, check the created resources on the Volume Group(BM) List page.
- When adding a target volume, you can add the corresponding volume to the Volume Group (BM).
- Snapshot capacity: Set
- Automatic snapshot creation, creation interval: unused
- Clone: Unused
- You can add up to 16 target volumes.
Check detailed information of Volume Group (BM)
Volume Group(BM) service allows you to view and edit the full resource list and detailed information. Volume Group(BM) Details page consists of Details, Snapshot List, Replication, Operation History tabs.
To view detailed information about the Volume Group(BM) service, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource to view detailed information. It navigates to the Volume Group(BM) Detail page.
- Volume Group(BM) Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Tags, Operation History tabs.
Category Detailed description Volume Group status Volume Group status - Creating: In progress
- Available: Creation complete, server connection possible
- Deleting: Service termination in progress
- Editing: Changing settings
- Error Deleting: Abnormal state during deletion
- Error: Abnormal state during creation
Clone creation Create a replica at another location - For details on creating a replica, see Create a replica
- Replication is not possible if the snapshot size is not set or a replication policy already exists
Create snapshot Create a snapshot at a specific point in time - For detailed information on snapshot creation, see Creating a Snapshot
Service termination Cancel service button Table. Status information and additional features
- Volume Group(BM) Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Tags, Operation History tabs.
Detailed information
Volume Group(BM) List page allows you to view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource Name | Resource Name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation date and time | Service creation timestamp |
| Editor | User who modified the service |
| Modification date | Date and time the service was modified |
| Volume Group name | Volume Group name |
| Category | Distinguish original status related to duplication |
| Storage Volume Group name | Volume Group name within the storage device
|
| Snapshot schedule | Snapshot auto-creation interval
|
| Recovery copy | Snapshot name of the Volume Group
|
| target volume | Block Storage (BM) added to the Volume Group
|
Snapshot list
Volume Group(BM) resource list page allows you to view the snapshot of the selected resource.
| Category | Detailed description |
|---|---|
| Snapshot name | Snapshot name |
| Creation Date/Time | Snapshot creation time |
| Additional features > More | Snapshot management button
|
- When a snapshot is created in a Volume Group, the snapshot is created in Block Storage (BM).
- When using Volume Group snapshots, manage the snapshot capacity and count of the target volume.
- If the maximum number of snapshots or the snapshot space threshold (around 90%) is exceeded, older snapshots are deleted first.
- If the snapshot capacity usage is high (around 90%), replication may be stopped.
- Snapshots can be created up to a maximum of 1,023 (with up to 128 automatically generated through scheduling), and if the maximum number is exceeded, no additional snapshots can be created.
- Snapshot recovery must be performed while all connected servers are disconnected (Umount, Disk Offline), and the restored volume can be used after it is reconnected (Mount, Disk Online).
- The snapshot creation time is based on Asia/Seoul (GMT +09:00).
- When using replication, snapmirror files cannot be deleted.
- When using a Volume Group, set the snapshot schedule on the Volume Group (BM) detail information screen. The created snapshots can be viewed in the Block Storage (BM) snapshot list.
Clone
Volume Group(BM) Resource List page allows you to view the replication information of the selected resource.
| Category | Detailed description |
|---|---|
| Replication Policy | User-configured replication policy
|
| Replication cycle | Replication interval of the source set by the user
|
| Replication status | Replication progress status according to policy settings |
| Lag Time | Time elapsed since the last successful replication
|
| Volume information | Volume information for the source and replica
|
- If the snapshot capacity usage is high (around 90%), replication may be stopped.
- When a clone is created, a replica with the same disk type is generated.
- Replication can be created after setting the snapshot capacity.
- If you are using a Volume Group, view the replication information on the Volume Group (BM) resource list page.
- Replica Block Storage can modify the attached server when the replication policy is paused or deleted.
- Replica Block Storage can use the snapshot feature after the replication policy is deleted.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and schedule on the replica.
Tag
Volume Group(BM) List page lets you view the tag information of the selected resource, and you can add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
Volume Group(BM) Resource List You can view the operation history of the selected resource on this page.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Volume Group(BM) Managing Resources
If you need to modify the settings of a created Volume Group (BM) or add or remove target volumes, you can perform the operation on the Volume Group(BM) Details page.
Edit Snapshot Schedule
You can modify the automatic snapshot creation interval. To modify the snapshot schedule, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. Navigate to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource to modify the snapshot schedule. You will be taken to the Volume Group(BM) Details page.
- Click the Edit button for the Snapshot Schedule item. The Snapshot Schedule Edit popup opens.
- Set the snapshot auto creation status and creation interval, then click the Confirm button.
- If you want to automatically create snapshots based on the Creation Cycle, select Automatic Creation as Enabled.
- Generation cycle can be selected daily, hourly, or weekly, day of week, hourly. Please select.
When using Volume Group snapshots, manage the snapshot capacity and count of the target volume.
- Snapshots can be created up to a maximum of 1,023 (with up to 128 automatically generated through scheduling), and if the maximum number is exceeded, no additional snapshots can be created.
Edit target volume
You can add or detach the target volume. To modify the target volume, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource to edit the target volume. You will be taken to the Volume Group(BM) Details page.
- If you are adding a target volume, click the Add button of the Target Volume item. The Add Volume popup window opens.
- When disconnecting a volume, click the Disconnect button in the Target Volume item.
- After selecting the volume you want to add, click the Confirm button.
- When adding a target volume, you can add the corresponding volume to the Volume Group (BM).
- Snapshot capacity: setting
- Automatic snapshot creation, creation interval: unused
- Clone: Unused
- You can add up to 16 target volumes.
Using Volume Group (BM) Snapshots
You can create, delete, or recover using snapshots for the created Volume Group (BM). You can perform these actions on the Volume Group (BM) Details page and the Snapshot List page.
Creating a Snapshot
Users can create a snapshot at the desired point in time.
- A replica can delete the replication policy, set the snapshot size for all block storage within the volume group, and then create a snapshot.
- Recovery images cannot create snapshots.
To create a snapshot, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- From the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource to create a snapshot. You will be taken to the Volume Group(BM) Details page.
- Click the Create Snapshot button. The Create Snapshot popup window opens.
- Click the Confirm button. Generates a snapshot of the current point in time.
- Click the Snapshot List page. Navigate to the Volume Group(BM) Snapshot list page.
- Check the generated snapshot.
- When creating a snapshot in a Volume Group, a snapshot is also created on the connected target volume.
- Manage the snapshot capacity and number of snapshots for the target volume to use Volume Group snapshots.
- If the maximum number of snapshots or the snapshot space threshold (around 90%) is exceeded, older snapshots are deleted first.
- If the snapshot capacity usage is high (around 90%), replication may be stopped.
- Snapshots can be created up to a maximum of 1,023 (with up to 128 automatically generated via schedule), and if the maximum number is exceeded, no further snapshots can be created.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00).
- The snapshot storage space is applied based on the settings you configured on the target volume’s Block Storage(BM) Details page.
- If you want to automatically create snapshots using a schedule, set the snapshot schedule on the Volume Group(BM) Details page.
- For detailed information about snapshot schedules, see Update Snapshot Schedule.
Recover Snapshot
You can restore all target volumes of the Volume Group(BM) from a snapshot. To restore from a snapshot, follow the steps below.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. Navigate to the Volume Group(BM) List page.
- Volume Group(BM) List On the page, click the resource to restore from a snapshot. Volume Group(BM) Details You will be taken to the page.
- Click the volume name of the volume added to the Target volume to go to the Block Storage(BM) Details page.
- If a server has been added in the Connected Server item, connect to the server and then perform the disconnect operations (Umount, Disk Offline).
- For more details, see Disconnect Server.
- On the Volume Group(BM) Details page, click the Snapshot List page. You will be taken to the Volume Group(BM) Snapshot List page.
- After checking the Snapshot name and Creation time, click the More button of the snapshot you want to restore.
- Click the Recover button. The snapshot recovery popup will open.
- After verifying the Snapshot name and Creation time, click the Confirm button. The target volumes will be restored from the snapshot.
- Click the Detailed Information button. It navigates to the Volume Group(BM) Detailed page.
- Click the volume name of the volume added to the Target volume. It will navigate to the Block Storage (BM) Details page.
- If there is a server added in the Connection Server item, after connecting to the server, perform the connection tasks (Mount, Disk Online).
- For detailed information, refer to Connect to Server.
- Snapshot recovery must be performed when all target volumes on the connected server are unmounted (Umount, Disk Offline), and the recovered volume can be used after being remounted (Mount, Disk Online).
- After the snapshot recovery is completed, all snapshots created after the snapshot used for recovery will be deleted.
Create a backup
You can create a recovery copy from a snapshot of the target volume. To create a snapshot recovery copy, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource for which you want to create a recovery copy. You will be taken to the Volume Group(BM) Details page.
- From the Volume Group(BM) Details page, click the Snapshot List page. You will be taken to the Volume Group(BM) Snapshot List page.
- After checking the snapshot name and creation timestamp, click the More button of the snapshot for which you want to create a recovery copy.
- Click the Create Recovery button. The snapshot recovery creation popup opens.
- After entering Prefix, click the Confirm button. A popup indicating that a backup is being created will open.
- The recovery copy’s name is created as the entered Prefix value + original Block Storage name.
- Click the Create button. The backup creation request has been completed.
- Only one recovery copy can be created per original.
- A recovery copy is a separate volume created with the same capacity as the original, and it incurs additional costs.
Delete snapshot
You can select a snapshot to delete. To delete a snapshot, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource to delete the snapshot. You will be taken to the Volume Group(BM) Details page.
- Click Snapshot List. Navigate to the Volume Group (BM) Snapshot List page.
- After confirming the Snapshot name and creation time, click the More button of the snapshot you want to delete.
- Click the Delete button. The snapshot will be removed from the Snapshot List page.
Using replication for Volume Group (BM)
The created Volume Group (BM) can be synchronized at regular, consistent points after creating a replica at another location. You can perform tasks on the Volume Group(BM) Details page and the Replication page.
Create a Clone
You can create a replicated Volume Group and volume at a different location.
To create a copy, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource for which you want to create a replica. You will be taken to the Volume Group(BM) Details page.
- Click the Create Clone button. The Create Clone popup opens.
- Enter Replication Location, Replication Volume Group, Replication Block Storage Name Prefix, and Replication Interval, then click the Create button. It creates a replica Block Storage volume with the same Volume Group and disk type as the source.
- Replication Location: Select a location different from the original Volume Group (BM).
- Clone Volume Group name: Start with an English letter and use English letters, numbers, and special characters (
-) to enter 3~28 characters. - Replication Block Storage Name Prefix: Start with an English letter and use English letters, numbers, and special characters (
-) to enter 3 to 28 characters.- A replica Block Storage (BM) is created with a volume name of ‘Replica Block Storage name Prefix + original Block Storage volume name’.
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: daily 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st of each month 23:59:00
- Click the Clone page. You will be taken to the Clone page.
- Check the replication information.
- When selecting the Volume Group name of the original or replica, you will be taken to the Volume Group(BM) Details page.
- When creating a replica in a Volume Group, a replica Volume Group and Block Storage (BM) are created.
- The replica Block Storage has the same disk type as the original.
- You can create one replica per Volume Group, and data transfer charges apply for cross‑region replication.
Edit replication policy
You can change the replication status by modifying the replication policy.
To modify the replication policy, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Go to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource you want to modify the replication policy for. You will be taken to the Volume Group(BM) Details page.
- Click the Clone page. Navigate to the Volume Group(BM) Clone page.
- Click the Edit button of the Replication Policy. The Edit Replication Policy popup opens.
- Enabled: performs replication. If Paused, you can modify it to Enabled.
- Pause: Temporarily stops replication. If Use, it can be changed to Pause.
- Delete: Delete the replica. Paused can be changed to Delete, and after deletion you cannot use replication again.
- Check the modified Replication Policy on the Volume Group(BM) Replication page.
- When deleting a policy, please note the following.
- After the policy is deleted, the replica does not revert to the original, and you cannot create a replica.
- After deleting the policy, you cannot connect to existing replicas, and you can only create new replicas.
- After a pause, data stored only in the replica will be deleted when replication is used again.
- When using a replication policy, replicas are in Read only state and cannot be modified. Unmount from all connected resources before using replication.
Edit replication interval
You can change the synchronization interval between the original and the replica by modifying the replication interval.
To modify the replication interval, follow these steps.
- Click the All Services > Storage > Block Storage(BM) menu. Navigate to the Service Home page of Block Storage(BM).
- On the Service Home page, click the Volume Group(BM) menu. You will be taken to the Volume Group(BM) List page.
- On the Volume Group(BM) List page, click the resource whose replication schedule you want to modify. You will be taken to the Volume Group(BM) Details page.
- Click the Clone page. Navigate to the Volume Group (BM) Clone page.
- Click the Edit button of Replication Cycle. The Edit Replication Cycle popup opens.
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Check the modified replication interval on the Volume Group(BM) Replication page.
Cancel Volume Group (BM)
You can delete an unused Volume Group (BM).
Volume Group(BM) has no separate termination procedure, and it is automatically deleted when you disconnect all volumes in the target volume item.
1.3 - API Reference
1.4 - CLI Reference
1.5 - Release Note
Block Storage(BM)
- The configuration range for the volume performance metrics (IOPS, Throughput) has been changed.
- Max IOPS: 5,000 ~ 20,000
- Max Throughput: 250 ~ 1,000
- Provides volume expansion feature
- Volume expansion is possible only for the original volume that does not use snapshots.
- You can set the volume’s performance metrics (IOPS, Throughput) and edit them on the details page.
- IOPS: 3,000 ~ 16,000
- Throughput: 125 ~ 1,000
- There is no separate charge during the preview period (billing is scheduled for the first half of 2026).
- A feature to create a recovery using snapshots has been added.
- A recovery copy is a separate volume created with the same capacity as the original, and it incurs additional costs.
- HDD disk type has been added. When creating Block Storage (BM), you can select the HDD disk.
- Provides an IaC environment through Terraform.
- You can use the snapshot feature on a cloned volume.
- Integrated with Cloud Monitoring.
- You can view IOPS, Latency, and Throughput information in Cloud Monitoring.
- Block Storage(BM) feature change
- The replication feature that allows Block Storage(BM) volumes to be replicated to another location has been added.
- A Volume Group feature has been added that allows you to set up to 16 Block Storage (BM) volumes as a group to create consistent point-in-time snapshots and replication.
- For detailed information, refer to Block Storage(BM) Overview.
- Samsung Cloud Platform Common Feature Changes
- Account, IAM, Service Home, tags, and other common CX changes have been applied.
- We have launched a high-performance storage service suitable for handling large-scale data and database workloads.
2 - File Storage
2.1 - Overview
Service Overview
File Storage enables servers connected via a network to easily store and share data, making it a storage solution suitable for application environments that use multiple servers.
You can choose the disk type according to the required performance level, and it will automatically expand or shrink based on the user’s data volume without any capacity limits.
Features
- Free volume usage: The volume capacity automatically expands or contracts based on data creation and deletion without any user configuration. There is no cost for creating the volume; only usage fees for the stored data capacity are incurred.
- Various Disk Types Available: Users can select a disk type based on their usage purpose. They can use HDDs that store large amounts of data cost‑effectively, SSDs that provide reduced response times and high IOPS performance, and high‑performance SSDs.
- Snapshot Backup: The image snapshot feature enables recovery of modified or deleted data, and when performing disk backup, snapshots can be stored in a location different from the original. Users select a snapshot created at the desired point in time from the list to perform the recovery.
- Replication: Creates an identical replica volume at a different location, and users can set the data replication interval. If the original volume becomes unavailable due to failures or disasters, service can be provided through the replica volume.
Configuration diagram
Provided features
File Storage provides the following features.
- Volume Name: Users can set a name for each volume.
- Disk type: You can select a disk type based on the user’s performance requirements.
- HDD: Standard volume
- SSD: high‑performance general volume
- High‑Performance SSD: Performance‑optimized volume that can be attached to a Multi-node GPU Cluster
- Protocol: You can select the protocol based on the user’s OS image.
- NFS: Primarily used on Linux operating systems
- CIFS: Primarily used on Windows operating systems
- Flexible Volume Usage: Provides flexible volume sizing based on the amount of stored data without requiring user capacity settings.
- Connected Resources: can be connected and used from Virtual Server, Bare Metal Server, and Multi-node GPU Cluster.
- Encryption: Regardless of disk type, all volumes are encrypted with the XTS-AES-256 algorithm.
- Snapshot: The image snapshot feature allows immediate or scheduled snapshot creation.
- Retention Count: The number of snapshots retained that are automatically created by the schedule
- Schedule: Snapshot auto-creation interval
- Recovery: restore the original volume to the latest snapshot, or select a snapshot at a specific point in time to create a recovery volume
- Replication: It replicates the volume to another location, and the user can set the replication schedule.
- Disk Backup: You can store snapshots on a backup-dedicated HDD storage and select the backup location.
- VPC Endpoint connection: File Storage can be used via a Private Network connection from an external network.
- Monitoring: usage, IOPS, Throughput, and other monitoring data can be viewed through the Cloud Monitoring service.
- ServiceWatch Service Integration: You can monitor data using the ServiceWatch service.
Component
You can create a volume by selecting the disk type and protocol according to the user’s service environment and performance requirements.
When using the snapshot feature, you can restore data to the desired point in time.
Volume
Volume(Volume) is the basic creation unit of the File Storage service and is used as data storage space. Users select a name, disk type, and protocol (CIFS/NFS) to create a volume, then connect it to one or more Server for use.
The volume name generation rules are as follows.
- It must start with a lowercase English letter and can be set to 3~21 characters using lowercase letters, numbers, and special characters (
_).
Snapshot
Snapshot is an image backup taken at a specific point in time. Using the image snapshot feature, you can recover changed or deleted data or store snapshots in a location different from the original when performing disk backups. Users select the snapshot created at the desired point in time from the snapshot list to perform a recovery.
The following are considerations when using snapshots.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to a maximum of 800, excluding those generated by schedule. (Automatic creation via schedule is limited to a maximum of 128)
- Select the snapshot recovery button to restore the File Storage volume to the latest snapshot.
- If you select a specific snapshot from the snapshot list, you can recover by creating a new volume based on that snapshot.
- Automatic creation is possible through snapshot schedule configuration.
- Since snapshot storage is included in File Storage usage and incurs charges, adjust the storage capacity by setting the snapshot retention period.
Preceding Service
This is a list of services that must be pre-configured before creating the service. Refer to the guide provided for each service for details and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Compute | Virtual Server | Virtual server optimized for cloud computing |
| Compute | Bare Metal Server | High-performance physical server used without virtualization |
2.1.1 - Monitoring Metrics
According to Samsung Cloud Platform’s policy, the Cloud Monitoring service is scheduled to be discontinued.
Accordingly, after the September 2026 release, resource monitoring of the Samsung Cloud Platform via Cloud Monitoring will no longer be possible.
With the new alternative service, you can continuously perform resource monitoring by using ServiceWatch, released in October 2025.
ServiceWatch provides more modern and powerful features, replacing Cloud Monitoring to deliver a smooth monitoring environment.
Detailed information about ServiceWatch: see the ServiceWatch Overview.
File Storage Monitoring Metrics
The table below shows the monitoring metrics for File Storage that can be viewed in Cloud Monitoring. For detailed usage of Cloud Monitoring, refer to the Cloud Monitoring guide.
| Performance Item Name | Explanation | unit |
|---|---|---|
| Instance Status | File Storage Volume Status | status |
| Volume Used | Usage | bytes |
| Volume Usage | Utilization | % |
| Volume Total | Total byte count | bytes |
| IOPS [Total] | iops(total) | iops |
| IOPS [Read] | iops(read) | iops |
| IOPS [Write] | iops(write) | iops |
| IOPS [Other] | iops(other) | iops |
| Latency Time [Total] | Latency (total) | usec |
| Latency Time [Read] | Read latency | usec |
| Latency Time [write] | Latency (write) | usec |
| Latency Time [Other] | Latency (Other) | usec |
| Throughput [Total] | Throughput (total) | bytes/s |
| Throughput [Read] | Throughput (read) | bytes/s |
| Throughput [Write] | Throughput (write) | bytes/s |
| Throughput [Other] | Throughput (Other) | bytes/s |
2.1.2 - ServiceWatch Metrics
File Storage sends metrics to ServiceWatch. The metrics provided by default monitoring are data collected at 1‑minute intervals.
Basic Metrics
The following are the basic metrics for the File Storage namespace.
The indicators whose names are displayed in bold below are the indicators selected as major metrics among the basic metrics provided by File Storage. Key metrics are used to configure service dashboards that are automatically generated for each service in ServiceWatch.
Each metric indicates, via the user guide, which statistical value is meaningful when viewing that metric, and among the meaningful statistics, the values shown in bold are the primary statistics. In the service dashboard, you can view key metrics using these primary statistical values.
| Indicator Name | Detailed description | unit | Meaningful statistics |
|---|---|---|---|
| status | File storage volume status | None | - |
| total_byte | Total bytes of file storage | Bytes |
|
| iops_read | IOPS (read) | - |
|
| iops_write | IOPS (write) | - |
|
| latency_read | Read latency | Microseconds |
|
| latency_write | Latency (write) | Microseconds |
|
| throughput_read | Throughput (read) | Bytes/Second |
|
| throughput_write | Throughput (write) | Bytes/Second |
|
2.2 - How-to guides
Users can create a service by entering the required information for File Storage and selecting detailed options through the Samsung Cloud Platform Console.
- Service fees are charged based on usage without capacity limits.
- Volumes are allocated 100 TB by default. If you need to use more than 100 TB, please inquire via Support Center’s Contact Us.
- Cost Management’s Payment Management, when you add or modify company information, the Mount name (IP information) of File Storage is automatically changed.
- Before modifying company information, be sure to check the service impact caused by changing the mount name (IP information).
Create File Storage
You can create and use the File Storage service from the Samsung Cloud Platform Console.
To create a File Storage, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the Create File Storage button. You will be taken to the Create File Storage page.
- File Storage Creation page, enter the information required to create the service, and select detailed options.
Category Whether requiredDetailed description Volume name Required Volume name - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
_)
- is generated as ‘user input value + {6-character UUID composed of lowercase English letters and numbers}’
- cannot be modified after the service is created
Disk types Required Select Disk Type - Disk Type
- HDD: Standard Volume
- SSD: High‑Performance Standard Volume
- High‑Performance SSD: Performance‑Optimized Volume that can be attached to a Multi‑node GPU Cluster
- Cannot be modified after service creation
- When creating a snapshot recovery volume, it is set identical to the original and cannot be modified
Protocol Required Protocols for sharing volumes over the network from a server - NFS: primarily used on Linux operating systems
- CIFS: primarily used on Windows operating systems
- When creating a service, the snapshot recovery volume is set identical to the original and cannot be modified
Protocol > Password Required Set the account password for volume access when using the CIFS protocol - Enter 6 to 20 characters, including English letters, numbers, and special characters(
$%{}[]"\excluded)
Protocol > Password Confirmation Required Confirm account password - Re-enter the same password
Recovery snapshot name Select Name of the recovery snapshot used when creating the volume - Provide the recovery snapshot name when creating a service through snapshot recovery volume creation
Table. File Storage Service Information Input Items - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
- Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
- Once creation is complete, check the created resource on the File Storage List page.
- Regardless of disk type, all volumes have server-side encryption based on the XTS-AES-256 algorithm applied by default.
- The snapshot schedule can be set on the detail page.
View File Storage Details
The File Storage service allows you to view and edit the full resource list and detailed information. The File Storage Details page consists of the Detailed Information, Snapshot List, Replication, Disk Backup, Tags, Operation History tabs.
To view detailed information about the File Storage service, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to view detailed information. You will be taken to the File Storage Details page.
- File Storage Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Disk Backup, Tags, Job History tabs.
Category Detailed description Volume status Volume status representation - Creating: Creating
- Creating From Snapshot: Creating a new volume from snapshot
- Available: Created, server connection available
- Deleting: Deleting
- Error Deleting: Abnormal state during deletion
- Inactive: Abnormal state
- Error: Abnormal state during creation
- Migrating: Temporary maintenance state
- Migrating To: Temporary maintenance state
- Reverting: Reverting snapshot
- Reverting Error: Snapshot revert error
Clone creation Create a replica at another location - Backups and replicas are unavailable
- For detailed information on creating replicas, see Creating a replica reference
Create disk backup Create a backup copy to store snapshots on backup-dedicated HDD storage - Available for HDD, SSD disk types
- Up to 2 backup copies can be created
- Backup copies and replicas are not available
- For details on creating a disk backup, see 디스크 백업 생성하기 reference
Create snapshot Immediately create a snapshot at the time of creation - For detailed information on snapshot creation, refer to Snapshot Creation
More > Snapshot Recovery Recover the volume using the latest snapshot in Available state - For details on snapshot recovery, refer to Recover Snapshot
More > File-level recovery Enable file-level recovery within snapshots - For detailed information on file-level recovery, see Using file-level recovery.
More > Disable file-level recovery Disable file-level recovery within snapshotsDisable file-level recovery see Service termination Button to cancel the service Table. Status information and additional features
- File Storage Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Disk Backup, Tags, Job History tabs.
Detailed information
On the File Storage List page, you can view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource name | Resource Name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation date and time | Service creation timestamp |
| Volume name | Volume name |
| Category | Distinguishing original status for duplication and disk backup |
| Disk type | Disk type |
| Usage | Volume usage |
| Protocol | NFS and CIFS protocols for sharing volumes over the network from a server |
| Mount name | Mount name per volume for server connection
|
| Encryption | Encryption status
|
| Snapshot > Schedule | Snapshot automatic creation schedule
|
| Snapshot > Retention Count | Snapshot retention count
|
| Connection resource | Connected resources (Bare Metal Server, Virtual Server, GPU Server)
|
| VPC Endpoint | Connected VPC Endpoint service
|
Snapshot list
You can view the snapshot of the selected resource on the File Storage List page.
| Category | Detailed description |
|---|---|
| Snapshot usage | Total size of stored snapshots |
| Snapshot name | Snapshot name |
| capacity | Snapshot capacity |
| Creation date and time | Snapshot creation time |
| status | Snapshot status
|
| Additional features > More | Snapshot Management Button
|
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to a maximum of 800, excluding those generated by schedule. (Automatic creation via schedule is limited to a maximum of 128)
- If replication or disk backup is in use, you cannot delete the snapmirror snapshot.
- When you click the snapshot recovery button, the volume is restored to the latest snapshot in the Available state.
- When selecting to create a recovery volume on the snapshot list page, a new volume based on the snapshot is created without modifying the existing volume.
- The snapshot list can be viewed in both the original and the backup. Replicas can be viewed after the policy is deleted.
- Snapshot creation, recovery, and recovery volume creation are available on the source.
- When using replication or disk backup, you cannot recover with a snapshot; you can only create a recovery volume.
Clone
On the File Storage List page, you can view the replication information of the selected resource.
| Category | Detailed description |
|---|---|
| Replication Policy | User-configured replication policy
|
| Replication cycle | The replication interval of the source set by the user
|
| Replication status | Replication progress status according to policy settings |
| Volume information | Volume information of original and replica
|
- When a clone is created, a replica with the same disk type is generated.
- Replication policy, Replication schedule can be modified in a replica when the replication status is Completed or Stopped.
- The replica’s file-level recovery can be used when the replication status is completed or stopped.
- The replica’s connection server and VPC Endpoint can be modified only when the replication status is stopped.
- Snapshot-related functions for replicas become available after the replication policy is deleted.
Disk backup
File Storage List page allows you to view the disk backup information of the selected resource.
- Disk type must be HDD or SSD; only the original can perform disk backup. It cannot be used on clones or high‑performance SSD.
- You can create up to two backup copies.
| Category | Detailed description |
|---|---|
| Backup Policy | Backup policy set by the user
|
| Backup frequency | User-configured backup interval of the original
|
| Backup status | Backup progress status based on policy settings |
| Number of backup copies | Number of snapshots retained in the backup |
| Volume information | Volume information for original and backup
|
- When creating a backup, it is created as an HDD disk type regardless of the original’s disk type.
- Backup policy, Backup schedule can be modified only when the backup status in the backup set is completed or stopped.
- File-level recovery of a backup can be used when the backup status is Completed or Stopped.
- The backup’s connected server and VPC Endpoint can be modified only when the backup status is stopped.
- Snapshots of the backup can only be deleted.
tag
File Storage List page allows you to view the tag information of the selected resource, and you can add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
File Storage List page lets you view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Managing File Storage Resources
If you need to modify the settings of a created File Storage or add or remove connected servers, you can perform the operation on the File Storage Details page.
Edit Snapshot
You can modify the snapshot schedule and retention count. To edit a snapshot, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- Click the File Storage menu on the Service Home page. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to edit the snapshot settings. You will be taken to the File Storage Details page.
- Click the Edit button of the Snapshot item. Snapshot Edit popup window opens.
- Set the Usage status, Schedule, and Storage Count, then click the Confirm button.
- If you want to automatically create snapshots based on Schedule, select Use.
- Schedule is selected daily, hour-wise, or weekly, day of week, hour-wise.
- Retention count: Enter a number between 1 and 128. If not entered, it defaults to 10.
- If the retention count after modification is lower than the original, older snapshots will be deleted first.
- When set to unused, previously created snapshots are retained.
- Since snapshot storage is included in File Storage usage and incurs charges, adjust the storage capacity by configuring the number of snapshots to retain.
- The snapshot schedule is based on Asia/Seoul (GMT +09:00).
Edit linked resources
You can connect or disconnect resources. To modify a connected resource, follow these steps.
- All Services > Storage > File Storage menu, click it. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource you want to edit. You will be taken to the File Storage Details page.
- Click the Edit button of the Linked Resource item. The Select Linked Resource popup opens.
- After selecting or deselecting the resource, click the Confirm button.
- You can select multiple resources simultaneously.
- You can connect up to 300 resources at the same location. If you need to connect more than 300, use the API.
- When adding a connected server, you can use it after performing the connection tasks (Mount, network drive connection) on the server. For detailed information about server connections, see Connect to Server.
- The replica’s connected server can be modified when the replication status is stopped.
- The backup’s linked server can be modified when the backup status is stopped.
Edit VPC Endpoint
You can connect or disconnect a VPC Endpoint.
To modify the connection resource, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to modify the VPC Endpoint connection. Then go to the File Storage Details page.
- Click the Edit button of the VPC Endpoint item. The Select VPC Endpoint popup window opens.
- After selecting or deselecting the resource, click the Confirm button.
- You can select multiple resources simultaneously.
- Connect to the server and be sure to perform the disconnect operation (Umount, disconnect network drive) before releasing the VPC Endpoint. If you release it without OS operations, a status error (Hang) may occur on the connected server. For detailed information on disconnecting the server, see 서버 연결 해제하기.
- High‑performance SSD disks can also share data by connecting a VPC Endpoint, but be aware that they do not guarantee sufficient performance for connecting internal VPC resources.
- High‑performance SSD disk type: after checking the connection IP in the VPC Endpoint section, apply for the VPC Endpoint service. You can add a VPC Endpoint created based on the connection IP.
- The VPC Endpoint of a replica can be modified only when the replication status is stopped.
- The VPC Endpoint of the backup can be modified only when the backup status is stopped.
Cancel File Storage
You can reduce operating costs by terminating unused File Storage. However, terminating the service may cause the running service to stop immediately, so you should thoroughly consider the impact of service interruption before proceeding with the termination.
- Please note that data cannot be recovered after termination.
- You can cancel the service of a File Storage volume that has no attached resources. Remove all connected servers before canceling the service.
- You can terminate the service for a File Storage volume that does not have a VPC Endpoint connection. Remove all VPC Endpoints before terminating the service.
- If the volume is in the Available, Error, or Inactive state, it can be deleted.
- The original that is using replication or disk backup can be terminated after deleting the corresponding policy.
- Replication policy: pause > delete
- Backup policy: pause > service termination
- A replica can be terminated after the replication policy is deleted.
- Backup copies can be terminated after the backup policy is stopped.
To cancel File Storage, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage list page, select the resource to cancel and click the Cancel Service button.
- When termination is complete, verify on the File Storage List page whether the resource has been terminated.
2.2.1 - Connect to Server
When using a volume on the server, a connect or disconnect operation is required.
File Storage Details on the page, after adding a connected server, access the server and perform the connection tasks (Mount, network drive connection). After use, perform the disconnection tasks (Umount, disconnect network drive) and then remove the connected server.
Connect to server (Mount, network drive connection)
To use the volume added to the connected server, you must log into the server and perform the connection tasks (Mount, network drive connection). Follow the steps below.
Linux operating system (NFS)
- Mount information: 10.10.10.10:/filestorage
- Mount location: /data
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
On the File Storage List page, click the resource to be used on the connected server. You will be taken to the File Storage Details page.
Check the server in the Connection Server item and then connect.
Refer to the procedure below to mount the volume.
Switch to root privileges
$ sudo -iPackage installation (Redhat family)
# yum install nfs-utilsPackage installation (Debian-based)
# apt-get install nfs-commonEnable and start NFS-related daemon
# systemctl enable rpcbind.service # systemctl start rpcbind.serviceVolume Mount
# mkdir /data # mount -t nfs -o vers=3,noresvport 10.10.10.10:/filestorage /data # vi /etc/fstab (추가) 10.10.10.10:/filestorage /data nfs defaults,vers=3,_netdev,noresvport 0 0
- Supports NFS Version 3.
Windows operating system (CIFS)
Click the All Services > Storage > File Storage menu. Go to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
On the File Storage List page, click the resource to be used on the connected server. You will be taken to the File Storage Details page.
In the Connection Server item, verify the server and then connect.
Refer to the steps below to connect the volume (network drive).
- In File Explorer, right-click This PC and click Connect network drive.
- Refer to the detailed information of the File Storage volume to be connected, enter the drive and folder, and then click Finish.
- To set it to reconnect automatically when the server restarts, select Reconnect when logging in.
In the network credential input popup, enter the account name (ID) and password, then click Confirm.
- Check the account name (ID) on the File Storage Details page.
- The password is the password set during File Storage creation.
- If you connect two or more volumes with the CIFS protocol enabled, add the storage IP and storage name to the hosts file before connecting.
* Mount명 \\10.10.10.10\filestorage1 \\10.10.10.10\filestorage2 * hosts 파일 내용 추가 10.10.10.10 filestoragename1 #설명 10.10.10.10 filestoragename2 #설명 * hosts 파일에 작성된 이름 사용 filestorage1 연결 시: \\ filestoragename1\filestorage1 filestorage2 연결 시: \\ filestoragename2\filestorage2
Disconnect server (Umount, disconnect network drive)
After connecting to the server and performing the disconnect tasks (Umount, disconnecting the network drive), you must detach the server in the Console. Follow the steps below.
Linux operating system (NFS)
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
On the File Storage List page, click the resource to detach the connected server. Go to the File Storage Details page.
In the Connection Server field, verify the server information and then connect to the server.
Refer to the commands listed in the table below to carry out the unmount (Umount) operation.
- Volume Umount
# umount /data # vi /etc/fstab (삭제) 10.10.10.10:/filestorage /data nfs defaults,vers=3,_netdev,noresvport 0 0
- Volume Umount
Windows operating system (CIFS)
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to disconnect the server. Navigate to the File Storage Details page.
- In the Connection Server field, verify the server information and then connect to the server.
- Refer to the steps below to disconnect the volume (disconnect the network drive).
In
File Explorer, right-click thenetwork drivethat is already connected.Please select
Disconnect network drive
2.2.2 - Use Snapshot
You can create, delete, or restore snapshots of a created File Storage. You can perform these actions on the File Storage Details page and the Snapshot List page.
Create Snapshot
You can create a snapshot of the current point in time immediately. To create a snapshot, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- File Storage List page, click the resource to create a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot Creation button. A popup indicating snapshot creation will open.
- Click the Confirm button. Creating a snapshot.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- Check the generated snapshot.
- Snapshot charges are included in the File Storage usage fees.
- When using replication or disk backup, you cannot recover with a snapshot; you can only create a recovery volume.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to 800, excluding those generated by schedule. (Automatic creation via schedule is limited to 128)
- If you want to automatically generate snapshots using a schedule, configure snapshots on the File Storage Details page.
- For detailed information about the snapshot schedule, see Update Snapshot.
Recover Snapshot
You can restore a File Storage volume to the latest snapshot in the Available state. To restore a snapshot, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to restore from a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- Check the latest snapshot in the Available state. The volume will be restored using that snapshot.
- Click the snapshot recovery button. A popup indicating snapshot recovery will open.
- After checking the snapshot name and creation timestamp, click the Confirm button.
- When recovery starts, it becomes Reverting, and when completed, it becomes Available.
- If you want to restore from a snapshot that is not the latest, you can recover by creating a recovery volume.
- During recovery, it restores from the latest snapshot in the Available state, and recovery is not possible in the following situations.
- When the File Storage volume is not in the Available state.
- If there are no recoverable snapshots.
- If the latest snapshot changes while creating a recovery.
- If the latest snapshot is not in the Available state.
Create a snapshot recovery volume
You can create a volume using a snapshot. To create a snapshot recovery volume, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to restore from a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- After checking the Snapshot Name and Creation Time, click the More button of the snapshot you want to restore.
- Click Create Recovery Volume. A popup window indicating the creation of a snapshot recovery volume opens.
- Click the Confirm button. Go to the File Storage creation page.
- On the File Storage creation page, enter the information required to create the service, and select detailed options.
- Please enter the volume name and password.
- The disk type and protocol are set to match the original and cannot be modified.
Category Required or notDetailed description Volume name Required Volume name - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
_)
- is generated as ‘user input value + {6-character UUID composed of lowercase English letters and numbers}’
- cannot be modified after the service is created
Disk type Required Select disk type - HDD: Standard volume
- SSD: High‑performance standard volume
- Cannot be modified after service creation
- When creating a service via snapshot recovery volume, it is set identical to the original and cannot be modified
Protocol Required Protocols for sharing volumes over the network from a server - NFS: primarily used on Linux operating systems
- CIFS: primarily used on Windows operating systems
- When creating a service, the snapshot recovery volume is set identical to the original and cannot be modified
Protocol > Password Required Set the account password for volume access when using the CIFS protocol - Enter 6~20 characters, including English letters, numbers, and special characters(
$%{}[]"\excluded)
Protocol > Password Confirmation Required Confirm account password - Re-enter the same password
Recovery snapshot name Select Name of the recovery snapshot used when creating the volume - Provide the recovery snapshot name when creating a service via snapshot recovery volume creation
Table. File Storage Service Information Input Items - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
- Check the detailed information and estimated billing amount generated in the Summary panel, and click the Create button.
- When creation is complete, check the created resource on the File Storage List page.
Delete snapshot
You can select a snapshot to delete. To delete a snapshot, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to delete the snapshot. Go to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- After checking the snapshot name and creation timestamp, click the More button of the snapshot you want to delete.
- Click the Delete button. The snapshot will be removed from the Snapshot List page.
- When using replication, snapmirror files cannot be deleted.
2.2.3 - File-level Recovery
You can restore data file by file using the generated snapshot. You can perform the operation on the File Storage Details page.
Using file-level recovery
You can enable the file-level recovery feature for use. After enabling the feature, connect to the server to select and recover data. To perform file-level recovery, follow these steps.
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
On the File Storage List page, click the resource to restore the file. You will be taken to the File Storage Details page.
Click the More button at the top right, then click the File-level Recovery button. The Enable File-level Recovery popup window opens.
Click the Confirm button. Activates the file-level recovery feature.
- When File-level recovery is enabled, the File-level recovery button is displayed as Disable file-level recovery.
In the Connection Server field, verify the server information and then connect to the server.
Refer to the procedure below to recover the data.
Connect to the server and verify the mount name of the File Storage.
Move to the snapshot location under the mount name.
# cd /Mount명/.snapshot/snapshot명- Check the files to be restored at the snapshot location and restore them to the required path.
Disable file-level recovery
You can disable the file-level recovery feature after using it. To disable file-level recovery, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to disable file-level recovery. You will be taken to the File Storage Details page.
- Click the More button at the top right, then click the Disable File-Level Recovery button. The Disable File-Level Recovery popup will open.
- Click the Confirm button. Disable the file-level recovery function.
2.2.4 - Use Disk Backup
After creating a backup of File Storage on a backup-dedicated HDD Storage, you can periodically store snapshots. You can perform the tasks on the File Storage Details page and the Disk Backup page.
- Disk type must be HDD or SSD for disk backup to be possible from the original. It cannot be used with clones or high‑performance SSD.
- You can create up to two backup copies.
Create Disk Backup
You can create a backup volume on a backup-dedicated HDD storage at the original location or elsewhere.
To create a backup volume, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to create a backup. Go to the File Storage Details page.
- Click the Create Disk Backup button. The Create Disk Backup popup window opens.
- After entering the backup information, click the Create button. It creates a backup of the HDD disk type.
- Backup Location: Select the location where the backup will be created.
- Backup Frequency: Choose from 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Click the Disk Backup page. Navigate to the Disk Backup page.
- disk backup information, please check.
- When selecting the volume name of the original or backup, you are taken to the File Storage Details page of that volume.
- A backup in HDD format is created regardless of the original disk type.
- You can create up to two backups per volume, and inter‑region backups incur additional data transfer charges.
Modify Disk Backup Policy
You can change the backup status by modifying the backup policy. To modify the backup policy, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to edit the backup policy. You will be taken to the File Storage Details page.
- Click the Disk Backup tab.
- Click the Edit button of the Backup Policy. The Disk Backup Policy Edit popup window opens.
- Enabled: Performs backup. If Paused, you can change it to Enabled.
- Pause: Temporarily stops the backup. If Enabled, you can modify to Pause.
- Delete: Deletes the backup. If it is Paused, it can be changed to Delete, and after deletion the backup cannot be used again.
- Check the updated backup policy on the Disk Backup page of File Storage.
Modify Disk Backup Schedule
You can change the synchronization interval between the original and the backup by modifying the backup schedule. To modify the backup schedule, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- File Storage List page, click the resource whose backup schedule you want to edit. You will be taken to the File Storage Details page.
- Click the Disk Backup page.
- Click the Edit button of Backup schedule. Backup schedule edit popup window opens.
- Select Backup frequency from 1 hour, daily, weekly, or monthly. Snapshots will be created at the selected interval. * Daily: 23:59:00 * Weekly: Every Sunday 23:59:00 * Monthly: 1st day of each month 23:59:00
- Check the updated backup schedule on the Disk Backup page of File Storage.
Modify the number of retained disk backups
You can set the number of snapshots retained in the backup. To modify the backup retention count, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to modify the backup schedule. You will be taken to the File Storage Details page.
- Click the Disk Backup page.
- Click the Edit button of Backup retention count. The Edit disk backup retention count popup opens.
- Backup retention count Please enter. * The retention count can be set from 1 to 128.
- Check the modified backup schedule on the Disk Backup tab of the File Storage Details page.
2.2.5 - Use Replication
You can create a replica of the File Storage at another location and synchronize it periodically. You can perform the tasks on the File Storage Details page and the Replication page.
- The kr-south region does not provide File Storage replication functionality.
Create Clone
You can create a replica volume at a different location. To create a replica volume, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage List page.
- On the File Storage List page, click the resource for which you want to create a replica. You will be taken to the File Storage Details page.
- Click the Create Clone button. The Create Clone popup window opens.
- Enter the replication location, replication volume name, password, and replication interval, then click the Create button. It creates a replica with the same disk type.
- Replication location: Choose a location different from the original File Storage volume.
- Replication Volume Name: Begin with a lowercase English letter and use lowercase letters, numbers, and special characters (
_) to enter 3–21 characters. - Password: This is the account password for accessing a CIFS volume. Enter 6 to 20 characters, including letters, numbers, and special characters (
$%{}[]"\excluded). - Replication interval: Select from 5 minutes, 1 hour, daily, weekly, monthly. Replication will be performed using the interval below.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Click the Clone page. You will be taken to the Clone page.
- Check the replication information.
- When selecting the volume name of the original or replica, you are taken to the volume’s File Storage Details page.
- When creating a replica, a replica with the same disk type and protocol is created.
- You can create one replica per volume, and data transfer charges apply for cross‑region replication.
Edit replication policy
You can change the replication status by modifying the replication policy. To modify the replication policy, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- On the File Storage List page, click the resource to edit the replication policy. You will be taken to the File Storage Details page.
- Click the Replication page. Navigate to the File Storage Replication page.
- Click the Edit button of the Replication Policy. The Edit Replication Policy popup window opens.
- Use: performs replication. If it is Paused, you can change it to Use.
- Pause: Temporarily pauses replication. If enabled, you can modify it to Pause.
- Delete: Delete the replica. If it is Paused, you can modify it to Delete, and after deletion you cannot use replication again.
- Check the updated Replication Policy on the File Storage Replication page.
- After deletion, the replica becomes the original, so you cannot replicate back to the previous configuration by modifying the replication policy.
- Data stored only in the replica after a pause will be deleted when replication is used again.
- When using the replication policy, replicas are in read‑only state and data cannot be modified. Unmount from all connected resources before using replication.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and schedule on the replica.
Edit replication cycle
You can change the synchronization interval between the original and the replica by modifying the replication interval. To modify the replication interval, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- On the File Storage List page, click the resource to edit the replication schedule. You will be taken to the File Storage Details page.
- Click the Replication page. Go to the File Storage Replication page.
- Click the Edit button of Replication Cycle. The Edit Replication Cycle popup opens.
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- On the File Storage Replication page, check the modified replication schedule.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and interval on the replica.
2.3 - API Reference
2.4 - CLI Reference
2.5 - Release Note
File Storage
- The SSD SAP_E volume dedicated to SAP Account and the SSD SAP_E disk type have been added.
- When using a volume dedicated to the SAP Account, the LIF (storage Mount IP) is automatically transferred when a failover occurs due to a fault.
- It can be used only with a SAP account.
- ServiceWatch service integration provision
- You can monitor data through the ServiceWatch service.
- High‑performance SSD disk type has been added and can be used by connecting to a Multi-node GPU Cluster.
- Disk Backup allows you to store snapshots on a backup-dedicated HDD storage. You can select a location other than the original.
- File Storage feature change
- SSD disk types have been added, enabling you to choose a disk type according to your needs.
- You can create an identical replica volume at a different location and set the data replication interval.
- File Storage can be accessed from external networks via a VPC Endpoint connection.
- Samsung Cloud Platform Common Feature Changes
- Account, IAM, Service Home, tags, and other common CX changes have been applied.
- Since it automatically scales up or down based on usage, users can use the volume without capacity limits.
- You can select the connection target using the access control feature.
- We have launched the File Storage service, a network‑connected storage that enables multiple client servers to share files.
3 - Object Storage
3.1 - Overview
Service Overview
Object Storage is object storage that allows users to easily store and use the data they want and can be accessed via URL, making data management very convenient. It enables searching and retrieving large-scale data, and you can leverage features such as encryption and version control. Provides both public and private URLs, and public URLs are accessible over the internet.
Features
- S3 API utilization: Through a Restful API, applications can access it easily and quickly, and since it is compatible with Amazon S3, it can be used effortlessly in applications that integrate with Amazon S3.
- Safe Use: Encryption (SSE‑S3), access control, and Public/Private access features are provided, making it suitable for securely storing user data or backup data for service recovery.
- Cost Efficiency: Users do not predefine the bucket’s capacity and are provided storage space with an efficient pricing model that charges only for the amount used.
- Replication: You can perform replication to a bucket in a different location or the same location. * You can configure multiple replication policies, and if the source bucket becomes unavailable due to a failure or disaster, you can provide service through the replica bucket.
Configuration diagram
Provided Features
Object Storage provides the following features.
- Storage Management: Provides Object Storage creation, folder creation, folder deletion, file upload, file download, and file deletion functions.
- Version control: When you use version control, all versions of the uploaded files are managed. * You can easily download previous files by viewing the version list.
- Encryption: If you enable encryption, encryption is provided via the SSE‑S3 method.
- Access Control: Using access control, you can directly enter the Public IP allowed to access Object Storage or select resources (Virtual Server, Bare Metal Server, VPC Endpoint, etc.) within the same Account that are permitted to access.
- Replication: You can perform replication to a bucket in a different location or the same location.
- Multiple replication policies can be configured
- Permission Management: It is provided with Private permission by default, and offers Public permission and permission management features.
- Private permission: Allow file access and download only to users who know the authentication key.
- Public permission: Accessing the file via its URL makes the file publicly available and downloadable to anyone worldwide
- Monitoring: You can view monitoring information such as total file count, data size (Bytes), and HTTP method request counts through the Cloud Monitoring service.
- ServiceWatch Service Integration Offering: You can monitor data through the ServiceWatch service.
Component
Authentication key
The authentication key is a required element that must be created in advance to use Object Storage.
The purpose of using the authentication key is as follows.
- In the Samsung Cloud Platform Console, you need an authentication key to create and access the Object Storage service.
- The API provided by Object Storage is compatible with Amazon S3, and you can use the same tools that leverage Amazon S3. * At this point, entering an authentication key is required, and it is used as a tool to identify whether the user has the appropriate permissions. For detailed instructions on creating and verifying authentication keys, see How-to guides > 인증키 생성하기.
Bucket
A bucket is the top-level folder, and all folders and files exist under the bucket. When you create an Object Storage service in the Samsung Cloud Platform Console, a bucket is created, and you can subsequently upload folders or files.
The bucket name creation rules are as follows.
- Bucket names must be at least 3 characters and at most 63 characters.
- Bucket names can consist only of lowercase English letters, numbers, periods
.and hyphens-. - Bucket names must start with a lowercase letter or a digit.
- Bucket names must not contain two consecutive periods.
- Bucket names cannot end with a period or hyphen.
- Bucket names cannot have a period and hyphen adjacent to each other.
- Bucket names do not use the IP address format (e.g., 192.168.x.x).
- The bucket name cannot be admin.
- Bucket names must be unique within an Account/Region.
- The bucket name you used previously will be available in 1 hour.
| Example of a valid bucket name | Example of an invalid bucket name |
|---|---|
The following bucket names can be used
| The following bucket names cannot be used
|
Folder
A folder (Folder) is used to logically group files.
The folder name generation rules are as follows.
- Folder names can consist of Korean characters, English letters, numbers, and special characters.
- The special characters that cannot be entered are as follows.
| Special characters that cannot be used in folder names |
|---|
|
File
A file (File) refers to data stored in Object Storage and is the same as a regular file.
The filename generation rules are as follows.
- Filenames can consist of Korean characters, English letters, numbers, and special characters.
- The special characters that cannot be entered are as follows.
| Special characters that cannot be used in file names |
|---|
|
Folder names and file names are separated by a slash/. The following are examples of valid folder and file names.
| Example of mixed use of folder and file names |
|---|
|
/), is limited to within 1,024 bytes (based on UTF-8 encoding).URL
You can access the Object Storage bucket via URL. By providing public and private URLs, access is possible not only within the same Samsung Cloud Platform environment but also from external internet environments.
The URL structure is composed as follows.
| URL without using Account ID | URL that uses the Account ID |
|---|---|
| https://[대표URL]/[bucket명]/[폴더명]/[파일명] | https://[대표URL]/[accountId]:[bucket명]/[폴더명]/[파일명] |
| Category | Explanation | example |
|---|---|---|
| Main URL | Representative URL is available at the Object Storage 상세 정보 확인하기 URL
| - |
| accountId | account ID
| c2ef8be0481d4094af3c6d046e536d25 |
| bucket name | User-created bucket name | bucketname |
| Folder name | Folder name where the file is located | folder/folder01/folder02/ |
| Filename | File name | Filename02 |
The full URL information for the file can be viewed at View File Information.
Constraints
The limitations of Object Storage are as follows.
| Category | Explanation |
|---|---|
| Number of creatable Object Storage services | No more than 1,000 per region |
| File name length (including path) | up to 1,024 Bytes |
| File upload size |
|
| Number of files in the bucket | 200 million or fewer |
- It is recommended to store no more than 200 million files per bucket. * If the number of files exceeds 200 million, you may experience a sharp performance degradation, so manage the file count.
- S3 Backend Filesystem solution (ex. * When using s3fs, objectivefs, etc., we recommend not employing version control. * Performance degradation may occur when using version control.
- After changing IAM permissions, performing an Amazon S3 API call may take up to 30 seconds.
- Object Storage cannot be used for file upload and download when the IAM policy uses a temporary authentication type.
- South Korea (kr-south3) region constraints
- File upload and download functions via the Samsung Cloud Platform Console are restricted.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- Region constraints for South Korea South 1 (kr-south1) and South Korea South 2 (kr-south2)
- A separate firewall rule must be allowed to enable access to the public URL.
- The public URL can be viewed on the Object Storage detail page. * Object Storage Detailed Information Check please refer to it.
Preceding Service
Object Storage has no prerequisite services.
3.1.1 - Amazon S3 Usage Guide
Object Storage provides functions such as creating services, viewing lists, retrieving folder lists, creating folders, uploading files, and downloading files through the Samsung Cloud Platform Console. These functions are also available via an API compatible with Amazon S3. Therefore, tools that use Amazon S3 can be used in the same way.
To use Amazon S3’s utility tools, you need to generate and verify an authentication key. For detailed information, see Create Authentication Key.
Amazon S3 API
The list of Amazon S3 APIs supported by the Samsung Cloud Platform Object Storage service is as follows.
| Category | Detailed description |
|---|---|
| head-bucket | Retrieve bucket information |
| list-buckets | List buckets |
| get-bucket-versioning | Bucket version management query |
| put-bucket-versioning | Bucket version control modification |
| get-bucket-encryption | Retrieve bucket encryption settings |
| put-bucket-encryption | Apply bucket encryption settings |
| delete-bucket-encryption | Delete bucket encryption configuration |
| copy-object | Copy, move, rename objects |
| put-object | Object creation |
| get-object | Object download |
| list-objects | Retrieve object list |
| head-object | Object detail view |
| get-object-acl | Retrieve Object ACL |
| delete-object | Object deletion
|
| list-object-versions | View object version list |
| delete-object | Delete object version |
| presign | Issue a Presigned URL for PUT object |
| get-bucket-acl | Check bucket public permissions |
| create-bucket | Create bucket |
| delete-bucket | Delete bucket |
| get-bucket-cors | Check bucket CORS (Cross OriginResources) configuration |
| put-bucket-cors | Create bucket CORS (PUT) |
| delete-bucket-cors | Delete bucket CORS |
| put-bucket-tagging | Create bucket tagging |
| get-bucket-tagging | Bucket tagging query |
| delete-bucket-tagging | Delete bucket tagging |
| put-bucket-website | Create bucket website |
| get-bucket-website | View bucket website |
| delete-bucket-website | Delete bucket website |
| get-bucket-policy-status | Check bucket policy status |
| put-bucket-acl | Create bucket ACL |
| create-multipart-upload | Create multipart upload |
| upload-part | Perform multipart upload |
| complete-multipart-upload | Multipart upload completed |
| list-multipart-uploads | Multipart upload list |
| abort-multipart-upload | Delete incomplete Multipart upload |
| put-object-tagging | Object tagging creation |
| get-object-tagging | Object tagging query |
| delete-object-tagging | Delete object tagging |
| list-objects-V2 | Object Lookup (v2) |
| put-object-acl | Create object ACL |
| list-parts | Parts lookup |
| put-public-access-block | Create public access block |
| get-public-access-block | public access block lookup |
| delete-public-access-block | Delete public access block |
| put-bucket-lifecycle | Create bucket Lifecycle (only Expiration rule can be used) |
| get-bucket-lifecycle | View Bucket Lifecycle |
| delete-bucket-lifecycle | Delete bucket lifecycle |
| put-bucket-policy | Create bucket policy(* reference) |
| get-bucket-policy | View bucket policy |
| delete-bucket-policy | Delete bucket policy |
| put-bucket-replication | Edit bucket replication policy
|
| get-bucket-replication | Retrieve bucket replication policy |
| delete-bucket-replication | Delete bucket replication policy |
put-bucket-policy when used, refer to the following example.
{
"Statement": [
{
"Action": "s3:*",
"Condition": {
"IpAddress": {
"scp:SourceIp": []
},
"Resource": {
"scp:SourceDBaaSId": [],
"scp:SourceResourceId": [],
"scp:SourceVpcEndpointId": []
},
"Service": {
"scp:ServiceScf": "false"
}
},
"Effect": "Allow",
"Principal": "*",
"Resource": [
"Object Storage SRN",
"Object Storage SRN/*"
]
}
],
"Version": "2012-10-17"
}
Action,Effect,Principal,Resourcecannot be modified.- Enter the Object Storage SRN and Object Storage SRN/* in
Resource.
- Enter the Object Storage SRN and Object Storage SRN/* in
ConditioninIpAddress,Resource,Servicecan be modified as follows.IpAddress: Enter a single IP or CIDR format.Resource: Enter each resource ID.Service:falseortrue- For detailed information about permissible targets, refer to Setting Access Control.
Amazon S3 CLI
To use Amazon S3 with the AWS CLI, refer to the Amazon S3 CLI Guide.
Amazon S3 SDK for Java
To use the Amazon S3 SDK for Java, please refer to Amazon S3 SDK Guide.
- Refer to the following for the region parameter required to use the Amazon S3 SDK.
- For Korea West (kr-west1): kr-west
- When South Korea 1,2,3 (kr-south1,2,3): kr-south
- The region parameter is for reference only, and the actual region is determined based on the URL.
- South Korea Region 3 (kr-south3) constraints
- File upload and download capabilities are limited through the Samsung Cloud Platform Console.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region restrictions
- To access the public URL, you must allow a separate firewall configuration.
- You can view the public URL address on the Object Storage details page. Refer to Check Object Storage Details.
3.1.2 - Monitoring Metrics
According to Samsung Cloud Platform’s policy, the Cloud Monitoring service is scheduled to be discontinued.
Accordingly, after the September 2026 release, resource monitoring of the Samsung Cloud Platform via Cloud Monitoring will no longer be possible.
With the new alternative service, you can continuously perform resource monitoring by using ServiceWatch, released in October 2025.
ServiceWatch provides more modern and powerful features, replacing Cloud Monitoring to deliver a smooth monitoring environment.
Detailed information about ServiceWatch is available in the ServiceWatch Overview.
Object Storage Monitoring Metrics
The table below shows the monitoring metrics for Object Storage that can be viewed through Cloud Monitoring. For detailed usage of Cloud Monitoring, refer to the Cloud Monitoring guide.
| Performance Item Name | Explanation | unit |
|---|---|---|
| Objects | Number of objects stored in the bucket | cnt |
| Bucket Used | Amount of data stored in the bucket (bytes) | bytes |
| Requests [Upload Avg] | Upload usage per bucket | bytes |
| Requests [Download Avg] | Download usage per bucket | bytes |
| Requests [Total] | Total number of HTTP requests executed in the bucket | cnt |
| Requests [Get] | Number of HTTP GET requests executed on objects in the bucket | cnt |
| Requests [Head] | Number of HTTP HEAD requests executed for objects in the bucket | cnt |
| Requests [List] | Number of LIST requests executed for objects in the bucket | cnt |
| Requests [Post] | Number of HTTP POST requests executed on objects in the bucket | cnt |
| Requests [Put] | Number of HTTP PUT requests executed on objects in the bucket | cnt |
| Requests [Delete] | Number of HTTP DELETE requests executed on objects within the bucket | cnt |
3.1.3 - ServiceWatch Metrics
Object Storage sends metrics to ServiceWatch. The metrics provided by default monitoring are data collected at 5‑minute intervals. In Object Storage, you can view replication metrics by policy in ServiceWatch by enabling ServiceWatch replication metrics per bucket.
Refer to How-to guides > Object Storage Activating Replication Metrics for how to enable ServiceWatch replication metrics.
Basic Metrics
The following are the basic metrics for the Object Storage namespace.
The indicators whose names are displayed in bold below are the key indicators selected from the basic metrics provided by Object Storage. Key metrics are used to configure service dashboards that are automatically generated for each service in ServiceWatch.
Each metric indicates through the user guide which statistical value is meaningful when viewing that metric, and among the meaningful statistics, the statistical values shown in bold text are the primary statistics. In the service dashboard, primary metrics can be viewed using the primary statistical values.
| Performance items | Detailed description | unit | Meaningful statistics |
|---|---|---|---|
| object_count | Number of objects stored in the bucket | Count |
|
| object_byte | Amount of data stored in the bucket | Bytes |
|
Replication Metric
The following are replication metrics. Replication metrics are collected per replication policy. Replication metrics are collected only when ServiceWatch replication metrics are enabled for each bucket. The replication metrics are as follows.
| Performance items | Detailed description | unit | Meaningful statistics |
|---|---|---|---|
| replication_total_count | Total number of objects to be transferred | Count |
|
| replication_transferred_count | Number of transmitted objects | Count |
|
| replication_progress_count | Number of objects being transferred | Count |
|
| replication_queued_count | Number of objects pending transmission | Count |
|
| replication_pending_count | Number of objects with transmission delay | Count |
|
| replication_failure_count | Number of failed transmission objects | Count |
|
| replication_total_bytes | Total transfer target size | Bytes |
|
| replication_transferred_bytes | Data transferred | Bytes |
|
| replication_max_processing_time | Maximum processing time | Seconds |
|
| replication_avg_processing_time | Average processing time | Seconds |
|
3.2 - How-to guides
Users can create the service by entering the required Object Storage information and selecting detailed options through the Samsung Cloud Platform Console.
Create authentication key
To create and use the Object Storage service in the Samsung Cloud Platform Console, you must first generate an authentication key.
You can generate an authentication key at My menu > My Info. > Authentication Key Management > Generate Authentication Key. For more details, refer to IAM > Create Authentication Key.
- Authentication keys (Access Key, Secret Key) are used when authenticating Amazon S3 utilities.
- The authentication key is used not only for Object Storage but also for authentication with OpenAPI and the CLI.
- You can generate up to two authentication keys.
- If the authentication key expires, access to the Object Storage service will be restricted. To ensure smooth service usage, check the authentication key’s expiration period in advance.
- If you disable the authentication key, access permissions to the Object Storage service will be restricted.
Create Object Storage
You can create and use the Object Storage service from the Samsung Cloud Platform Console.
To create an Object Storage, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- Click the Create Object Storage button on the Service Home page. You will be taken to the Create Object Storage page.
- On the Object Storage Creation page, enter the information required to create the service.
Category RequiredDetailed description Bucket name Required Bucket name created by the user - must start with a lowercase letter or digit and be composed of lowercase letters, digits, hyphen
-, and period.using 3 to 63 characters
- period
.cannot appear consecutively two or more times.
- period
.and hyphen-cannot be adjacent.
- period
.or hyphen-cannot be at the end.
- IP address format is not allowed
- admin name is not allowed
- For detailed information about bucket names, see Bucket Naming Rules.
Table. Object Storage required information input fields - must start with a lowercase letter or digit and be composed of lowercase letters, digits, hyphen
- Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
- Once creation is complete, check the created resource on the Object Storage list page.
Check detailed information of Object Storage
Object Storage service allows you to view and edit the full resource list and detailed information.
The Object Storage Details page consists of Details, Folder List, Tags tabs.
To view detailed information about the Object Storage service, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource whose detailed information you want to view. You will be taken to the Object Storage Details page.
- Object Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Replication, Tags tabs.
Category Detailed description Bucket status Bucket status - Active: Available
Service termination Cancel Service button Table. Status information and additional features
- Object Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Replication, Tags tabs.
If needed, please check via the Logging&Audit service. For more details, see Logging & Auddit > How-to Guides.
Detailed Information
Object Storage List page lets you view detailed information of the selected resource and edit it if necessary.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource name | Resource Name
|
| Resource ID | Unique resource ID in the service |
| Bucket name | User-created bucket name |
| Category | Field that distinguishes between original and replica
|
| Usage | Total data usage of the bucket |
| Encryption | Encryption usage information
|
| Version control | Version Management Usage Information
|
| URL | Object Storage provides Public and Private URLs for access
|
| Access Control | When access control is enabled, you can restrict access to the bucket so that only authorized resources can access it
|
Folder list
You can view the list of folders and files stored in the bucket via the Folder List tab.
| Category | Detailed description |
|---|---|
| Name | File name or folder name |
| size | File size |
| Modification date and time | The date and time the file was last modified |
| Additional features > More | File and folder management buttons
|
| New folder | Add new folder
|
| File upload | Upload a new file or a file you are working on
|
| Delete | Delete file or folder
|
| Download | File download
|
- South Korea Region 3 (kr-south3) constraints
- File upload and download capabilities are limited through the Samsung Cloud Platform Console.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region restrictions
- To access the public URL, you must allow a separate firewall configuration.
- You can view the public URL address on the Object Storage details page. Refer to Object Storage Check Detailed Information.
- If the delete marker is the latest version, it cannot be seen in the folder list.
- The delete marker version cannot be viewed in the version list.
Replication
Object Storage List page lets you view and manage the replication information of the selected resource.
| Category | Detailed description |
|---|---|
| Policy Name | Enter the replication policy name
|
| Replication target | Replication target bucket name |
| Clone location | Replication location (region) |
| target file | List of files to be replicated |
| status | Replication policy status
|
| Add | Add a new replication policy
|
| More | Policy management available
|
| Service Watch replication metrics | Enable replication metrics to view monitoring data for Object Storage replication in Service Watch
|
tag
Object Storage List page lets you view, add, modify, or delete the tag information of the selected resource.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
If needed, please check via the Logging&Audit service. For more details, see Logging&Auddit > How-to Guides.
Object Storage Encryption Configuration
You can configure the bucket to encrypt the data stored in it. After enabling bucket encryption, the encryption settings are applied to uploaded data. When encryption is used, the SSE‑S3 encryption key method and the AES256 encryption algorithm are applied.
In this service, we have launched server‑side encryption (SSE‑S3) using Amazon S3 managed keys as the default method, and server‑side encryption (SSE‑KMS) using Key Management Service (KMS) keys will be offered later according to the service roadmap.
If there is data that was stored before the bucket encryption was configured, the encryption setting will not be applied.
- If you re‑upload the file, the encryption will be applied.
- To enable encryption for existing data, you need to re‑upload it.
Object Storage Follow the steps below to enable bucket encryption.
- Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage list page, click the resource (bucket) to use for encryption. You will be taken to the Object Storage details page.
- On the Object Storage Details page, verify whether encryption is not used.
- If Encryption is unused, click the Edit button.Encryption Edit Popup opens.
- After checking Use for encryption, click the Confirm button.
Terminate Object Storage
You can cancel unused Object Storage to reduce operating costs. However, if you cancel the service, the running service may be stopped immediately, so you should thoroughly consider the impact of service interruption before proceeding with the cancellation.
- Service termination is possible for buckets that have no stored data.
- If a file is being uploaded, the upload will be canceled.
- Please be careful, as data cannot be recovered after deletion.
To cancel Object Storage, follow the steps below.
- Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage list page, select the resource (bucket) to cancel, and click the Cancel Service button.
- Enter bucket name to confirm cancellation.
- If you have entered the Bucket name correctly, the Confirm button will be activated. Click the Confirm button.
- When termination is complete, verify on the Object Storage list page that the resource has been terminated.
3.2.1 - Access Control
If you set bucket access control to enabled, only resources that are permitted can access the bucket. You can enter a public IP or configure settings to allow access to resources created in the Samsung Cloud Platform Console.
Setting up Access Control
You can set the bucket’s access control to enabled.
Object Storage Follow the steps below to configure access control settings.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) to set access control. You will be taken to the Object Storage Details page.
- Verify on the Object Storage Details page whether access control is unused.
- Access control is disabled, click the Edit button. Access control edit popup opens.
- After checking Use for access control, click the Confirm button. In the Object Storage Details page, access control will be set to Use.
- Register service resources to grant access using a Public IP, or configure whether to enable access control for the Cloud Functions service.
| Category | Detailed description |
|---|---|
| Allow public IP | Add registered Public IP or CIDR
|
| Allow service resources | Select service resources created in the same Account/Region
|
| Allow Cloud Functions service | Setting whether to allow Object Storage access to modify Java Runtime code in the Cloud Functions service
|
South Korea (kr-south) region constraints
- The South Korea (kr-south) region does not provide Cloud Funtions service, so the Allow Cloud Functions Service feature cannot be used.
Allow public IP access
If the bucket’s access control is set to enabled, you can add a public IP allowance.
To add Public IP access permission in Object Storage, follow the steps below.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) for which you want to set access control. You will be taken to the Object Storage Details page.
- On the Object Storage Details page, verify that access control is enabled.
- If Access Control is Disabled, click the Edit button, then change Access Control to Enabled in the Access Control popup.
- When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
- Click the Edit button in Allow Public IP. The Edit Allow Public IP popup window opens.
- Enter the Public IP to allow access, and click the Add button.
column Required Detailed description Allow public IP Required Enter a single IP or CIDR format (up to 150 entries) - 192.168.x.x (IP format)
- 192.168.x.x/24 (CIDR format)
Table. Public IP Allowance Edit Popup Input Fields - Verify the items added to the list and click the Confirm button.
- Check the added Public IP in the Object Storage Details page’s Access Control > Allow Public IP list.
- If you modify the public IP allowance, it may take up to 30 seconds for the changes to be applied.
- A maximum of 150 public IPs are allowed.
Allow access to service resources
If access control is set to enabled on the bucket, you can add service resources in the service resource allowance.
To permit access to service resources in Object Storage, follow the steps below.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) for which you want to set access control. You will be taken to the Object Storage Details page.
- Verify that Access Control is enabled on the Object Storage Details page.
- If Access Control is Disabled, click the Edit button, then change Access Control to Enabled in the Access Control popup.
- When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
- Click the Edit button in Service Resource Allowance. The Service Resource Selection popup opens.
The permissible criteria for each service are as follows.
- Virtual Server/GPU Server/Bare Metal Server/Multi-node GPU Cluster: Allowed per server
- VPC Endpoint: Allow per VPC Endpoint
- PostgreSQL, MariaDB, MySQL, EPAS, Microsoft SQL Server: Allowed per cluster
The following steps are required to access Object Storage from the server.
- Check the Object Storage IP on the server using the nslookup command
- Register a rule through the Security Group or Firewall service and apply it to the server.
- Target address: Object Storage IP confirmed in ①
- Direction : Outbound
- Service: TCP 80, 443 (80 when using http / 443 when using https)
If each service’s status is as follows, granting and revoking access to service resources is possible. If the status is not as listed, previously granted service resources may also be affected.
- Virtual Server/GPU Server: Build, Building, Networking, Scheduling, Block_Device_Mapping, Spawning, Deleting, Error and other states
- Bare Metal Server/Multi-node GPU Cluster: Running, Starting, Stopping, Stopped
- VPC Endpoint: Active
- PostgreSQL/MariaDB/MySQL/EPAS/Microsoft SQL Server: Running
- Select the server to allow access, and click the Confirm button.
- Check the added server in the Object Storage Details page’s Access Control > Allow Service Resources list.
- If you modify the service resource allowance, it may take up to 30 seconds for the changes to be applied.
- Service resources are allowed up to a maximum of 150.
Allow access to Cloud Functions service
If access control on the bucket is set to enabled, you can allow the Cloud Functions service to access Object Storage.
To allow access to the Cloud Functions service from Object Storage, follow these steps.
- Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) for which you want to set access control. You will be taken to the Object Storage Details page.
- On the Object Storage Details page, verify that access control is enabled.
- Access Control is Disabled, click the Edit button, then in the Access Control popup, change Access Control to Enabled.
- When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
- In the Enable Cloud Functions service, click the Edit button. The Edit Cloud Functions service popup opens.
- After checking Allow, click the Confirm button.
- Once the access permission settings for the Cloud Functions service are completed, the Cloud Fuctions service can retrieve the Java Runtime executable stored in Object Storage.
- In the Cloud Functions service, see Java Runtime 코드 변경하기 for how to load the Java Runtime executable.
South Korea (kr-south) region constraints
- The South Korea (kr-south) region does not provide the Cloud Functions service, so the Allow Cloud Functions Service feature cannot be used.
3.2.2 - File and Folder Management
If you need to manage tasks such as storing files in the created Object Storage or downloading stored files, you can perform the operations on the Object Storage Details and Folder List pages.
Create new folder
A new folder may need to be created to store new data in the bucket.
To create a new folder in Object Storage, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) where you want to create a new folder. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the New Folder button. The New Folder popup window opens.
- Enter the folder name to use, and click the Confirm button. A popup indicating that a new folder has been created will appear.
- Folder names must not contain prohibited special characters. For more details, see Folder Name Creation Rules.
- The total path length, including the folder name, file name, and delimiter (
/), must be limited to within 1,024 bytes (based on UTF-8 encoding).
- After clicking the Confirm button, check the created folder in the Folder List.
Upload File
- South Korea Region 3 (kr-south3) constraints
- File upload and download capabilities are limited through the Samsung Cloud Platform Console.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region constraints
- To access the public URL, you must allow a separate firewall configuration.
- You can view the public URL address on the Object Storage details page. Refer to Check Object Storage details.
You can upload a new file or a file you are working on to the bucket. Object Storage Follow the steps below to upload files.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) to upload files. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the File Upload button. The File Upload popup opens.
- After clicking the Attach File button, select the file to upload or drag the file to attach into the popup window.
- You can upload up to three attachment files, each not exceeding 3 GB.
- The attached file name must not contain prohibited special characters. For more information, refer to File Name Creation Rules.
- The total path length, including the folder name, file name, and separator (
/), must be within 1,024 Bytes (based on UTF-8 encoding). - If a duplicate file exists, you cannot upload.
- If you have selected all files, click the Upload button.
- If the upload was successful, check the file in the folder list.
Download File
- South Korea Region 3 (kr-south3) constraints
- File upload and download capabilities are limited through the Samsung Cloud Platform Console.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region restrictions
- To access the public URL, you must allow a separate firewall configuration.
- You can view the public URL address on the Object Storage details page. Refer to Check Object Storage details.
You can download files stored in the bucket. Object Storage Follow these steps to download the file.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) you want to download. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the More > Download button located at the far right of the file. The file download will begin.
- Verify that the file download has completed in the browser.
View file information
You can retrieve information about files stored in the bucket. Object Storage Follow the steps below to retrieve file information.
- All Services > Storage > Object Storage Click the menu. Navigate to the Service Home page.
- Click the Object Storage menu on the Service Home page. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) that contains the file you want to view information for. You will be taken to the Object Storage Details page.
- Click the Folder List tab. You will be taken to the Folder List page.
- Click the More > File Info button located at the far right of the file you want to view information for. The File Info popup window will open.
- File Information Check detailed file information in the popup window.
Category Detailed description filename File name Content type Object type Total size File size Modification date and time The most recent modification date and time of the file Permission Whether to allow Public Access URL Provide Public and Private addresses to enable access to file paths via URL - Public: Provided to allow access from external internet networks
- Private: Provides an address accessible from resources created in the same account and region of the Samsung Cloud Platform Console
Table. File information items
Copy file
You can copy a file stored in a bucket to the same location. To copy a file, follow these steps.
- Click the Storage > Object Storage menu. Navigate to the Object Storage List page.
- Object Storage List page, click the resource (bucket) to copy the file. You will be taken to the Object Storage Details page.
- Click the Folder List tab. You will be taken to the Folder List page.
- Click the More > Copy File button at the far right of the file to be copied. The Copy File popup window will open.
- Enter the filename, then click the OK button. A popup indicating file copying will appear.
- Only files whose full path—including bucket name, folder name, file name, and delimiter (
/)—is 1,024 Bytes (based on URL encoding) or less can be copied. - In the Samsung Cloud Platform Console, you can only copy files when the file size is 5 GB or less. If the file size exceeds 5 GB, you can copy it using the S3 API.
- You can copy within the same bucket and folder.
- If the bucket does not use versioning, a file with the same name in the folder will be overwritten.
- After clicking the Confirm button, check the copied file in the Folder List.
Delete files and folders
You can delete files and folders stored in the bucket. Object Storage Follow the steps below to delete files and folders.
- When a folder is deleted, all subfolders and files inside it are also deleted.
- When a file is deleted, all versions are deleted at once.
- Files with object lock (WORM) enabled cannot be deleted.
- Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) that contains the file or folder you want to delete. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the More > Delete button located at the far right of the file or folder you want to delete. The Delete popup window will open.
- After selecting multiple files or folders using the checkboxes on the left, you can delete them all at once by clicking the Delete button at the top.
- Click the Confirm button in the delete popup to complete deletion.
- Check that files or folders have been deleted from the Folder List.
3.2.3 - Version Management
By enabling versioning on a bucket, you can track the history of file modifications when uploading files with the same name. You can also view the file’s version list and download previous versions of the file from the list.
Setting up version control
You can enable versioning on the bucket.
Object Storage To set up versioning, follow the steps below.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) for which you want to configure versioning. You will be taken to the Object Storage Details page.
- On the Object Storage Details page, verify whether Versioning is unused.
- If Version control is unused, click the Edit button. The Edit version control popup window opens.
- After checking version management as Enabled, click the Confirm button. On the Object Storage Details page, Version Management will be changed to Enabled.
- When you configure version control for the first time, it may take some time for changes to be applied.
- The time required may vary depending on the size of the bucket. Work performed before the configuration is completed may not have the version applied.
Check version list
From the moment version control is configured, you can view and manage versions of file uploads and modifications.
- Version control for file uploads and edits is available from the moment version control is configured.
- All files have a version ID. However, before version control is configured, the version ID is null(-), and files uploaded after version control is set up are assigned a generated version ID.
- For example, if you upload a file with the same name to the same location, the file name remains the same, but a new version file with a different version ID appears in the version list.
Object Storage To check the version list of a file, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) that contains the file whose version list you want to view. You will be taken to the Object Storage Details page.
- Click the Folder List tab. The folder and file list will be displayed.
- In the folder and file list, click the More > Version List button located at the far right of the file whose version list you want to view. The Version List popup will open.
Category Detailed description filename File name Modification date File modification date and time Version ID Version ID assigned to each individual file - Before version control is enabled, the version ID of saved files is displayed as null(-)
- Files saved after version control is enabled are assigned a unique version ID
- If a file with the same name is uploaded to the same location, a version ID is generated, a versioned file is added, and it can be viewed in the version list
Etag Object that identifies files, specific version Size Version file size More Provides version file download and delete functions as additional features - File Download: Download the file of the selected version
- To restore a file to a previous version, download the previous version and re‑upload it
- Delete: Delete the file of the selected version
- If all version files are deleted, the original file will also be deleted
- To retain the original file, at least one version must be kept
Delete Delete file - Enable the button when selecting the checkbox of the version file to delete from the list
Table. Version list popup items
Download version file
- South Korea Region 3 (kr-south3) constraints
- File upload and download capabilities are limited through the Samsung Cloud Platform Console.
- Use of the S3 API/CLI via a public URL is restricted.
- However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
- South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region restrictions
- To access the public URL, you must allow a separate firewall configuration.
- You can view the public URL address on the Object Storage details page. Refer to Check Object Storage Details.
You can download the version file. To download the version file of a Object Storage file, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource (bucket) that contains the version file to download. You will be taken to the Object Storage Details page.
- Click the Folder List tab. The folder and file list will be displayed.
- In the folder and file list, click the More > Version List button located at the far right of the file for which you want to download the version file. The Version List popup window will open.
- Click the More > File Download button located at the far right of the version file. File download will start.
- Verify that the file download has completed in the browser.
Delete version file
You can delete a file’s version list.
- If you delete all version files, the original file will also be deleted. To avoid deleting the original file, you must keep at least one version.
- Version files with object lock (WORM) enabled cannot be deleted.
Object Storage To delete a file’s version list, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List: Click the resource (bucket) that contains the versioned file you want to delete. You will be taken to the Object Storage Details page.
- Click the Folder List tab. The folder and file list will be displayed.
- In the folder and file list, click the More > Version List button located at the far right of the file whose version list you want to delete. The Version List popup window will open.
- Click the More > Delete button at the far right of the version file you want to download. Deletion will be completed.
3.2.4 - Permission Management
Each file is provided with Private permission by default, and each file can be changed to Public permission through permission settings. Private permission allows file access and download only to users who know the Access Key and Secret Key, whereas Public permission allows anyone worldwide to access and download the file via its Public URL, so caution is required.
Check permission management
You can check the file’s permission settings.
Object Storage Follow the steps below to verify file permissions.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource (bucket) that contains the file whose permissions you want to check. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the More > File Info button located at the far right of the file you want to view file information for. The File Info popup window will open.
- Check the Permissions in the File Information popup window.
Category Detailed description Permission Public Access allowed or Public Access not allowed Table. Permission information description
Allow Public Access
You can set the file’s Public Access permission to Allow. To set the file permissions of Object Storage to allow Public Access, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page: click the resource (bucket) that contains files to allow Public Access. You will be taken to the Object Storage Details page.
- Click the Folder List tab. Navigate to the Folder List page.
- Click the More > File Info button located at the far right of the file you want to view information for. The File Info popup window will open.
- Check that Permission is in Public Access not allowed state, then click the Confirm button.
- Click the More > Permission Management button located at the right end of the file. The Edit Permission Management popup window opens.
- Edit Permission Management popup window, check Permission Management’s Allow Public Access, and click the Confirm button. You will be taken to the Folder List page.
- Click the More > File Info button at the far right of the file. The File Info popup opens.
- Check that Permission is Public Access allowed.
Please enable file sharing only when it is absolutely necessary.
3.2.5 - Replication Policy Management
Replication can be performed on a bucket in a different location or the same location.
You can configure multiple replication policies, and if the source bucket becomes unavailable due to a failure or disaster, you can provide the service through the replica bucket.
- The replication feature operates in a 1:N structure, allowing replication within a region or between regions. When performing cross‑region replication, data transfer fees are added.
- The replication feature applies only to files uploaded after the replication policy is set.
- Deleting the versioned file in the source does not delete the files in the replica bucket.
- Example: When configured from Bucket A → Bucket B, even if the version files in Bucket A are deleted, they remain in Bucket B.
- Bidirectional replication can be configured.
- Example: When configured as Bucket A ↔ Bucket B, files uploaded to Bucket A are replicated to Bucket B, and files uploaded to Bucket B are replicated to Bucket A.
- The duplicated file is not duplicated.
- Example: When configured as Bucket A → Bucket B → Bucket C, files replicated from Bucket A → Bucket B are not replicated from Bucket B → Bucket C.
Add replication policy
- You can configure replication on the created bucket.
- To add a replication policy, you must set the version control feature to enabled.
- Refer to Configure Version Management for how to configure the version management feature.
To add a replication policy, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource to which you want to add a replication policy. Then navigate to the Object Storage Details page.
- Click the Clone tab.
- Click the Add button. The Add Replication Policy popup opens.
- After entering the policy information, click the Confirm button. A popup notifying the creation of a replication policy will appear.
| Category | Required or not | Detailed description |
|---|---|---|
| Policy Name | Required | Enter the name of the replication policy
|
| Clone location | Required | Select replication location (region)
|
| Replication bucket name | Required | Select the name of the replica bucket
|
| target file | Required | Select files to duplicate
|
| Delete marker duplication | Select | Whether to use delete marker replication |
- Click the Confirm button. The replication policy will be added.
If there is an invalid policy, you cannot add a replication policy.
- Example: If a replication bucket has been deleted but its policy remains, you cannot add a replication policy.
Modify Replication Policy
You can modify the replication location, replication bucket name, and target file of the replication policy.
- To modify the replication policy, you must set the versioning feature to enabled.
- Refer to Configure Version Management for instructions on configuring the versioning feature.
To modify the replication policy, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource to edit the replication policy. You will be taken to the Object Storage Details page.
- Click the Clone tab.
- In the replication policy list, click the More > Edit button of the policy you want to modify. The Edit Replication Policy popup window will open.
- After modifying the replication policy information, click the Confirm button. A popup notifying the replication policy modification will appear.
| Category | Required? | Detailed description |
|---|---|---|
| Clone location | Required | Select the replication location (region)
|
| Replication bucket name | Required | Enter the name of the replicated bucket
|
| target file | Required | Select files to replicate
|
| Delete marker duplication | Selection | Whether to use delete marker replication |
- Click the Confirm button. The replication policy update is complete.
If there is an invalid policy, you cannot add a replication policy.
- Example: If a replication bucket has been deleted but its policy remains, you cannot add a replication policy.
Changing Replication Policy Status
You can enable or disable the replication policy to change whether it is executed.
To change the replication policy status, follow the steps below.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource whose replication policy status you want to change. You will be taken to the Object Storage Details page.
- Click the Clone tab.
- From the replication policy list, click the More > Enable or More > Disable button for the policy whose status you want to change. A popup will appear notifying you of the replication policy status change.
- Enabled: Performs replication according to the replication policy.
- Disabled: Stops replication.
- Click the Confirm button. The status of the replication policy will change.
Delete replication policy
You can delete unused replication policies.
To modify the replication policy, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- Object Storage List page, click the resource to delete the replication policy. Go to the Object Storage Details page.
- Click the Clone tab.
- In the replication policy list, click the More > Delete button for the policy you want to modify. A popup notifying you of the replication policy deletion will appear.
- Click the Confirm button. The replication policy will be deleted.
- If you change the versioning setting of the source and replica buckets, replication will not function properly.
- If versioning on the source bucket is set to disabled, replication is not performed. Setting it to enabled will replicate files uploaded after the setting.
- If you set versioning of the replica bucket to disabled, replication will be performed but versioning is not possible. If you set it back to enabled, versioning will apply from the point of configuration onward.
- If you delete the source bucket, the configured replication policy will also be deleted.
- If you delete the replica bucket, the replication policy configured on the source bucket is retained.
- If you recreate a replication bucket with the same bucket name as a deleted replication bucket, replication will be performed to that bucket.
Activating ServiceWatch Replication Metrics
By default, Object Storage is integrated with ServiceWatch and basic monitoring. To link Object Storage replication metrics to ServiceWatch, you must enable ServiceWatch replication metric. For more information about ServiceWatch, see ServiceWatch Overview.
- Basic monitoring is provided at no cost, but enabling replication metrics as a detailed monitoring item incurs additional fees.
- The ServiceWatch replication metric, when configured once per bucket, applies to all replication policies of that bucket.
To enable the ServiceWatch replication metric for Object Storage, follow these steps.
- Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
- On the Object Storage List page, click the resource to enable ServiceWatch replication metrics. Then go to the Object Storage Details page.
- Click the Replication tab on the Object Storage Details page. Proceed to the Replication tab.
- Click the Edit button for the ServiceWatch replication metric. You will be taken to the Edit ServiceWatch replication metric popup.
- ServiceWatch Replication Metric Edit In the popup window, after selecting Enable, review the instructions and click the Confirm button.
- In the Replication tab, view the ServiceWatch replication metric items.
Disabling ServiceWatch Replication Metrics
To disable the ServiceWatch replication metric for Object Storage, follow these steps.
- Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
- On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage list page.
- On the Object Storage List page, click the resource to disable ServiceWatch detailed monitoring. Navigate to the Object Storage Details page.
- On the Object Storage Details page, click the Replication tab. Navigate to the Replication tab.
- Click the Edit button for the ServiceWatch replication metric. You will be taken to the Edit ServiceWatch replication metric popup.
- ServiceWatch Replication Metric Edit In the popup window, after deselecting Enable, review the guidance text and click the Confirm button.
- In the Replication tab, check the ServiceWatch replication metric items.
3.3 - Release Note
Object Storage
- ServiceWatch service integration provision
- You can monitor data through the ServiceWatch service.
- The replication feature of Object Storage has been added.
- You can perform replication to buckets in a different location or the same location, and you can configure multiple replication policies.
- File copy feature has been added.
- You can copy the desired file within the same bucket and folder.
- The Cloud Functions service has been added to access control.
- You can upload a Java Runtime executable to Cloud Functions.
- The replication feature of Object Storage has been added.
- You can perform replication to buckets in a different location or the same location, and you can configure multiple replication policies.
- File copy feature has been added.
- You can copy the desired file within the same bucket and folder.
- The Cloud Functions service has been added to access control.
- You can upload a Java Runtime executable to Cloud Functions.
- A server resource target product has been added to Object Storage access control.
- Multi-node GPU Cluster, PostgreSQL, MariaDB, MySQL, EPAS, Microsoft SQL Server
- Presigned URL functionality has been added.
- You can download the file using a Presigned URL for the configured duration.
- You can perform Copyobject on encrypted files.
- Additional versions of the Amazon S3 SDK and Amazon S3 CLI are now available.
- Object Storage feature change
- You can use Object Storage from external networks via a VPC Endpoint connection.
- Samsung Cloud Platform Common Feature Changes
- Account, IAM, Service Home, tags, and other common CX changes have been applied.
- We have launched an object storage service that simplifies data storage and retrieval.
- We have launched Object Storage, a service that provides space (buckets) for economically storing large volumes of data.
4 - Archive Storage
Data stored in Object Storage is automatically transferred to Archive Storage for retention and can be easily restored when needed.
4.1 - Overview
Service Overview
Archive Storage is a storage service suitable for long-term retention of large amounts of data. The user can set a schedule to automatically move infrequently accessed data stored in Object Storage to Archive Storage, enabling efficient storage configuration and cost management. Additionally, upon user request, data stored in Archive Storage can be restored to Object Storage for use.
Features
Free Capacity Usage: When you create a bucket in Archive Storage, the bucket automatically expands or contracts based on the user’s data archiving and deletion. There is no cost for creating a storage bucket; you are only charged for storage usage.
Stable Data Recovery: Data that has been stored long-term can be searched and reliably recovered within three hours. During data recovery, select the target file and the Object Storage bucket where you want to store the data to recover it.
Cost Efficiency: By configuring Object Storage and Archive Storage efficiently according to the purpose and frequency of data usage, you can store and manage data at a reasonable cost.
Convenient Use: You can conveniently use features such as creating buckets, setting archiving schedules, and data recovery in the Samsung Cloud Platform Console. After migrating data for all files in Object Storage, you can apply a source deletion policy.
Configuration diagram
Provided features
Archive Storage provides the following features.
- Archiving Plan Configuration: Set a schedule to perform Archiving on all files in the Object Storage bucket.
- Data Recovery: You can recover to the target Object Storage bucket and folder using folders or files stored in Archive Storage.
- Archiving status monitoring: You can check the Archiving status (success, cancelled, failed, in progress, pending, skipped).
- Recovery status monitoring: You can view the recovery status (success, canceled, failed, in progress, pending).
- Encryption: When encryption is set to enabled, encryption is provided via the SSE‑S3 method.
- Version Management: You can manage archived files by version and restore a selected version.
- ServiceWatch Service Integration: You can monitor data using the ServiceWatch service.
Component
Authentication key
To create and access the Archive Storage service in the Samsung Cloud Platform Console, an authentication key is required. Therefore, to use Archive Storage, you must create an authentication key.
Bucket
A bucket is the top-level folder, and all folders and files reside under the bucket. When you create an Archive Storage service in the Samsung Cloud Platform Console, a bucket is created, and you can then upload folders or files.
The bucket name creation rules are as follows.
- Bucket names must be at least 3 characters and at most 63 characters.
- Bucket names can only be composed of lowercase English letters, numbers, periods
., and hyphens-. - Bucket names must start with a lowercase letter or a digit.
- Bucket names must not contain two consecutive periods.
- Bucket names cannot end with a period or hyphen.
- Bucket names cannot have a period and a hyphen adjacent to each other.
- Bucket names do not use the IP address format (e.g., 192.168.x.x).
- The bucket name cannot be admin.
- Bucket names must be unique within an Account/Region.
- The bucket name you previously used will be available after 1 hour.
| Example of a valid bucket name | Example of an invalid bucket name |
|---|---|
The following bucket names can be used
| The following bucket names cannot be used
|
folder
A folder (Folder) is used to logically group files.
The folder naming rules are as follows.
- Folder names can consist of Korean characters, English letters, numbers, and special characters.
- The special characters that cannot be entered are listed below.
| Special characters that cannot be used in folder names |
|---|
|
File
File (File) refers to data stored in Archive Storage and is the same as a regular file.
The filename generation rules are as follows.
- Filenames can consist of Korean characters, English letters, numbers, and special characters.
- The special characters that cannot be entered are listed below.
| Special characters that cannot be used in file names |
|---|
|
Folder names and file names are separated by slash /. The following are examples of valid folder and file names.
| Example of mixed use of folder names and file names |
|---|
|
/), must be within 1,024 bytes (based on UTF-8 encoding).Constraints
The limitations of Archive Storage are as follows.
| Category | description |
|---|---|
| Number of creatable Archive Storage services | 1000 or fewer |
| File name length (including path) | up to 1,024 Bytes |
Preceding Service
This is a list of services that must be pre‑configured before creating the service. Please refer to the guide provided for each service for details and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Storage | Object Storage | Object storage that simplifies data storage and retrieval |
4.1.1 - ServiceWatch Metrics
Archive Storage sends metrics to ServiceWatch. The metrics provided by default monitoring are data collected at 5‑minute intervals.
Basic Metrics
The following are the basic metrics for the Archive Storage namespace.
The indicators whose names are shown in bold below are the key indicators selected from the basic metrics provided by Archive Storage. Key metrics are used to configure service dashboards that are automatically generated for each service in ServiceWatch.
Each metric indicates, via the user guide, which statistical value is meaningful when viewing that metric, and among the meaningful statistics, the values shown in bold are the primary statistics. In the service dashboard, you can view key metrics using these primary statistical values.
| Performance items | Detailed description | unit | Meaningful statistics |
|---|---|---|---|
| object_count | Number of objects stored in the bucket | Count |
|
| object_byte | Amount of data stored in the bucket | Bytes |
|
4.2 - How-to guides
Users can create a service by entering the required information for Archive Storage and selecting detailed options through the Samsung Cloud Platform Console.
Create authentication key
To create and use the Archive Storage service in the Samsung Cloud Platform Console, you need to generate an authentication key in advance.
You can generate an authentication key at My menu > My Info. > Authentication Key Management > Create Authentication Key. For more information, refer to IAM > Create Authentication Key.
- The authentication key is used not only for Archive Storage but also for authentication in OpenAPI and CLI.
- You can generate up to two authentication keys.
- If the authentication key expires, access to the Archive Storage service will be restricted. To ensure smooth service usage, check the key’s expiration period in advance.
- If you disable the authentication key, access to the Archive Storage service will be restricted.
Create Archive Storage
You can create and use the Archive Storage service in the Samsung Cloud Platform Console.
To create Archive Storage, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Create Archive Storage button. You will be taken to the Create Archive Storage page.
- Archive Storage creation page, enter the information required to create the service, and select detailed options.
Category Required statusDetailed description Bucket name Required Bucket name for performing archiving - must start with a lowercase letter or digit and use lowercase letters, digits, dash
-, period.to enter 3~63 characters
- period
.cannot appear consecutively two or more times
- period
.and dash-cannot be adjacent
- period
.or dash-cannot be used to terminate
- IP address format not allowed
- admin name not allowed
- cannot use a bucket name already in use in the same region within the Samsung Cloud Platform Console
- For more details about buckets, see Bucket Naming Rules for reference
Table. Archive Storage service information input fields - must start with a lowercase letter or digit and use lowercase letters, digits, dash
- Summary Check the detailed information and estimated billing amount created in the panel, and click the Create button.
- Once creation is complete, check the created resources on the Archive Storage List page.
- After creating the bucket, configure encryption and versioning for secure data management.
- Encryption and versioning can be configured on the Archive Storage Details page. For more information, see Archive Storage Encryption Settings and Version Management Settings.
View Archive Storage details
Archive Storage Details page consists of Detail Information, Folder List, Archiving History, Recovery History, and Tag tabs.
Follow these steps to view detailed information about the Archive Storage service.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- Archive Storage List page, click the resource to view detailed information. You will be taken to the Archive Storage Details page.
- Archive Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Archiving History, Recovery History, and Tags tabs.
Category Detailed description Archive Storage status Archive Storage status information - Active: available
- Error: abnormal state while being terminated
- Deleting: service termination in progress
Service termination Button to cancel the service Table. Archive Storage status information and additional features
- Archive Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Archiving History, Recovery History, and Tags tabs.
Detailed information
Detailed Information tab allows you to view the resource’s detailed information and edit it if needed.
| Category | Detailed description |
|---|---|
| Service | Service group |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource name | Resource Name
|
| Resource ID | Service’s unique resource ID |
| Bucket name | User-created bucket name |
| Usage | Total data usage of the bucket |
| Encryption | Encryption usage information
|
| Version control | Version management usage information
|
| Archiving Policy | Check the configured archiving target and policy actions
|
| Archiving target | Object Storage bucket for archiving |
| Policy work | Archiving policy list
|
- Archiving target can be set only once initially. After setting, it cannot be modified.
- The policy operation performs archiving on all versioned files in Object Storage.
- The archiving policy can only be modified and cannot be deleted.
- The archiving policy is executed once daily, based on the time of addition.
Folder list
Folder List tab allows you to view the list and size of folders that have been archived.
| Category | Detailed description |
|---|---|
| Name | Name of the file or folder that was archived
|
| size | Size of archived files or folders |
| Modification date and time | Last modified date and time of a file or folder |
| More button | Manage selected files or folders
|
Archiving History
Archiving History tab allows you to view the list of archiving performed over a specific period.
| Category | Detailed description |
|---|---|
| Query period | Select the period to view the archiving history
|
| status | Select Archiving status
|
| Policy ID | Archiving policy ID
|
| Execution time | Archiving start time |
| Completion date and time | Archiving completion time |
| status | Archiving status information |
| Cancel | Cancel Archiving Task
|
| Search area |
- Query Period: Select the period to view the Archiving history
- You can query up to a maximum of 90 days
- Status: Select the Archiving status
- All, In Progress, Success, Failure, Canceled, Pending, Skipped can be selected
Recovery History
In the Recovery History tab, you can view the list of Archives that performed recovery operations over a specific period.
| Category | Detailed description |
|---|---|
| Query period | Select the period to view the recovery history
|
| status | Select recovery status
|
| Recovery target | Recovery target Object Storage name
|
| Recovery date and time | Recovery start time |
| Completion Time | Recovery Completion Time |
| status | Recovery status information |
| Cancel recovery operation | Cancel recovery operation
|
Tag
In the Tag tab, you can view the resource’s tag information, and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Archive Storage Encryption Configuration
You can configure the bucket to encrypt the data stored in it. After enabling bucket encryption, the encryption settings are applied to uploaded data. When encryption is used, the SSE‑S3 encryption key method and the AES256 encryption algorithm are applied.
Archive Storage’s bucket encryption can provide two options (SSE-S3/SSE-KMS).
- SSE-S3 is server-side encryption (SSE-S3) that uses Amazon S3 managed keys.
- SSE-KMS is server-side encryption (SSE-KMS) that uses Key Management Service (KMS) keys.
- In this service, server-side encryption using Amazon S3 managed keys (SSE‑S3) is released as the default method, and server-side encryption using Key Management Service (KMS) keys (SSE‑KMS) will be offered later according to the service roadmap.
If there is data that was stored before the bucket encryption was configured, the encryption setting will not be applied.
- If you re‑upload the file, the encryption will be applied.
- To enable encryption for existing data, you need to re‑upload it.
To set up encryption, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage List page, click the resource (bucket) to use for encryption. You will be taken to the Archive Storage Details page.
- On the Archive Storage Details page, verify that Encryption is Not Used, then click the Edit button. The Edit Encryption popup opens.
- After checking the use of encryption, click the Confirm button.
Archive Storage Terminate
To cancel Archive Storage, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage list page, select the resource to cancel, and click the Cancel Service button.
- After termination is complete, verify on the Archive Storage List page that the resource has been terminated.
4.2.1 - Manage Archiving Policy
You can add, modify, or delete archiving policies.
Add Archiving Policy
To add an Archiving policy, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage List page, click the resource to view detailed information. You will be taken to the Archive Storage Details page.
- Click the Add button of Policy Task. The Archiving Policy Add popup opens.
- After entering the Archiving policy information, click the Confirm button.
Category Detailed description Archiving target Select the Object Storage bucket for archiving - Cannot be modified after initial configuration
- Only buckets within the same region can be added
- Buckets used in policies of other Arcvhie Storage cannot be selected
target file Select files for archiving - Only All can be selected
Policy work When selected, archiving is performed on all versioned objects in Object Storage - When Archive Storage version management is enabled: each version is managed separately
- When Archive Storage version management is disabled: managed by overwriting the current version
execution time Enter the archiving execution point - Enter a number between 1 and 3,650
Table. Archiving policy addition popup items
- Archiving target can be set only once initially. After setting, it cannot be modified.
- The policy operation performs archiving on all versioned files in Object Storage.
- The archiving policy can only be modified and cannot be deleted.
- The archiving policy is executed once daily, based on the time of addition.
- Cannot set an additional policy when the target files for the Archiving policy are set to All.
Modify Archiving Policy
To modify the Archiving policy, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage List page, click the resource to view its details. You will be taken to the Archive Storage Details page.
- Policy Actions In the list, select the policy you want to edit, then click the More > Add button on the right. The Edit Archiving Policy popup opens.
- After editing the Archiving policy information, click the Confirm button.
Delete Archiving Policy
To delete the Archiving policy, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. Go to the Archive Storage List page.
- Archive Storage List page: Click the resource to view detailed information. You will be taken to the Archive Storage Details page.
- From the Policy actions list, select the policy you want to delete, then click the More > Delete button on the right. The Delete Archiving Policy popup opens.
- After reviewing the Archiving policy information, click the Confirm button.
–>
Change Archiving Policy Status
You can enable or disable the Archiving policy to control whether it is executed.
To change the Archiving policy status, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage List page, click the resource whose Archiving policy status you want to change. You will be taken to the Archive Storage Details page.
- From the Policy Actions list, click the More > Activate or More > Deactivate button for the policy whose status you want to change. A popup notifying the change of the Archiving policy status will open.
- Activation: Perform archiving according to the archiving policy.
- Disable: Stops performing archiving.
- Click the Confirm button. The status of the Archiving policy will be changed.
Cancel archiving operation
To cancel archiving, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage list page.
- On the Archive Storage List page, click the resource to cancel the Archiving operation. Then go to the Archive Storage Details page.
- Click the Archive History tab.
- Check whether the status of the Archiving policy to cancel the job in the Archiving history list is Pending or In Progress.
- Click the Cancel button. A cancel confirmation popup will open.
- Click the Confirm button. The Archiving operation will be canceled.
Understanding how Archiving works
The archiving behavior varies by archiving target as follows.
| Archiving target | Detailed description |
|---|---|
| previous version/current version file | Depends on whether versioning is enabled for Archive Storage
|
| File containing Delete Marker version | Delete Marker versions cannot be archived
|
| Empty folder | Folder cannot be created in Archive Storage |
| Folder containing files | Whether the folder is an Object determines whether the folder is deleted from Object Storage after archiving
|
| When there is no target file | Archiving schedule as is
|
| If the target Object Storage bucket is terminated |
|
- Archiving is performed based on the Etag value of the Object Storage file.
- After archiving, Version ID and Modification Timestamp are changed. However, the Etag value remains the same.
4.2.2 - Use Version Management
By enabling versioning on a bucket, you can manage all Object Storage versions in Archive Storage.
Using version control, you can view a file’s version list and select a previous version from the list to restore it.
Setting up version control
To configure the version control feature, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage list page.
- On the Archive Storage List page, click the resource to use the version control feature. You will be taken to the Archive Storage Details page.
- On the Archive Storage Details page, verify that Version Management is Not Used, then click the Edit button.Version Management Edit popup opens.
- After checking Enabled for version management, click the Confirm button. The Version Management on the Archive Storage Details page will be changed to Enabled.
- When you configure version control for the first time, it may take some time for changes to be applied.
- The time required varies depending on the size of the bucket, and versioning may not be applied until the configuration is completed.
Check version list
You can view and manage the list of file versions.
To view and manage the file’s version list, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage list page.
- Archive Storage List page, click the resource to view the version list. Archive Storage Details page will be opened.
- On the Archive Storage Details page, click the Folder List tab.
- Click the More > Version Management button of the file whose version list you want to view. The version list popup will open.
| Category | Detailed description |
|---|---|
| filename | File name under version control |
| Modification date | File modification date and time |
| Version ID | Version ID assigned to each individual file
|
| Etag | Object that can identify a file, specific version |
| Size | Version file size |
| More | Delete or restore the version
|
From the moment version control is configured, you can view and manage the version IDs of archived files.
- Before configuring version control, archived files: the version ID is shown as null(-).
- After configuring version control, the archived file: a version file is added, and a unique version ID is generated and assigned.
Delete version file
To delete unused version files, follow the steps below.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage list page.
- Archive Storage List page, click the resource to view the version list. You will be taken to the Archive Storage Details page.
- On the Archive Storage Details page, click the Folder List tab.
- Click the More > Version Control button of the file whose version file you want to delete. The version list popup will open.
- Click the More > Delete button for the version file you want to delete. The version file will be removed from the version list.
- After selecting all version files to delete, click the Delete button at the top of the list to delete them all at once.
4.2.3 - Archive Recovery
Archive Recovery
- Recovery can be performed on a per-file basis, and the data stored in Archive Storage is not deleted after recovery.
- When restoring an archive file, select the bucket and folder in Object Storage and restore to that location. Before starting the restoration, first verify the Object Storage you intend to restore.
Recover from folder list
If you are not using the version control feature, you can recover by selecting the Archive file from the folder list.
To check and recover the archive file, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- On the Archive Storage List page, click the resource to view detailed information. You will be taken to the Archive Storage Details page.
- Click the Folder List tab.
- Select the folder or file name to restore from the folder list. The Delete button and Restore button appear at the top of the list.
- Click the Restore button. The Archive Restore popup opens.
- After selecting the recovery information, click the Confirm button.
Category Detailed description Bucket name Object Storage bucket name Original location Original file or folder location Recovery target Select the bucket to recover Overwrite Select whether to use the overwrite function - When selecting a bucket in Object Storage with versioning enabled as the recovery target, using the overwrite function stores the existing file with the same name as a previous version
Table. Archive recovery popup items
- Recovery may fail due to character length restrictions on files and folders. For the character length restrictions on files and folders, see the File name creation rules and Folder name creation rules.
- After a recovery failure, if you perform the recovery again using the overwrite function, you may be charged duplicate fees.
Recover from version list
When using the version control feature, you can check a file’s version and restore it to the desired version.
- To view and restore a file’s version, set the version control feature to enabled..
- Refer to Configure Version Management for how to configure the versioning feature.
To restore an Archive file using a version file, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage List page.
- Archive Storage List page, click the resource to view detailed information. You will be taken to the Archive Storage Details page.
- Click the Folder List tab.
- In the folder list, click the More > Version Management button for the file whose version list you want to view. The version list popup will open.
- In the version list, click the More > Restore button for the version file you want to recover. The Archive Restore popup window will open.
- After selecting the recovery information, click the Confirm button.
Category Detailed description Bucket name Object Storage bucket name Original location Original file or folder location Version list Modification timestamp, version ID, Etag, and size information of the version to be restored Recovery target Select the bucket to recover Overwrite Select whether to use the overwrite function - When selecting a bucket in Object Storage with versioning enabled as the recovery target, using the overwrite function stores the existing file with the same name as a previous version
Table. Archive recovery popup items
- Recovery may fail due to character length limits on files and folders. For the character length limits on files and folders, see File Name Creation Rules and Folder Name Creation Rules.
- After a recovery failure, if you perform the recovery again using the overwrite function, you may be charged duplicate fees.
Cancel recovery operation
To cancel the recovery operation, follow these steps.
- Click the All Services > Storage > Archive Storage menu. Navigate to the Service Home page of Archive Storage.
- On the Service Home page, click the Archive Storage menu. You will be taken to the Archive Storage list page.
- On the Archive Storage List page, click the resource for which you want to cancel the recovery operation. You will be taken to the Archive Storage Details page.
- Click the Recovery History tab.
- Verify that the status of the recovery target to be canceled in the recovery history list is Pending or In Progress.
- Click the Cancel button. A confirmation popup for canceling the operation will open.
- Click the Confirm button. The recovery operation will be canceled.
Understanding archive recovery methods
The recovery methods according to the type of recovery are as follows.
| Recovery type | Status description |
|---|---|
| General recovery |
|
| If there are no files to recover (overwrite option not used) | Not shown in the status check list |
4.3 - API Reference
4.4 - CLI Reference
4.5 - Release Note
Archive Storage
- ServiceWatch service integration provision
- You can monitor data through the ServiceWatch service.
- You can manage archived folders or files by version.
- Users can view archived folders or files by version and select a desired version to delete or restore.
- We have launched the Archive Storage service.
- Data stored in Object Storage is automatically transferred to Archive Storage for retention and can be easily restored when needed.
5 - Backup
5.1 - Overview
Service Overview
Backup is a service that backs up and recovers in case of an emergency the user’s data in a safe manner.
Since a backup policy includes the backup target, frequency, retention period, etc., users set a backup plan according to their business environment and requirements.
Features
- Backup Scope: Providing optimal backup and recovery services tailored to various business purposes, ensuring customers’ important data is safely preserved.
- Flexible Policy Configuration: You can set backup policies based on the usage environment and data importance. Users select backup targets and types, and specify retention periods and schedules.
- Backup Network: We minimized potential service impact during backup by using a backup network connection. The backup system and network block unauthorized access through permission management.
- Remote backup: Agentless backup can store backup copies at a different location. If a failure or disaster occurs at the backup site, you can recover using the backup copies stored at the other location.
- Replication: Agent backup can replicate the same backup to another location for storage. The schedule and retention period are set the same as the original, and in case of a failure or disaster at the backup location, recovery can be performed using the backup copy stored at the other location.
Configuration diagram
Provided features
Backup provides the following features.
- Backup target: The user can select the target server for which they want to obtain a backup.
- Backup Save: You can select the storage location for the backup.
- Encryption: AES-256 algorithm encryption is applied.
- Retention Period: You can set the retention period for backups. Backups whose retention period has elapsed are automatically deleted.
- Schedule: This is the automatic backup generation interval.
- Recovery: You can select a backup created at the desired point in time to restore resources.
Component
Backup provides a scheduling feature that automatically creates backup copies at predefined intervals and times. Users set retention periods and other parameters to ensure they can obtain backups from the desired point in time, and depending on the backup target and type, agent configuration may be required.
Backup type
Provides Agentless Backup and Agent Backup, and you can select based on the backup target.
- Agentless Backup: You can back up by creating a Backup service without configuring a separate agent. VM image backups of Virtual Server and GPU Server are considered Agentless Backup.
- Agent Backup: Before creating a Backup service, you need to create a Backup Agent and configure the Agent on the server you want to back up. This applies to filesystem backups.
Backup Category
- Full Backup: Backs up all data.
- Incremental Backup: Backs up data that has changed since the previous backup.
Schedule
Backups are automatically created according to the generation interval set by the user. You can schedule up to 1 Full Backup and up to 6 Incremental Backups.
When using the Immediate Backup feature, you can create a backup at a specific point in time desired by the user, in addition to the scheduled backups.
The backup intervals that can be configured in the schedule are as follows.
Daily: Start Time Select
Every week: day, start time select
Monthly: Week, Day of week, Start time selection
- Start Time: hour (1~23), minute (00, 30) select
- Day: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday Select
- Week: 1, 2, 3, 4, select the final week
Retention period
You can set the retention period for backups created through the Backup service.
The retention period can be selected and applied from 2 weeks (14 days), 1 month (31 days), 3 months (93 days), 6 months (186 days), or 1 year (365 days).
Preceding Service
This is a list of services that must be pre‑configured before creating the service. Please refer to the guide provided for each service for details and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Compute | Virtual Server | Virtual server optimized for cloud computing |
| Compute | Bare Metal Server | High-performance physical server used without virtualization |
5.2 - How-to guides
Users can create a service by entering the required backup information and selecting detailed options through the Samsung Cloud Platform Console.
Create Backup
You can create and use a Backup service in the Samsung Cloud Platform Console.
- If you back up the OS of a Virtual Server or GPU Server using Agent Backup, you can utilize the necessary data after restoring additional storage.
- You can obtain an OS backup by using the image creation feature of Virtual Server and GPU Server.
To create a backup, follow the steps below.
Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
On the Service Home page, click the Create Backup button. You will be taken to the Create Backup page.
On the Backup Creation page, enter the information required to create the service and select detailed options.
Category RequiredDetailed description Backup name Required Backup name - Enter 3 to 30 characters using letters and numbers
- Cannot be edited after service creation
Backup type Required Select Backup Type - (Agentless) VM Image: Perform backup by creating a Backup service without configuring an Agent
- (Agent) Filesystem: Create a Backup Agent service, configure the Agent on the target server, then perform backup by creating a Backup service
- Cannot modify after service creation
Backup Save Required Select storage location for Agentless Backup - One Backup service can be created per storage location
- Servers in the Korea South (kr-south) region can only select the same location
- Cannot modify after service creation
Backup replication Select Select replication option and location for Agent Backup - Replication can only be set when creating the Backup service
- A Backup identical to the original (Backup name, schedule, retention period) is created at the replication location
- The South Korea (kr-south) region is unavailable
- Cannot be modified after service creation
Backup target Required Backup target server - Agentless: Select one pre‑created server from the Virtual Server or GPU Server service
- For GPU Server, the target server location and the backup storage location must be the same
- Agent: Select one pre‑created server from the Virtual Server, GPU Server, or Bare Metal Server service
- Cannot be modified after service creation
Filesystem Required Backup target Filesystem - Enter all or specific Filesystem
- Backup not possible in the following situations
- When the Filesystem used by the operating system is not entered correctly
- When the Filesystem is already registered in another Backup policy
- When it is a File Storage volume
/dev/zero,/dev/null
- When it contains the following special characters per operating system
- Linux:
*<>\
- Linux:
Encryption Required/Optional Encryption status - Agentless: Apply default encryption
- Agent: Choose encryption
- Cannot modify after service creation
Retention period Select Retention period of the recovery target (backup) - Select from 2 weeks (14 days), 1 month (31 days), 3 months (93 days), 6 months (186 days), or 1 year (365 days)
Schedule Select Backup auto-creation schedule - Set 1 Full Backup and up to 6 Incremental Backups
- Select Daily, Weekly, or Monthly
- Daily: Set the start time
- Weekly: Set the day of week and start time
- Monthly: Set the week number, day of week, and start time
- Week number: Choose from 1, 2, 3, 4, or the last week
- Day of week: Choose from Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
- Start time: Select in 30‑minute increments (00–23 hours, 00/30 minutes)
Table. Backup service information input fieldsIn the Summary panel, review the detailed information and estimated billing amount, then click the Create button.
- After creation is complete, check the created resources on the Backup List page.
- When creating or terminating a Virtual or GPU Server, it may take about 180 minutes for the backup target list to be updated.
- Virtual Server’s (Agentless) VM Image backup can be performed to a remote location by selecting a storage location (excluding GPU Server).
- To create a remote backup, create a Backup service at the location where the target server for the backup was created. Select the remote location in the Backup Save item.
- Backup target can have one Backup service per region. Creating Backup services in two or more regions ensures reliability against failures and disasters.
- To optimize backup and recovery speed, set the backup storage location to be the same as the target server’s location.
- File Storage volumes cannot be backed up. Therefore, added File Storage is excluded from backup.
- Agentless Backup is encrypted by default and cannot be modified.
- Agent Backup applies server‑side encryption based on the AES‑256 algorithm when encryption is selected, which may cause a performance degradation of approximately 20 ~ 30%.
- The initial backup is created as a Full Backup regardless of the request details.
- If you select a different region for Backup storage or Backup replication, data transfer fees will be added.
View backup details
The Backup service allows you to view and edit the full resource list and detailed information. Backup Details page consists of Details, Schedule, Backup History, Recovery Targets, Recovery History, Replication, Tags, Operation History tabs.
To view detailed information about the Backup service, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource for which you want to view detailed information. You will be taken to the Backup Details page.
- Backup Details page displays status information and additional feature information, and consists of the Details, Schedule, Backup History, Recovery Target, Recovery History, Replication, Tags, Job History tabs.
Category Detailed description Backup status Backup status information - Creating: In progress
- Available: Creation completed
- Deleting: Service termination in progress
- Editing: Changing settings
- Error: Abnormal state
- Error Deleting: Abnormal state while deleting
- Restoring: In progress
Immediate Backup Create a backup of the current state immediately - For details about immediate backup, see Instant Backup
Service termination Cancel service button Table. Status information and additional features
- Backup Details page displays status information and additional feature information, and consists of the Details, Schedule, Backup History, Recovery Target, Recovery History, Replication, Tags, Job History tabs.
Detailed information
On the Backup List page, you can view detailed information of the selected resource and, if necessary, edit the information.
| Category | Detailed description |
|---|---|
| Service | Service group |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation Date/Time | Service creation timestamp |
| Editor | User who modified the service |
| Modification date | Date and time the service was modified |
| Backup name | Backup name
|
| Category | Distinguish original status regarding duplication |
| Backup type | Backup types related to Agent configuration |
| Encryption | Encryption status |
| Backup target | Backup target server |
| Filesystem | Backup target FileSystem
|
| Retention period | Retention period of the recovery target (backup)
|
Schedule
On the Backup list page, you can view the automatic backup schedule of the selected resources.
| Category | Detailed description |
|---|---|
| Edit schedule | Schedule edit button
|
| Schedule name | Schedule Name
|
| Backup Type | Full, Incremental Backup distinction |
| Backup frequency | User-configured automatic backup generation interval |
- The schedule is based on Asia/Seoul (GMT +09:00).
- The schedule can be set to one Full Backup and up to six Incremental Backups.
- If the status is Available, the schedule can be modified.
- The replica’s schedule is identical to the original and can be viewed in the original.
- If the original is deleted, the replica’s schedule will be removed.
Backup History
On the Backup List page, you can view the immediate Backup and scheduled backup execution history for the selected resources.
| Category | Detailed description |
|---|---|
| Schedule name | Schedule Name
|
| Backup Timestamp | Backup start time |
| Completion date/time | Backup completion time |
| status | Backup status information (success/failure/in progress) |
| Cancel backup | Cancel button during backup
|
- The backup and completion times are based on Asia/Seoul (GMT +09:00).
- Queries can be performed based on the backup timestamp within a maximum of 30 days.
- You can receive a notification when a backup fails and view it in Management > Logging&Audit.
- In clones, the Cancel Backup button is not displayed.
- The backup history for both the primary and replica is provided by the primary.
- Click the Excel Download button at the top of the list to download the retrieved backup history list as an Excel file.
Recovery target
On the Backup list page, you can view the recovery target (backup) of the selected resource.
| Category | Detailed description |
|---|---|
| Schedule | Schedule Name
|
| Backup Timestamp | Backup start time |
| Retention period | Retention period of the recovery target
|
| capacity | Recovery target size |
| Additional features > More | Management buttons for recovery target
|
- Backup time is based on Asia/Seoul (GMT +09:00).
- Queries can be performed based on the backup timestamp within a maximum of 30 days.
- Click the Excel Download button at the top of the list to download the retrieved recovery target list as an Excel file.
Recovery History
On the Backup List page, you can view the recovery execution history of the selected resources.
| Category | Detailed description |
|---|---|
| Schedule | Schedule Name
|
| Recovery server name | Name of the server created through recovery |
| Backup Timestamp | Backup start time of the recovery target used for recovery |
| Recovery date and time | Recovery start time |
| Recovery completion time | Recovery completion time |
| status | Recovery status information (success/failure/in progress) |
- Backup and recovery times are based on Asia/Seoul (GMT +09:00).
- You can query based on the recovery timestamp within a maximum of 30 days.
- You can click the Excel Download button at the top of the list to download the retrieved recovery history list as an Excel file.
Clone
You can view the replication information of the selected resources on the Backup list page.
- Replication tab information is provided only when you set Agent Backup and Backup replication to enabled when applying for the Backup service.
- In the case of Agentless Backup, the replication feature (Replication tab) is not provided, and when applying for the service, you can select a backup storage location to store the backup copy in a different location.
| Category | Detailed description |
|---|---|
| Replication Policy | User-configured replication policy
|
| Replication information | Volume information for original and replica
|
Tag
On the Backup List page, you can view the tag information of the selected resources, and you can add, modify, or delete them.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
On the Backup List page, you can view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Managing Backup Resources
If you need to modify the schedule or retention period of a created backup, cancel the backup, or delete a recovery target, you can perform these actions on the Backup Details, Schedule, and Recovery Target pages.
Edit Retention Period
You can modify the retention period of a backup. To modify the retention period, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup list page.
- On the Backup List page, click the resource whose retention period you want to modify. You will be taken to the Backup Details page.
- Click the Edit button of Retention Period. The Edit Retention Period popup opens.
- Select the retention period and click the Confirm button.
- Please select from 2 weeks (14 days), 1 month (31 days), 3 months (93 days), 6 months (186 days), or 1 year (365 days).
- On the Backup Details page, check the modified retention period.
- Click the Recovery Target page. Check the modified retention period of the recovery targets.
- Agentless Backup: When the retention period is modified, the retention period of all already created backup copies will be changed uniformly.
- Agent Backup: After modifying the retention period, the changed retention period is applied to the generated backup.
Modify Filesystem
You can modify a registered Filesystem. To modify the Filesystem, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- Click the resource whose retention period you want to modify on the Backup List page. You will be taken to the Backup Details page.
- Click the Filesystem Edit button. The Filesystem Edit popup window opens.
- Modify the Filesystem and click the Confirm button.
- After entering the Filesystem to add, click the Add Target button. The Filesystem will be added to the list.
- Click the X button of the Filesystem you want to delete from the Filesystem list. The Filesystem will be removed from the list.
- A filesystem with the same name or a filesystem registered in another backup cannot be added.
- /dev/zero, /dev/null cannot be added to the filesystem.
- If the following special characters are included, recovery is impossible on each operating system.
- Linux:
:*<>|not allowed - Windows:
/?*<>|not allowed
- Linux:
Edit Schedule
You can modify the backup schedule.
To modify the schedule, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource whose schedule you want to edit. You will be taken to the Backup Details page.
- Click the Schedule page. Go to the Backup Schedule page.
- Click the Edit Schedule button. The Edit Schedule popup opens.
- Select a schedule and click the Confirm button.
- Daily, Weekly, Monthly please select one.
- Daily: Set the Start time.
- Every week: Set the day of the week and start time.
- Monthly: Week, Day of the week, Start time. Please set them.
- Week: 1, 2, 3, 4, or the final week.
- Day: You can select from Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
- Start Time: can be selected in 30‑minute intervals (00–23 hours, 00/30 minutes).
- The schedule is based on Asia/Seoul (GMT +09:00).
- The schedule can be set to 1 Full Backup and up to 6 Incremental Backups, and at least one Full Backup schedule must be registered.
- If the status is Available, the schedule can be modified.
- After modifying the schedule, the initial backup is created as a Full Backup regardless of the request details.
- When the original is modified, the same changes are applied to the copy.
Cancel backup
You can cancel an ongoing backup. To cancel the backup, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource to cancel the backup. You will be taken to the Backup Details page.
- Click the Backup History page. You will be taken to the Backup History page.
- Check the backup you want to cancel. If the backup’s status is in progress, you can cancel the backup.
- Click the Backup Cancel button. The Backup Cancel popup window opens.
- Backup name, Backup date and time and other information, then click the Confirm button. The backup will be canceled.
Delete recovery target
You can delete the generated recovery target (backup). To delete a recovery target, follow the steps below.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource to delete the recovery target. Navigate to the Backup Details page.
- Click the Recovery target page. Go to the Backup recovery target page.
- After selecting all items you want to delete, click the Delete button. The Delete popup window opens.
- After confirming Backup schedule name and Backup date/time, authenticate via the logged-in user’s mobile phone.
- When deleting two or more items, only the count of items to be deleted can be viewed in the popup window.
- When authentication is complete, click the Confirm button. The recovery target will be deleted.
- When deletion is complete, check on the Backup recovery target page whether the target has been deleted.
- You can delete two or more recovery targets using multiple selection.
- Even if you delete the original’s recovery target, the replica will not be deleted.
Cancel backup
You can cancel unused backups to reduce operating costs. However, if you cancel the service, the running service may be stopped immediately, so you should thoroughly consider the impact of service interruption before proceeding with the cancellation.
- All saved backup data and history will be deleted. Please note that data cannot be recovered after termination.
- If the status is Available, Error, or Error Deleting, cancellation is possible.
- If you cancel the original Backup service, the replica’s schedule will be deleted, but the stored backup data will not be deleted.
- Agent Backup that uses replication cannot be terminated. Change the replication policy to unused in the source, then terminate.
To cancel the backup, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, select the resource to cancel and click the Cancel Service button.
- Authenticate using the logged-in user’s mobile phone. Once authentication is complete, the service will be terminated.
- When termination is complete, check on the Backup list page whether the resource has been terminated.
5.2.1 - Instant Backup
You can perform an immediate backup at the current time on a generated backup regardless of any schedule settings. You can perform the operation on the Backup Details page.
Instant Backup
You can create a backup of the current point in time immediately. To perform an immediate backup, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- Backup List page, click the resource to perform the backup. You will be taken to the Backup Details page.
- Click the Instant Backup button. The Instant Backup popup opens.
- Click the Confirm button. It will perform a backup immediately.
- Click the Backup History page. Navigate to the Backup History page.
- Check the ongoing backup.
- If the status is Available, backup can be performed immediately.
- Immediate backup is performed as a full backup.
5.2.2 - Recovery
You can perform a restore using the generated backup’s restore target (backup copy). You can perform the operation on the Backup Restore Target page.
Recover VM Image
You can restore using the backup copy designated for recovery.
To recover, follow the steps below.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource to restore. You will be taken to the Backup Details page.
- Click the Recovery Target page. Go to the Backup Recovery Target page.
- After checking the Schedule and Backup date and time, click the More button of the target you want to restore.
- Click the Restore button. The Backup Restore popup window opens.
- After confirming Backup target and Backup time, enter the recovery location, recovery server name, etc.
- Recovery Location: For remote backups, select the recovery location (target server or backup location).
- Recovery Server Name: Enter using English letters, numbers, spaces, and special characters (
-_) within 63 characters. - Server Type: Set the server type.
- Network Settings: If you are restoring to a location different from the backup target server, configure the network on the recovery server.
- Security Group: Configure the Security Group for the recovery server.
- After reviewing the entered information, click Confirm.
- Click the Recovery History page. Go to the Backup Recovery History page.
- Check the ongoing recovery tasks.
- Recovery is possible when the status is Available.
- The original Security Group, NAT IP, and Delete on termination settings are not restored, so configure them after recovery.
- The original server’s Server Group is not applied to the recovery server.
- The restored server cannot use the Rebuild feature.
- During recovery, a new server is created, and the Block Storage type and Keypair are set the same as the original.
Filesystem Recovery
You can restore using the backup copy designated for recovery. To restore, follow the steps below.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource to restore. You will be taken to the Backup Details page.
- Click the Recovery Target page. Go to the Backup Recovery Target page.
- After checking the Schedule and Backup date and time, click the More button of the target you want to restore.
- Click the Restore button. The Backup Restore popup window opens.
- Please check Backup target, Backup time, etc.
- Click the Server Selection button for the recovery target item. The Server Selection popup window will open.
- After selecting a server, click Confirm.
- Only servers with a configured Backup Agent can be selected among the servers created in the backup storage location.
- Only servers that use the same Backup Master and OS as the backup target server can be selected.
- From the list below the Filesystem item, select the Filesystem to recover, then enter the Recovery location.
- If you enter the same ‘Backup target server name’ in the top-level restore location, the entire Filesystem will be restored (e.g., source location: servername, restore location: servername)
- Enter the exact name of the filesystem in use on the OS.
- /dev/zero, /dev/null cannot be recovered when entered.
- Recovery is impossible on any operating system if the following special characters are included.
- Linux:
:*<>| - Windows:
/?*<>|
- Linux:
- Overwrite when selected, files with the same type and name are overwritten. If not selected, those files are excluded from recovery.
- After reviewing the entered information, click Confirm.
- Recovery History click the page. Backup Recovery History navigate to the page.
- Check the ongoing recovery tasks.
5.2.3 - Use Backup Agent
Users can create and manage the Agent required to use Filesystem backup in the Backup service.
Create Backup Agent
You can create and use the Backup Agent service in the Samsung Cloud Platform Console.
To create a Backup Agent, follow the steps below.
Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
On the Backup Agent List page, click the Create Service button. You will be taken to the Create Backup Agent page.
On the Backup Agent Creation page, enter the information required to create the service.
Category RequiredDetailed description target server Required Select the target server to create a Backup Agent - Click the Select button to choose the server for creating the Backup Agent
- Virtual Server: 1 unit, GPU Server: 1 unit, Bare Metal Server: up to 100 units
Subnet Required Backup network (backup IP and port) Subnet - Select one of the General Subnets created in the VPC connected to the target server
- Select when the target server is a Virtual Server or GPU Server
Table. Backup Agent Service Information Input ItemsSummary Check the detailed information generated in the panel, and click the Done button.
- Once creation is complete, check the created resources on the Backup Agent List page.
- After creating the Backup Agent, connect to the target server and install the Agent.
- If the connection status on the Agent installation and Backup Agent details screen is confirmed as successful, you can create a Backup service to back up the filesystem.
- For performance optimization, use the Subnet and Port selected in the Backup Agent exclusively for backup.
- After creating the Backup Agent service, connect to the target server and install the Backup Agent.
- For detailed information about the Backup Agent installation, please refer to Backup Agent Installation.
- After installation is complete, check the connection status on the Backup Agent Details page.
Check detailed information of Backup Agent
Backup Agent service allows you to view and edit the full resource list and detailed information. Backup Agent Details page consists of Detailed Information, Tags, Job History tabs.
To view detailed information about the Backup Agent service, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
- On the Backup Agent List page, click the resource to view detailed information. You will be taken to the Backup Agent Details page.
- Backup Agent Details page displays status information and additional feature information, and consists of the Detailed Information, Tags, Job History tabs.
Category Detailed description Backup Agent status Backup Agent status information - Creating: In progress
- Available: Creation completed
- Deleting: Service termination in progress
- Error: Abnormal state
Service termination Cancel service button Table. Status information and additional functions
- Backup Agent Details page displays status information and additional feature information, and consists of the Detailed Information, Tags, Job History tabs.
Detailed Information
On the Backup Agent List page, you can view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource name | Resource Name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation date and time | Service creation date and time |
| Editor | User who modified the service |
| Modification date | Date and time the service was modified |
| Backup Agent name | Backup Agent name |
| Installation file URL | Agent installation file download location |
| Number of backup policies | Number of Backup services connected to the backup target server |
| Backup Master | Management server (Backup Master) name and connection IP |
| Backup Media | Management server (Backup Media) name and connection IP |
| target server | Backup Agent Target Server Information
|
- After creating the Bacup Agent service, connect to the backup target server and install the Backup Agent.
- For detailed information about the Backup Agent installation, please refer to Backup Agent Installation.
- After installation is complete, check the connection status on the Backup Agent Details page.
tag
On the Backup Agent List page, you can view the tag information of the selected resource and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
On the Backup Agent list page, you can view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Terminate Backup Agent
You can cancel a Backup Agent you are not using.
- Available, can only be terminated when in an Error state.
- If a Backup service is connected to the Backup Agent, it cannot be terminated.
- Backup policy count is the number of Backup services connected to the Backup Agent. After terminating all connected Backups, terminate the Backup Agent.
To cancel the Backup Agent, follow the steps below.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
- On the Backup Agent List page, select the resource to cancel and click the Cancel Service button.
- After termination is complete, check on the Backup Agent List page whether the resource has been terminated.
5.2.4 - Install Backup Agent
To install the Backup Agent, you must first request the Backup Agent service. Refer to Create Backup Agent.
- Backup Agent Apply
- Install Backup Agent
- Register backup in the Backup service
To use an Agent-based backup, you must connect to the target server and install the Backup Agent. After installing the Backup Agent, register the backup through the Backup service.
Pre‑setup work
To install the Backup Agent, verify the installation space, download the Backup Agent files, check the Backup Master/Agent information, and perform other preparatory tasks.
Check backup agent installation space
The required storage for installing the Backup Agent is as follows.
| OS type | Path | Required capacity | Remarks |
|---|---|---|---|
| Linux | /tmp (temporarily used during installation) | 3 GB | When /usr space is insufficient, a separate space can be linked #ln -s separate space /usr/openv |
| Linux | /opt | 3 GB | /usr space is insufficient, a separate space can be linked #ln -s separate space /usr/openv |
| Linux | openv installation path (usually /usr) | 3~5 GB | /usr When /usr space is insufficient, you can link a separate space #ln -s separate space /usr/openv |
| Windows | Veritas installation path (usually C:\) | 3~5 GB | If space on C:\ is insufficient, you can install on another drive. |
| - | installation file | 10 GB |
Download Backup Agent installation file
To download the Backup Agent installation file, follow these steps.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
- On the Backup Agent List page, click the resource for which you want to view detailed information. You will be taken to the Backup Agent Details page.
- After checking the installation file URL, navigate to that URL. You can download the Backup Agent installation file.
Linux OS
If you are using Linux OS, refer to the following example and enter the command.
# cd [다운로드할 위치]
# curl -O 설치파일 → 설치 파일에 복사한 설치 파일 다운로드 URL을 넣어주세요.
Windows OS
If you are using Windows OS, you can download using a web browser or Windows PowerShell.
When using an internet browser
After launching an internet browser, enter the copied installation file download URL into the address bar. Once you navigate to the download page, the download will begin.
- It may take some time to navigate to the download screen.
- If you do not navigate to the download page, use Windows PowerShell to download.
When using Windows PowerShell
- Right-click the Windows Start icon, then run Command Prompt (Admin).
- Run Windows PowerShell in administrator mode.
- Enter the command by referring to the following example.
# wget "다운로드 URL" -OutFile "저장할 파일명"
Check Backup Master and Agent Information
To install the Backup Agent, you need routing settings and Backup Master and Agent information for host file registration. On the Backup Agent Details page, check the Backup Master IP, Backup IP, and Gateway information. Please refer to Check detailed information of Backup Agent.
Configure routing for communication with Backup Master
To communicate with the Backup Master, you must configure routing in the operating system.
Linux OS - CentOS/RHEL
Linux OS - To configure routing on CentOS/RHEL, follow these steps.
- The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
- Backup Master IP: 10.242.8.4
- Backup IP (Agent IP): 10.252.25.4
- Gateway (Agent Gateway): 10.252.25.1
- vlan: 100
- vlan can be configured in the Config file of a Bare Metal Server. For more details, refer to Configure Local Subnet.
- Use the following command to check the backup network Interface information.
- ip a
- bash /usr/local/bin/ip.sh
- Configure routing using the nmcli command.
# nmcli con mod "Vlan bond-srv.100" +ipv4.routes "10.252.8.0/24 10.252.25.1" # nmcli device reapply bond-srv.100 - Check that the routing configuration has been applied correctly.
# telnet [Backup Master명] 1556
Linux OS - ubuntu
Linux OS - To set up routing on Ubuntu, follow the steps below.
- The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
- Backup Master IP: 10.242.8.4
- Backup IP (Agent IP): 10.252.25.4
- Gateway (Agent Gateway): 10.252.25.1
- vlan: 100
- vlan can be configured in the Config file of a Bare Metal Server. For more details, see Local Subnet Configuration.
- Use the following command to check the backup network Interface information.
- ip a
- bash /usr/local/bin/ip.sh
Open the 50-cloud-init.yaml file and configure routing.
# vi /etc/netplan/50-cloud-init.yaml (기존 내용에 routes 내용 추가) network: bonds: ...................... 생략 ethernets: ...................... 생략 vlans: bond.srv.100: addresses: ...................... 생략 routes: - to:10.252.8.0/24 via:10.252.25.1 # netplan applyCheck that the routing configuration has been applied correctly.
# telnet [Backup Master명] 1556
Windows OS
To set up routing on Windows OS, follow these steps.
- The IP, Gateway, and Vlan ID information for the Backup Master and Agent used in the routing configuration example are as follows.
- Backup Master IP: 10.242.8.4
- Backup IP (Agent IP): 10.252.25.4
- Gateway (Agent Gateway): 10.252.25.1
- ifindex: 100
- ifindex can be set in the Config file of a Bare Metal Server. For more details, refer to Setting Local Subnet.
- Right-click the Windows Start icon and then launch Command Prompt (Admin).
- Run Windows PowerShell in administrator mode.
- Use the ipconfig and Get‑NetAdapter commands to check the backup network interface index (ifindex) settings.
# ipconfig /all → Agent IP에 할당된 interface name을 확인하세요. # Get-NetAdapter → 위에서 확인한 interface name 참고해 interface index를 확인하세요.
Set up routing using the NetRoute command.
# Get-NetRoute -ifindex 100 # New-NetRoute -ifIndex 100 -DestinationPrefix 10.252.8.0/24 -NextHop 10.252.25.1Check that the routing configuration has been applied correctly.
# telnet [Backup Master명] 1556
Register Backup Master information in the hosts file
To register Backup Master information in the hosts file, follow these steps.
- Open the host file using a file editing tool.
- Linux operating system: /etc/hosts
- Windows operating system: C:\Windows\System32\drivers\etc\hosts
- Open the hosts file and register the Backup Master and Backup Agent information (IP, name).
- You must add .scpbackup after the Backup Agent name as shown in the following example.
10.252.8.4 takre1p1bkm1 10.252.25.4 agent_tgdrhw.scpbackup
Adding ports for Backup Agent (when using Windows Firewall)
If you are using the Windows firewall, you must add the Backup Agent port for communicating with the Backup Master to the Windows firewall.
The ports and settings to add to the Windows firewall are as follows.
- Inbound Rule: (TCP) 1556, 13724 port
- Action: allow the connection
- Profile: select domain, private, and public
Check if the package is installed (when using RHEL 8)
If you are using RHEL 8, the libnsl package must be installed to install the Backup Agent.
- Use the following command to verify that the libnsl package is installed.
# rpm -qa | grep libnsl - If the libnsl package is not installed, use the following command to install the package.
# yum install libnsl
Installing Backup Agent
Install the Backup Agent appropriate for the operating system.
Linux OS
To install the Backup Agent on Linux OS, follow these steps.
- Backup Agent 10.1.1 After moving to the path where the installation file was extracted, change the permissions of the installation-related files.
# chmod 755 installs # chmod –R 755 NBClients - Run ./install.
- [root@bkclientlin ~]# ./install
- After the install description, when confirming whether to proceed with the installation, enter y and press the Enter key.
Do you wish to continue? [y,n] (y) y - When checking the installation status of Software on the client, enter y and press the Enter key.
Do you want to install the ~~~~~~~~~~~~ software for this client? [y,n] (y) y - When checking the Backup master server name, enter Backup Master name and press the Enter key.
Enter the name of the ~~~~~~ master server : bkmaster - When checking the client server configuration name, enter n and then input the Agent information.
- Agent information required: Backup Agent name.scpbackup (e.g., agent_tgdrhw.scpbackup)
Would you like to use "bkclientlin" as the configured name of the ~~~~~~~ client? [y,n] (y) n agent_tgdrhw.scpbackup - Check the Master Server information, and if there are no issues, enter y.
Master server [bkmaster] reports the following CA Certificate fingerprints: SHA-256 Fingerprint: [BB:38:~~~~~~~~] SHA-1 Fingerpritn: [0D:E6:~~~~~~~] Is this correct [y,n] y - When selecting the Java GUI and JRE option, enter 2. The installation of the Java GUI and JRE packages will be omitted.
Choose an option from the list below. 1) Include the Java GUI and JRE 2) Exclude the Java GUI and JRE Java GUI and JRE option: [1,2] (2) :2 Excluding the installation of Java GUI and JRE packages - Check that the installation completed successfully.
Windows OS
To install the Backup Agent on Windows OS, follow these steps.
- After moving to the folder where the Backup Agent 10.1.1 installation file has been extracted, run the Setup.exe file with administrator privileges.
- If the installation archive contains an EEB directory in the format
NB_10.4.0.1_ETXXXXXX_1, you must perform the patch procedure after installing the Backup Agent, following the steps below.- When the Backup Agent installation is complete, go to the
NB_10.4.0.1_ETXXXXXX_1folder. eebinstaller_XXXXXXX_1_AMD64.exeRun the file with administrator privileges.- If there are multiple files, install all of them.
- When the Backup Agent installation is complete, go to the
- In the popup window for selecting the Client to install, select the Client to install, then click the OK button.
- In the Vertias NetBackup popup, select Yes. The installation popup opens, and the installation steps are displayed on the left side of the popup.
- Welcome When the step description is displayed, click the Next button.
- License Agreement When the step description is displayed, select the Agree with the veritas Software License Agreement item, then click the Next button.
- When the Install Type step description is displayed, make sure the Install to the computer only option is checked, then select the Custom installation option. After completing the selection, click the Next button.
- When the Option step description is displayed, verify the installation path and click the Next button. Client option information is displayed.
- Click the Change… button to change the installation path.
- After checking the Client Options information, click the Next button. The Log on information will be displayed.
- After checking the Log on information, click the Next button.
- Safe Abort Option: This option aborts the installation when a system restart is required (optional).
- When the System Name step description is displayed, enter the server environment information and click the Next button. The Master Server information will be displayed.
- Client Name: Enter the Agent information. Backup Agent Name.scpbackup (e.g.: agent_tgdrhw.scpbackup)
- Master Server Name: Enter the Backup Master name.
- After checking the Master Server information, select the I recognize the fingerprint for this host. Proceed with the certificate deployment. item. When you have finished selecting, click the Next button.
- When the Security step description is displayed, verify that the certificate deployment succeeded, then click the Next button.
- When the Install step description is displayed, review the Installation Summary and then click the Install button.
- When the installation is complete, click the Finish button.
Configure Security Group (Linux/Window)
If backing up a Virtual Server or GPU Server, you must configure a Security Group to communicate with the Backup Master. To configure the Security Group, check the backup information on the Backup Agent Details page and register it with the Security Group attached to the Server.
- IP: Backup Master IP
- Inbound / Outboud / (TCP) 1556, 13724 port
- Action: allow the connection
Check Backup Agent status
After the Backup Agent installation is complete, perform a communication test with the Backup Master and check the status.
Linux OS
Follow these steps to perform a communication test with the Backup Master on Linux OS.
- After entering the following command, perform a communication test with Backup Master and check the results.
- Command: # /usr/openv/netbackup/bin/bpclntcmd -pn
- An example of the communication test inspection results is as follows.
# /usr/openv/netbackup/bin/bpclntcmd -pn expecting response from server takre1p1bkm1 agent_tgdrhw.scpbackup agent_tgdrhw.scpbackup 10.252.25.4 52096
- Click the All Services > Storage > Backup menu in the Samsung Cloud Platform Console. Go to the Service Home page of Backup.
- On the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent List page.
- On the Backup Agent List page, click the resource to verify the communication test. You will be taken to the Backup Agent Details page.
- In the Connection Status item, click the Check Connection Status button. If communication with Backup Master is successful, Success will be displayed.
- Verify that the result values of the Backup Master communication test performed on the OS and the Samsumg Cloud Platform Console are identical.
Windows OS
Follow these steps to perform a communication test with Backup Master on Windows OS.
- After entering the following command, perform a communication test with Backup Master and check the results.
- Command: # [installation path]\Vertitas\NetBackup\bin\bpclntcmd.exe -pn
- An example of the communication test inspection results is as follows.
# C:\Vertitas\NetBackup\bin\bpclntcmd.exe -pn expecting response from server takre1p1bkm1 agent_tgdrhw.scpbackup agent_tgdrhw.scpbackup 10.252.25.4 52096
- In the Samsung Cloud Platform Console, click the All Services > Storage > Backup menu. Navigate to the Service Home page of Backup.
- From the Service Home page, click the Backup Agent menu. You will be taken to the Backup Agent list page.
- On the Backup Agent List page, click the resource to verify the communication test. You will be taken to the Backup Agent Details page.
- In the Connection Status item, click the Check Connection Status button. If communication with Backup Master is successful, Success will be displayed.
- Verify that the result values of the Backup Master communication test performed on the OS and Samsumg Cloud Platform Console are identical.
Delete Backup Agent
If you are not using the Backup Agent, you must remove the Backup Agent installed on each operating system.
Linux OS
To uninstall the Backup Agent on Linux OS, follow the steps below.
- Stop the Backup Agent service.
# /usr/openv/netbackup/bp.kill_all # /opt/VRTSpbx/bin/vxpbx_exchanged stop # /usr/openv/netbackup/bin/vxlogcfg -r -p 51216 - Delete the Backup Agent installation file.
# rpm –qa | grep –i VRTS → Backup Agent package 확인 # rpm –e VRTSnbcfg # /opt/pdde/pddeuninstall.sh –forceclean # rpm -e VRTSnbjava # rpm -e VRTSnbjre # rpm -e VRTSnbclt # rpm -e VRTSpbx # rpm -e VRTSnbpck # rpm -qa | grep -i VRTS → Backup Agent package 확인 후 남은 package 삭제 # rm -rf /usr/openv
Windows OS
To uninstall the Backup Agent on Windows OS, follow these steps.
- Stop the Backup Agent service.
# [설치경로]\Vertitas\NetBackup\bin\bpdown.exe -f -v # [설치경로]\Vertitas\NetBackup\bin\bpps.exe → 남은 Process 확인 후 kill 수행 - From Control Panel > Programs and Features, uninstall the Backup Agent program.
- Delete the Backup Agent installation folder.
5.2.5 - Use Replication
You can create a replica of the Agent Backup in a different location.
- The kr-south region does not provide replication functionality.
- Agentless Backup does not provide a replication feature.
- With Agentless Backup, you can select a backup storage location when applying for the service and store the backup copy in a different location.
Create a clone
When creating a Backup service, you can set up replication for use.
To create a backup, follow the steps below.
- Click the All Services > Storage > Backup menu. Go to the Service Home page of Backup.
- On the Service Home page, click the Create Backup button. You will be taken to the Create Backup page.
- On the Backup Creation page, enter the information required to create the service and select detailed options.
Category RequiredDetailed description Backup name Required Backup name - Enter 3 to 30 characters using letters and numbers
- Cannot be edited after service creation
Backup type Required Agent > Filesystem selection Backup replication Select Use after checking, select the clone location (region) - South Korea (kr-south) region is unavailable
Backup target Required After clicking the Select Server button, select one pre‑created server from the Bare Metal Server service. Filesystem Required Enter the target FileSystem for backup - The exact Filesystem used by the operating system must be entered. Incorrect input will prevent backup
- Backup is not possible when /dev/zero, /dev/null is entered
- Backup is not possible if the following special characters are included, depending on the operating system
- Linux:
:*<>\
- Linux:
Encryption Select Select whether to apply encryption Retention period Selection Retention period of the recovery target (backup) - Select from 2 weeks (14 days), 1 month (31 days), 3 months (93 days), 6 months (186 days), 1 year (365 days)
Schedule Select Backup auto-creation schedule - Set 1 Full Backup and up to 6 Incremental Backups
- Select Daily, Weekly, or Monthly
- Daily: Set the start time
- Weekly: Set the day of week and start time
- Monthly: Set the week number, day of week, and start time
- Week number: Choose from 1, 2, 3, 4, or the last week
- Day of week: Choose from Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
- Start time: Select in 30‑minute increments (00–23 hours, 00/30 minutes)
Table. Backup service information input fields - Summary Verify the detailed information and estimated billing amount generated in the panel, then click the Complete button.
- Once creation is complete, check the created resources on the Backup List page.
- Agent Backup applies server‑side encryption based on the AES‑256 algorithm when encryption is selected, which may cause a performance degradation of approximately 20 ~ 30%.
- The initial backup is created as a Full Backup regardless of the request details.
- Backup replication If you select a location in a different region, data transfer fees will be added.
Edit replication policy
You can change the replication status by modifying the replication policy.
To modify the replication policy, follow these steps.
- Click the All Services > Storage > Backup menu. You will be taken to the Service Home page of Backup.
- On the Service Home page, click the Backup menu. You will be taken to the Backup List page.
- On the Backup List page, click the resource to edit the replication policy. You will be taken to the Backup Details page.
- On the Backup Details page, click the Clone tab.
- Click the Edit button of the Replication Policy. The Edit Replication Policy popup opens.
- Use: Performs replication. If it is not used, you can modify it to be used.
- Unused: Stop backup replication. If unused, the Backup service can be terminated.
- Check the modified replication policy in the Replication tab of the Backup Details page.
5.3 - API Reference
5.4 - CLI Reference
5.5 - Release Note
Backup
- When performing Agent Backup, Virtual Server and GPU Server have been added as target servers.
- Now you can select one of Virtual Server, GPU Server, or Bare Metal Server.
- Add Backup Replication Tab
- In the Backup detail page, you can view the original and replica information on the Replication tab.
- Add download feature for backup-related information
- In the Backup detail page, you can download the Backup history, recovery targets, and recovery history list as an Excel file.
- Expand recovery scope
- When restoring from an agentless remote backup, you can select the restore location (target server or backup location).
- Expand backup location and target
- Agentless-based remote backup: You can back up and restore to a location different from the backup target server.
- Backup Agent feature added: You can back up the filesystem of a Bare Metal Server by configuring the Agent.
- Samsung Cloud Platform Common Feature Changes
- Account, IAM, Service Home, tags, and other common CX changes have been applied.
- We launched the Backup service to provide a secure data backup and recovery solution.
- Since a backup policy includes the target, frequency, retention period, and other elements, users can configure a backup plan to match their business environment and requirements.
6 - Parallel File Storage
6.1 - Overview
Service Overview
Parallel File Storage is a high-performance parallel file storage based on All NVMe that can process large amounts of data quickly and efficiently.
Features
- Data Processing Speed Improvement: Distribute file data across multiple storage nodes to improve data processing speed and reduce analysis time.
- Various Field Utilization: Through fast data processing speed and analysis time, it can be used in various areas such as AI/ML analysis, big data analysis, and more.
Configuration diagram
Provided features
Parallel File Storage provides the following features.
- Volume Name: Users can set a name for each volume.
- Snapshot: Create a snapshot to restore to a specific point in time.
- Connected Resource: Can be connected and used in a Multi-node GPU Cluster.
Component
You can create a volume by selecting the disk type and protocol based on the user’s service environment and performance requirements. When using the snapshot feature, you can restore data to the desired point in time.
Volume
A volume (Volume) is the basic creation unit of the Parallel File Storage service and is used as data storage space. Users select a name and capacity to create a volume, then connect and use it in a Multi-node GPU Cluster.
The volume name generation rules are as follows.
- It must start with a lowercase English letter and can be set to 3 to 21 characters using lowercase letters, numbers, and special characters (
_).
Snapshot
Snapshot(Snapshot) is an image backup at a specific point in time. Using the image snapshot feature, you can recover data that has been changed or deleted. The user selects the snapshot created at the desired point in time from the snapshot list and performs the recovery.
You can create up to 50 snapshots.
- You can recover by selecting a specific snapshot from the snapshot list and creating a new volume based on that snapshot.
Preliminary Service
This is a list of services that must be pre-configured before creating the service. For details, refer to the guide provided for each service and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Compute | Multi-node GPU Cluster | Physical GPU server for large‑scale high‑performance AI computation |
6.2 - How-to guides
Users can create a service by entering the required information for Parallel File Storage and selecting detailed options through the Samsung Cloud Platform Console.
Creating Parallel File Storage
You can create and use the Parallel File Storage service from the Samsung Cloud Platform Console.
To create a Parallel File Storage, follow these steps.
Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
On the Service Home page, click the Create Parallel File Storage button. You will be taken to the Create Parallel File Storage page.
Parallel File Storage Creation page, enter the information required to create the service.
Category RequiredDetailed description Volume name Required Enter the volume name - must start with a lowercase English letter
- Enter 3 to 21 characters using lowercase letters, numbers, and special characters (
_)
- Generate in the format ‘user input+{6-character UUID composed of lowercase English letters and numbers}’
- Cannot be modified after the service is created
capacity Required Enter the desired capacity - 1 ~ 1000 TB available
- Only expansion is possible after the service is created
Tag Select Add Tag - You can add up to 50 per resource
- After clicking the Add Tag button, enter or select Key, Value values
Table. Parallel File Storage service creation information input itemsIn the summary panel, review the detailed information you created and the estimated charge amount, then click the Create button.
When the popup indicating creation opens, click the Confirm button.
- When creation is complete, check the created resources on the Parallel File Storage list page.
View Parallel File Storage details
Parallel File Storage service allows you to view and edit the full resource list and detailed information.
Follow these steps to view detailed information about the Parallel File Storage service.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to view detailed information. You will be taken to the Parallel File Storage Details page.
- Parallel File Storage Details page displays status information and additional feature information, and is composed of Details, Snapshot List, Tags, and Job History tabs.
Category Detailed description Volume status Volume status representation - Creating: Creating
- Available: Created, server connection available
- Extending: Extending capacity
- Deleting: Deleting service
- Error Deleting: Abnormal state while deleting
- Error: Abnormal state while creating
- Error Extending: Abnormal state while extending
Create snapshot Immediately create a snapshot at the time of creation - Up to 50 can be created
- For detailed information on snapshot creation, refer to 스냅샷 생성하기
Service termination Cancel service button Table. Parallel File Storage status information and additional features
- Parallel File Storage Details page displays status information and additional feature information, and is composed of Details, Snapshot List, Tags, and Job History tabs.
Detailed information
On the Parallel File Storage List page, you can view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource name | Resource name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation date | Service creation timestamp |
| Volume name | Volume name |
| Capacity | Volume capacity
|
| Mount information | Mount information
|
| connected resource | List of Connected Resources (Multi-node GPU Server)
|
Snapshot list
Parallel File Storage List page allows you to view the snapshot of the selected resource.
- To create and manage snapshots, see Using Snapshots.
- You can restore data on a per-file basis using snapshots. For more details, see File-level restoration.
| Category | Detailed description |
|---|---|
| Use snapshot | Total size of stored snapshots |
| Snapshot name | Snapshot name |
| Capacity | Snapshot size |
| Creation date and time | Snapshot creation timestamp |
| status | Snapshot status
|
| Delete | Delete the selected snapshot from the snapshot list |
tag
Parallel File Storage List page allows you to view the tag information of the selected resource and to add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
On the Parallel File Storage list page, you can view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Parallel File Storage Resource Management
If you need to modify settings for Parallel File Storage or add or remove connected servers, you can perform the tasks on the Parallel File Storage Details page.
Modify capacity
You can expand the capacity of Parallel File Storage.
To modify the capacity, follow the steps below.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- On the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to modify its capacity. You will be taken to the Parallel File Storage Details page.
- Click the Edit button of the Capacity item. The Capacity Edit popup window opens.
- After entering the capacity to be expanded, click the Confirm button.
- You can expand up to a maximum of 1000 TB, including the existing capacity.
- When a popup notifying of capacity expansion opens, click the Confirm button.
Edit linked resources
You can connect resources to Parallel File Storage or disconnect resources that are already connected.
- Additional modifications are not possible while a connection resource is being edited, and you can only modify the connection resource when the volume is in the Available state.
- If communication with the target resource is interrupted or the connection is unavailable, the connection resource cannot be modified.
- When connecting resources, you can link up to 300 resources at the same location. If you exceed 300, use the API.
To modify the connection resource, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- Click the Parallel File Storage menu on the Service Home page. You will be taken to the Parallel File Storage list page.
- Parallel File Storage List page, click the resource you want to edit the connection for. You will be taken to the Parallel File Storage Details page.
- Click the Edit button of the Linked Resource item. The Linked Resource Selection popup opens.
- Select the resource to connect or uncheck the resource to disconnect, then click the Confirm button.
- You can select multiple resources simultaneously.
- The Multi-node GPU Cluster server is connected to the Parallel File Storage via two N/W interfaces. To optimize storage performance, ensure that both N/W connections are properly established.
- Parallel File Storage Details page, if the resource’s connection status is Partial Success, follow the steps below to verify.
- Check whether the two N/W interfaces for connecting Parallel File Storage in the Multi-node GPU Cluster are functioning properly.
- After disconnecting from Parallel File Storage, reconnect.
- On the Parallel File Storage Details page, check the resource’s connection status.
- When disconnecting, you must first access the server and perform the disconnection tasks (Umount, disconnect network drive).
- If the connection is terminated without OS intervention, a status error (Hang) may occur on the connection server.
- Refer to Unmount Server for detailed information on the server unmount operation.
- When adding a connected server, you must first perform the connection tasks (Mount, network drive connection) on the server.
- For detailed information about server connection, see Connecting to Server.
Cancel Parallel File Storage
You can reduce operating costs by terminating unused Parallel File Storage.
However, if you terminate the service, the running service may be stopped immediately, so you should fully consider the impact of the interruption before proceeding with the termination.
- Please note that data cannot be recovered after termination.
- If there are resources connected to Parallel File Storage, you cannot cancel it. Remove all connected resources before canceling the service.
- You can only delete a volume when its status is Available or Error.
To cancel Parallel File Storage, follow the steps below.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage list page, select the resource to cancel and click the Cancel Service button.
- You can go to the Parallel File Storage Details page of the resource to be terminated and delete it individually.
- When the pop-up notifying termination opens, click the Confirm button.
- When termination is complete, check on the Parallel File Storage List page whether the resource has been terminated.
6.2.1 - Use Snapshot
You can create, delete, or recover using snapshots of Parallel File Storage.
Create Snapshot
You can create snapshots of Parallel File Storage.
To create a snapshot, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- Parallel File Storage List page, click the resource to create a snapshot. You will be taken to the Parallel File Storage Details page.
- On the Parallel File Storage Details page, click the Create Snapshot button.
- When the popup notifying snapshot creation opens, click the Confirm button.
- Click the Snapshot List button. It takes you to the File Storage snapshot list page.
- Check the generated snapshot.
- You can only restore from the most recent snapshot. To restore from an earlier snapshot, delete the latest snapshot.
- Snapshot charges are included in the File Storage usage fees.
Recover Snapshot
You can restore using the snapshot you created.
To restore from a snapshot, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to restore the snapshot. You will be taken to the Parallel File Storage Details page.
- On the Parallel File Storage Details page, click the Snapshot List tab.
- Check the latest snapshot with Available status in the snapshot list.
- When restoring, the volume is recovered from the selected snapshot.
- Click the Snapshot Recovery button. The Snapshot Recovery popup opens.
- After checking the snapshot name and creation timestamp, click the Confirm button.
- The snapshot status changes to Reverting when recovery starts and to Available upon completion.
- You can only restore from the most recent snapshot. To restore from an earlier snapshot, delete the latest snapshot.
- During recovery, it restores from the latest snapshot in the Available state, and the situations where recovery is not possible are as follows.
- When the Parallel File Storage volume is not in the Available state
- If there are no recoverable snapshots.
- If the latest snapshot changes while creating a recovery.
- If the latest snapshot is not in Available state.
Delete snapshot
You can delete snapshots of Parallel File Storage.
To delete a snapshot, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- Parallel File Storage List page, click the resource to delete the snapshot. You will be taken to the Parallel File Storage Detail page.
- On the Parallel File Storage Details page, click the Snapshot List tab.
- In the snapshot list, click the More > Delete button at the far right of the snapshot to be restored.
- When the popup notifying you of snapshot deletion opens, click the Confirm button.
6.2.2 - Install Agent
To use the Parallel File Storage service, you must connect to the target server and install the Agent. After installing the Agent, mount on the server to use Parallel File Storage.
Install Agent and Connect to Server (Mount)
The Agent installation and server connection consist of six steps. Follow the procedure below.
- Agent installation
- Account login
- Create Mount Point
- Filesystem Mount
- Check mount
- fstab registration
Install Agent
Install the Agent using the Mount IP.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- On the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to be used on the connected server. You will be taken to the Parallel File Storage Details page.
- After checking the server in the Connection Server item, connect.
- Follow the example below to install the Volume Agent and connect the server (Mount).
curl <Mount IP>:14000/dist/v1/install | sh
root@RESD-s4sr3h:/# curl http://10.102.160.254:14000/dist/v1/install | sh
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1424 100 1424 0 0 1978k 0 --:--:-- --:--:-- --:--:-- 1390k
Downloading WekaIO CLI 4.2.4.29-hcsf
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 58.7M 100 58.7M 0 0 1079M 0 --:--:-- --:--:-- --:--:-- 1088M
Installing...
Installing agent of version 4.2.4.29-hcsf
The agent is configured to detect cgroups - cgroups v1 not found, cgroups are disabled
Waiting for agent service to be ready
Installation finished successfully
WekaIO CLI 4.2.4.29-hcsf is now installed
Account login
Log in using the mount information for the server mount.
#weka user login -H <Mount IP>
root@RESD-s4sr3h:/# weka user login -H 10.102.160.254
Organization (enter name or ID, default: 0) admin_org
Username: admin_reg
Password: ###########
+------------------------------+
| Login completed successfully |
+------------------------------+
Create Mount Point
Create a mount point on the server to mount the filesystem.
#mkdir /mnt/weka
Filesystem Mount
Mount the filesystem according to the following procedure.
- Use the #ip a command to check the IP and Interface Name information for Mount.
root@RESD-s4sr3h:/# ip a |grep 10.102
inet 10.102.160.248/23 brd 10.102.161.255 scope global ibs4f0.8010
inet 10.102.160.249/23 brd 10.102.161.255 scope global ibP1s8f0.8010
The IP information and Interface Name that can be identified in the above example are as follows.
- IP: 10.102.160.10, 10.102.160.11
- Interface Name: ibs4f0.8010, ibP1s8f0.8010
- Use the verified IP and Interface Name to execute the Mount command.
mount -t wekafs <backend-server-IP-address>/<filesystem-name> -o net=<VF interface>/<synthetic network interface IP address>/mask -o mgmt_ip=<Management-IP> /mnt/weka
root@RESD-s4sr3h:/# mount -t wekafs -o num_cores=8 -o net:ha=ibs4f0.8010,net:ha=ibP1s8f0.8010,mgmt_ip='10.102.160.10+10.102.160.11' 10.102.160.254/wekafs /mnt/weka
Mounting 10.102.161.254/bmtfs on /weka_fs
Basing mount on container client
Downloading [1/21] http://10.102.160.254:14000/dist/v1/image/envoy-fe-e6b882a6bce3c0de8cd9c7833df1a567.squashfs
Downloading [2/21] http://10.102.160.254:14000/dist/v1/image/weka-driver-1.0.0-d10ca9cff59b98778b4314014569e00f.squashfs
Downloading [3/21] http://10.102.160.254:14000/dist/v1/image/weka-driver-igb-uio-4.0.0-7eee7dc5b7f1d85a1be0e448d5e97312.squashfs
Downloading [4/21] http://10.102.160.254:14000/dist/v1/image/container-s3-tmp-1.57f-9cb61c7e0ae3ca9e2b476c191e4e84ab.squashfs
Downloading [5/21] http://10.102.160.254:14000/dist/v1/image/container-smbw-weka-4.7.12.3-9b67132a85a950260f048955dc33c7a9.squashfs
Downloading [6/21] http://10.102.160.254:14000/dist/v1/image/weka-drain-tools-2d01044c641816d9002ca594a6ae9d90.squashfs
Downloading [7/21] http://10.102.160.254:14000/dist/v1/image/container-ganesha-dev-weka-5-11becf16b21c9635daa23a247340a7bd.squashfs
Downloading [8/21] http://10.102.160.254:14000/dist/v1/image/dependencies-1.0.0-9b64fdba87a4d6e6efa9ab5250169ec8.squashfs
Downloading [9/21] http://10.102.160.254:14000/dist/v1/image/weka-container-2.3.0-be66bcc7c9739b15cacd910d7cac031e.squashfs
Downloading [10/21] http://10.102.160.254:14000/dist/v1/image/weka-hostside-faf9aa30ec9ac7521ffbc9589ac23deb.squashfs
Downloading [11/21] http://10.102.160.254:14000/dist/v1/image/api-6f501306831ff9a223a7f706c5a661e1.squashfs
Downloading [12/21] http://10.102.160.254:14000/dist/v1/image/weka-s3-3508f2f1afb4900ab11c4772e327b1ac.squashfs
Downloading [13/21] http://10.102.160.254:14000/dist/v1/image/weka-ganesha-5c6ef6d08e31f80580f50bab7d1b8134.squashfs
Downloading [14/21] http://10.102.160.254:14000/dist/v1/image/dashboard-dfb78995154ab40fb274037ac9fe8a45.squashfs
Downloading [15/21] http://10.102.160.254:14000/dist/v1/image/container-samba-weka-4.7.12.3-69835f740573b7ded6faed1dfe737bed.squashfs
Downloading [16/21] http://10.102.160.254:14000/dist/v1/image/weka-smbw-8a1430e5f0f2cca6d2a4af603d630882.squashfs
Downloading [17/21] http://10.102.160.254:14000/dist/v1/image/ui-1.0.0-5bc747765d326e6e1c3488285822f459.squashfs
Downloading [18/21] http://10.102.160.254:14000/dist/v1/image/weka-samba-8102bcf3d3a81f02755cb2e75b1b8d16.squashfs
Downloading [19/21] http://10.102.160.254:14000/dist/v1/image/weka-node-fbd17baa570969b6da7e5561f1eb652f.squashfs
Downloading [20/21] http://10.102.160.254:14000/dist/v1/image/ofed-b643ca3e4fa06d84416d463afe74a66a.squashfs
Downloading [21/21] http://10.102.160.254:14000/dist/v1/image/driver-uio-pci-generic-1.0.0-322a3daa84c41eeb6f0cafd0802fbf50.squashfs
Finished getting version 4.2.4.29-hcsf
Creating Weka container 'client' in version 4.2.4.29-hcsf
Preparing version 4.2.4.29-hcsf of container client
Base port was not explicitly provided, the container will use 14000
Applying resources
Starting container 'client'
Waiting for container 'client' to join cluster
Container "client" is ready (pid = 392216)
Calling the mount command
Cgroups v1 not found, running without cgroups
Mount completed successfully
Check mount
#df -h Run the command to check whether the filesystem is mounted.
root@RESD-s4sr3h:/# df -h
Filesystem Size Used Avail Use% Mounted on
tmpfs 202G 3.8M 202G 1% /run
/dev/nvme2n1p2 3.5T 37G 3.3T 2% /
tmpfs 1008G 0 1008G 0% /dev/shm
tmpfs 5.0M 0 5.0M 0% /run/lock
/dev/nvme2n1p1 511M 6.1M 505M 2% /boot/efi
tmpfs 202G 4.0K 202G 1% /run/user/0
/dev/loop0 2.0G 47M 2.0G 3% /opt/weka/logs
tmpfs 1008G 12K 1008G 1% /opt/weka/data/agent/tmpfss/cleanup
tmpfs 1008G 2.0G 1006G 1% /opt/weka/data/agent/tmpfss/client-persistent-tmpfs
tmpfs 1008G 0 1008G 0% /opt/weka/data/agent/tmpfss/cross-container-rpc-the-tmpfs
tmpfs 1008G 4.0K 1008G 1% /opt/weka/data/agent/tmpfss/cleanup_before_stop_and_delete
bmtfs 1.9T 537G 1.3T 29% /weka_fs
fstab registration
Register fstab so that it automatically mounts on server Reboot.
To register fstab, run the #vi /etc/fstab command, then add the following command.
root@RESD-s4sr3h:/# cat /etc/fstab
# /etc/fstab: static file system information.
#
# Use 'blkid' to print the universally unique identifier for a
# device; this may be used with UUID= as a more robust way to name devices
# that works even if disks are added and removed. See fstab(5).
#
# <file system> <mount point> <type> <options> <dump> <pass>
# / was on /dev/nvme2n1p2 during curtin installation
/dev/disk/by-uuid/8683a4fb-ee21-47c2-938e-2be0beea2089 / ext4 defaults 0 1
# /boot/efi was on /dev/nvme2n1p1 during curtin installation
/dev/disk/by-uuid/92ED-55CC /boot/efi vfat defaults 0 1
/swap.imgnoneswapsw00
10.102.160.254/wekafs /mnt/weka wekafs num_cores=8,net:ha=ibs4f0.8010,net:ha=ibP1s8f0.8010,mgmt_ip=10.102.160.10+10.102.160.11,x-systemd.requires=wekaagent.service,x-systemd.mount-timeout=infinity,_net
dev 0 0
Disconnect server (Umount)
To disconnect the server, first log into the server and perform the disconnect operation (Umount), then disconnect the server from the Console.
To disconnect from the server, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- On the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to disconnect the server. Navigate to the Parallel File Storage Details page.
- After checking the server information in the Connection Server item, connect to the server.
- Refer to the commands shown in the following example to perform the unmount (Umount) operation.
# umount /mnt/weka
# vi /etc/fstab
6.2.3 - File-level Recovery
You can restore data on a per‑file basis using the generated snapshot.
Using file-level recovery
You can connect to the server to select and recover data.
To perform file-level recovery, follow these steps.
- Click the All Services > Storage > Parallel File Storage menu. You will be taken to the Service Home page of Parallel File Storage.
- From the Service Home page, click the Parallel File Storage menu. You will be taken to the Parallel File Storage List page.
- On the Parallel File Storage List page, click the resource to recover the file. You will be taken to the Parallel File Storage Details page.
- In the Connected Resources item, verify the linked server and then connect to that server.
- Check the mount name of the File Storage on the server.
- The mount name is the same as the mount point configured on the server for mounting the filesystem.
- Navigate to the snapshot location under the mount name.
# cd /Mount명/.snapshots/snapshot명 - After checking the files to be restored at the snapshot location, restore them to the required path.
# cp -arp /Mount명/.snapshots/snapshot명/파일/{복구 디렉토리}/
6.3 - API Reference
6.4 - CLI Reference
6.5 - Release Note
Parallel File Storage
- The feature to restore from snapshots has been added.
- You can restore from the most recently created snapshot.
- The Parallel File Storage service has been officially launched.
- It can store file data across multiple storage nodes, enabling fast and efficient processing of large-scale data.
- By achieving fast data processing speed and reducing analysis time, it can be utilized in various fields such as AI/ML analysis and big data analysis.














