Create cluster

Create cluster

A cluster is a logical unit consisting of multiple nodes, and MemStore automatically manages the state of clusters. When users create or delete a cluster, the service performs the operation and automatically updates the cluster status. Each cluster consists of nodes that serve as either a Primary or Replica.
You can create a new cluster in MemStore using the following method.

info

• The security group applied to a cluster must allow access to the port specified during creation.
• t1i instance types may take a few minutes to tens of minutes to change to the Running state after creation.
  If there are insufficient CPU credits, CPU-intensive operations may not function correctly.

caution

User authentication is not supported for Redis OSS engine version 5 or below.

1. Go to KakaoCloud Console > Data Store > MemStore.
2. In the Cluster menu, click the Create Cluster button.

Create new cluster

Enable cluster mode

1. In the configuration options, select Create new cluster and set Cluster Mode to Enabled.

2. Enter the required information to create the cluster.

   Category	Field	Description
   Cluster mode		Select whether to enable cluster mode
   Basic settings	Cluster name	Name of the cluster - Cannot be duplicated within the same project
   	Description (optional)	Description of the cluster, up to 100 characters
   Redis compatibility	Engine version	Redis OSS engine version for the node - Supported: 7.2.7, 7.2.6, 7.0.15, 6.2.17, 6.2.16, 6.2.5
   	Port	Redis connection port - Default: 6379 - Can specify between 2000–50000
   User authentication		Whether to enable authentication when accessing MemStore - Disabled: access with default account - Enabled: access with entered ID and password
   User account settings	ID	Required if authentication is enabled - Reserved names are not allowed
   	Password	8–16 characters
   TLS encryption		Whether to use encrypted connection - Disabled: plain connection - Enabled: supports TLS 1.2. Download ca.crt file from cluster details after creation
   Parameter group		Select parameter group matching selected engine version and cluster mode
   Shard settings	Number of shards	Number of shards to create - Min: 1, Max: 12
   	Nodes per shard	Number of nodes per shard - Min: 2, Max: 5
   Node type		Select node type with sufficient memory for optimal performance See Node types
   Network settings	VPC	Select from user-created VPCs
   	Subnet	Select one or more subnets
   	Security group	Select existing or create new security groups (multiple selectable)
   Shard placement		Select subnet for node placement within each shard
   Automatic backup	Backup option	Whether to enable automatic daily backup - Must have 2 or more nodes
   	Retention period	Backup retention period: 1–35 days
   	Backup start time	Backup starts within 15 minutes of selected time

Disable cluster mode

1. In the configuration options, select Create new cluster and set Cluster Mode to Disabled.

2. Enter the required information to create the cluster.

   Category	Field	Description
   Cluster mode		Select whether to disable cluster mode
   Basic settings	Cluster name	Name of the cluster - Cannot be duplicated within the same project
   	Description (optional)	Description of the cluster, up to 100 characters
   Redis compatibility	Engine version	Redis OSS engine version - Supported: 7.2.7, 7.2.6, 7.0.15, 6.2.17, 6.2.16, 6.2.5, 5.0.6
   	Port	Redis connection port - Default: 6379 - Can specify between 2000–50000
   User authentication		Whether to enable authentication * Not supported for Redis OSS v5 or below
   User account settings	ID	Required if authentication is enabled - 1–32 characters, lowercase letters and _ only - Reserved names not allowed
   	Password	8–16 characters - No Korean, spaces, or special characters /, ', ", @
   TLS encryption		Whether to use encrypted connection * Not supported for Redis OSS v5 or below
   Parameter group		Select parameter group matching selected engine version and cluster mode
   Number of nodes	Number of nodes	Number of nodes to create - With HA: 2–6 - Without HA: 1–6 - Example: For 1 Primary and 2 Replicas, enter 3
   	High availability	Enable HA for automatic failover and node replacement
   Node type		Select node type with sufficient memory See Node types
   Network settings	VPC	Select from user-created VPCs
   	Subnet	Select one subnet
   	Security group	Select or create security groups (multiple selectable)
   Node placement		Select subnets based on node roles
   Automatic backup	Backup option	Enable daily automatic backup (2 or more nodes required)
   	Retention period	1–35 days
   	Backup start time	Backup starts within 15 minutes of selected time

Restore cluster

caution

• Restoration is only possible with the same or higher Redis engine version as used in the backup.
• Backup can only be restored using the same cluster mode.
• Restoration may fail if the cache size of the backup exceeds 60% of the target cluster flavor memory.

1. In the configuration options, select Restore cluster.

2. To restore from an existing backup, choose Backup type > MemStore backup.

3. To restore from a file in Object Storage, choose Backup type > User backup file and specify the path.

4. Enter the required information to create the cluster.

   When cluster mode is enabled

   Category	Field	Description
   Restore source info		Information of the backup source file to be used for restoration; a new cluster will be created and restored using this file
   Cluster mode setting		Whether to enable cluster mode
   Basic settings	Cluster name	Name of the cluster - Cannot be duplicated within the same project
   	Description (optional)	Description of the cluster, up to 100 characters
   Redis compatibility	Engine version	Redis OSS engine version to run on nodes - Supported: 7.2.7, 7.2.6, 7.0.15, 6.2.17, 6.2.16, 6.2.5
   	Port	Port for Redis access - Default: 6379 - Can specify between 2000–50000
   User authentication		Whether to enable user authentication when accessing MemStore resources - Disabled: access with default account - Enabled: access with specified ID and password
   User account settings	ID	Required when authentication is enabled - 1–32 characters, lowercase letters and _ only - Reserved names not allowed
   	Password	8–16 characters - No Korean, spaces, or special characters /, ', ", @
   TLS encryption		Whether to use encrypted connection - Disabled: plain connection - Enabled: supports TLS 1.2. Download ca.crt file from cluster details after creation
   Parameter group		Select parameter group that matches the selected engine version and cluster mode
   Shard settings	Number of shards	Number of shards to be created - Cannot be changed during restore in cluster mode for data consistency
   	Nodes per shard	Number of nodes per shard - Min: 2, Max: 5
   Node type		Select node type with sufficient memory for performance See Node types
   Network settings	VPC	Select from previously created VPCs
   	Subnet	Select one or more previously created subnets
   	Security group	Select or create security groups for the cluster (multiple selectable)
   Shard placement		Select the subnet where each node in the shard will be created
   Automatic backup	Backup option	Whether to enable daily automatic backup - Must have 2 or more nodes
   	Retention period	Backup retention period, between 1 and 35 days
   	Backup start time	Backup will start within 15 minutes of the selected time

   When cluster mode is disabled

   Category	Field	Description
   Restore source info		Information of the backup source file to be used for restoration; a new cluster will be created and restored using this file
   Cluster mode setting		Whether to disable cluster mode
   Basic settings	Cluster name	Name of the cluster - Cannot be duplicated within the same project
   	Description (optional)	Description of the cluster, up to 100 characters
   Redis compatibility	Engine version	Redis OSS engine version to run on nodes - Supported when cluster mode is disabled: 7.2.7, 7.2.6, 7.0.15, 6.2.17, 6.2.16, 6.2.5, 5.0.6
   	Port	Port for Redis access - Default: 6379 - Can specify between 2000–50000
   User authentication		Whether to enable user authentication when accessing MemStore resources - Not supported for Redis OSS version 5 or below
   User account settings	ID	Required when authentication is enabled - 1–32 characters, lowercase letters and _ only - Reserved names not allowed
   	Password	8–16 characters - No Korean, spaces, or special characters /, ', ", @
   TLS encryption		Whether to use encrypted connection - Disabled: plain connection - Enabled: supports TLS 1.2. Download ca.crt file from cluster details after creation - Not supported for Redis OSS version 5 or below
   Parameter group		Select parameter group that matches the selected engine version and cluster mode
   Number of nodes	Number of nodes	Desired number of nodes - With HA: 2–6 (1 Primary + 1–5 Replicas) - Without HA: 1–6 (1 Primary + 0–5 Replicas) - Example: For 1 Primary and 2 Replicas, enter 3
   	High availability	Whether to enable HA for automatic failover and node replacement
   Node type		Select node type with sufficient memory for performance See Node types
   Network settings	VPC	Select from previously created VPCs
   	Subnet	Select previously created subnet(s)
   	Security group	Select or create security groups for the cluster (multiple selectable)
   Node placement		Select subnets for node placement based on role
   Automatic backup	Backup option	Whether to enable daily automatic backup
   	Retention period	Backup retention period, between 1 and 35 days
   	Backup start time	Backup will start within 15 minutes of the selected time