Skip to content

Commit ba245b6

Browse files
Refine Couchbase documentation for GCP: update titles for consistency, enhance clarity, and improve formatting across multiple sections.
1 parent 05c075a commit ba245b6

7 files changed

Lines changed: 224 additions & 145 deletions

File tree

content/learning-paths/servers-and-cloud-computing/couchbase-on-gcp/_index.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
11
---
2-
title: Deploy Couchbase on Google Cloud C4A (Arm-based Axion VMs)
2+
title: Deploy Couchbase on Google Cloud C4A
33

4-
draft: true
5-
cascade:
6-
draft: true
74

85
minutes_to_complete: 30
96

10-
who_is_this_for: This learning path is intended for software developers deploying and optimizing Couchbase workloads on Arm Linux environments, specifically using Google Cloud C4A virtual machines powered by Axion processors.
7+
who_is_this_for: This is an introductory topic for developers deploying Couchbase workloads on Arm Linux environments, specifically using Google Cloud C4A virtual machines (VM) powered by Axion processors.
118

129
learning_objectives:
13-
- Provision an Arm-based SUSE SLES virtual machine on Google Cloud (C4A with Axion processors)
10+
- Provision an Arm-based SUSE Linux Enterprise Server (SLES) virtual machine on Google Cloud (C4A with Axion processors)
1411
- Install Couchbase Server on the SUSE Arm64 (C4A) instance
15-
- Verify Couchbase deployment by accessing the Web Console, creating a test bucket, and confirming cluster health
12+
- Verify Couchbase deployment by accessing the web console, creating a test bucket, and confirming cluster health
1613
- Benchmark Couchbase by measuring operations per second (ops/sec), memory utilization, and disk performance on the Arm platform
1714

1815
prerequisites:

content/learning-paths/servers-and-cloud-computing/couchbase-on-gcp/background.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Getting started with Couchbase on Google Axion C4A (Arm Neoverse-V2)
2+
title: Get started with Couchbase on Google Axion C4A
33

44
weight: 2
55

@@ -16,13 +16,12 @@ To learn more about Google Axion, refer to the [Introducing Google Axion Process
1616

1717
## Couchbase
1818

19-
Couchbase is an open-source NoSQL distributed database designed for building high-performance, scalable, and flexible modern applications. Developed by Couchbase, Inc.
20-
It combines the capabilities of a key-value store, document database, and distributed caching system in a single unified platform.
19+
Couchbase is an open-source NoSQL distributed database designed for building high-performance, scalable, and flexible modern applications. Developed by Couchbase, Inc. It combines the capabilities of a key-value store, document database, and distributed caching system in a single unified platform.
2120

2221
Couchbase provides a memory-first architecture for low-latency data access, along with a powerful query engine (N1QL) that supports SQL-like syntax for JSON data. It also features built-in replication, automatic sharding, and cross-datacenter synchronization (XDCR), enabling seamless scalability and high availability across clusters and regions.
2322

2423
It supports both on-premises and cloud deployments (including AWS, Azure, and GCP) and integrates with modern application stacks and container platforms like Kubernetes and Docker.
2524

2625
Known for its high throughput, low latency, and ease of scaling, Couchbase is ideal for use cases such as real-time analytics, session management, content delivery, IoT, and mobile synchronization through Couchbase Mobile.
2726

28-
To learn more, visit the official [Couchbase website](https://www.couchbase.com/)
27+
To learn more, visit the [Couchbase website](https://www.couchbase.com/).
Lines changed: 44 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,54 @@
11
---
2-
title: Couchbase Baseline Testing on Google Axion C4A Arm Virtual Machine
2+
title: Perform Couchbase baseline testing
33
weight: 6
44

55
### FIXED, DO NOT MODIFY
66
layout: learningpathall
77
---
88

9-
## Couchbase Baseline Testing on GCP SUSE VMs
10-
This section confirms that Couchbase is correctly installed and running on the GCP SUSE Arm64 VM. It includes initializing the cluster, verifying node status, and accessing the Web UI to create a bucket — this ensures the setup is ready for benchmarking.
9+
## Verify Couchbase cluster health and prepare a benchmarking bucket
10+
This section guides you through verifying that Couchbase is installed and running on your GCP SUSE VM with Arm64 architecture. You'll set up your cluster, confirm your node is healthy, and use the web console to create a bucket. After completing these steps, your environment is ready for benchmarking.
1111

12-
### Setup the default cluster
13-
Once the service is running, we need to setup the default cluster for the first time.
12+
## Set up the default cluster
13+
Once Couchbase is running, set up your default cluster for the first time.
1414

15-
- Open Web Console using your VM public IP address that you saved off in the last step:
15+
Open the **Couchbase Web Console** in your browser using your VM's public IP address from the previous step:
1616

1717
```console
1818
http://<VM-Public-IP>:8091
1919
```
20-
- Press "Setup New Cluster"
2120

22-
![Setup new cluster](images/cluster-setup-1.png "Setup new cluster")
21+
Select **Set up new cluster** to begin the initial configuration.
2322

24-
- Provide a name for your cluster (example: "my_cluster") and create a password for your administrator account (leave the username as the default "Administrator")
23+
![Couchbase Web Console setup screen showing fields for cluster name, administrator password, and a button labeled Set up new cluster. The interface is clean and organized with a sidebar on the left and main setup form in the center. The environment appears welcoming and straightforward, designed to guide users through initial cluster configuration. Visible text includes Set up new cluster, Cluster Name, Administrator Password, and Set up new cluster button. alt-text#center](images/cluster-setup-1.png "Set up new cluster")
2524

26-
![Create cluster and admin count](images/cluster-setup-2.png "Create cluster and admin count")
25+
Provide a name for your cluster (for example, "my_cluster") and create a password for your administrator account (leaving the username as the default `Administrator`).
2726

28-
- Check the "Accept terms" checkbox and press "Configure Disk, Memory, Services" button
27+
![Couchbase Web Console showing the cluster creation screen with fields for cluster name and administrator password. The main form is centered with a sidebar on the left. Visible text includes Set up new cluster, Cluster Name, Administrator Password, and Set up new cluster button. The interface is clean and welcoming, designed to guide users through initial cluster setup. alt-text#center](images/cluster-setup-2.png "Create cluster and admin count")
28+
Check the **Accept Terms** box to agree to the license terms. Then select **Configure Disk Memory Services** to continue with the cluster setup.
2929

30-
![Accept Terms](images/cluster-setup-3.png "Accept Terms")
30+
![Couchbase Web Console showing the Accept Terms screen for cluster setup. The main form displays a checkbox labeled Accept Terms and a button labeled Configure Disk Memory Services. The interface is clean and organized with a sidebar on the left and the setup form centered. Visible text includes Accept Terms and Configure Disk Memory Services. The environment feels welcoming and guides users through the initial configuration process. alt-text#center](images/cluster-setup-3.png "Accept Terms")
3131

32-
- Accept the defaults of your cluster configuration and press "Save & Finish"
32+
Accept the defaults of your cluster configuration and select "Save & Finish".
3333

34-
![Finalize configuration](images/cluster-setup-4.png "Finalize configuration")
34+
![Couchbase Web Console showing the final configuration screen for cluster setup. The main form displays fields and buttons for finalizing cluster settings, including disk, memory, and services configuration. The sidebar is visible on the left, and the interface is organized and welcoming, designed to guide users through the last step of cluster setup. Visible text includes Finalize configuration, Configure Disk Memory Services, and Save Finish. The environment feels supportive and clear, helping users complete the initial Couchbase cluster configuration. alt-text#center](images/cluster-setup-4.png "Finalize configuration")
35+
Your default cluster is now set up. Save the password you created for your Administrator account. You'll need this password for future steps, including verifying cluster health and creating your benchmarking bucket.
3536

36-
Our default cluster is now created! Please retain the password you created for your "Administrator" account... you'll need that in the next steps.
37+
## Verify cluster nodes
38+
Run the following command to verify that your Couchbase node is healthy. Replace `password` with the Administrator password you set earlier.
3739

38-
### Verify Cluster Nodes
39-
This command checks if your Couchbase server (called a “node”) is running properly. Replace "password" with your specified Couchbase Administrator password.
40-
If the output says **“healthy active”**, it means your Couchbase node is working fine and ready for operations.
40+
```console
41+
/opt/couchbase/bin/couchbase-cli server-list \
42+
-u Administrator -p password --cluster localhost
43+
```
44+
45+
The expected output is:
46+
47+
```output
48+
ns_1@cb.local 127.0.0.1:8091 healthy active
49+
```
50+
51+
If you see `healthy active`, your Couchbase node is running correctly and ready for benchmarking.
4152

4253
```console
4354
/opt/couchbase/bin/couchbase-cli server-list \
@@ -48,43 +59,41 @@ If the output says **“healthy active”**, it means your Couchbase node is wor
4859
ns_1@cb.local 127.0.0.1:8091 healthy active
4960
```
5061

51-
### Prepare a Couchbase Bucket for benchmarking
52-
Once the service is running, you can access the **Couchbase Web Console** to create a bucket for benchmarking.
62+
## Prepare a Couchbase bucket for benchmarking
63+
Once the service is running, you can access the Couchbase Web Console to create a bucket for benchmarking.
5364

54-
Open Web Console using the public IP address of your VM that you saved off from the last step:
65+
Open the Couchbase Web Console in your browser. Enter your VM's public IP address from the previous step, followed by `:8091`. For example:
5566

5667
```console
5768
http://<VM-Public-IP>:8091
5869
```
70+
5971
Use the admin `username` (default is "Administrator") and `password` you created during Couchbase cluster setup in the previous step.
6072

61-
![Couchbase Dashboard](images/dashboard-1.png "Couchbase Dashboard")
73+
![Couchbase Dashboard showing cluster health, server statistics, and bucket status. The dashboard displays panels for cluster overview, server nodes, and buckets, with status indicators for health and activity. Text in the image includes Cluster Overview, Servers, Buckets, and Health. The interface is organized and visually clear, designed to help users monitor Couchbase performance and status. The environment feels professional and supportive, encouraging users to review system health and resource usage. alt-text#center](images/dashboard-1.png "Couchbase Dashboard")
74+
75+
On the left sidebar, select **Buckets** to view your bucket list.
6276

63-
- On the left hand side select "Buckets"
64-
- Press the "Add Bucket" in the upper right hand corner:
77+
In the upper right corner, select **Add Bucket** to start creating a new bucket for benchmarking.
6578

66-
![Create Bucket](images/create-bucket-1.png "Create Bucket")
79+
![Couchbase Web Console showing the Add Bucket screen. The main form displays fields for bucket name, bucket type, and memory quota. The sidebar is visible on the left, and the Add Bucket button is highlighted in the upper right corner. Transcribed text includes Bucket Name, Bucket Type, Memory Quota, and Add Bucket. The interface is organized and welcoming, designed to guide users through bucket creation. The environment feels supportive and clear, encouraging users to set up a new Couchbase bucket for benchmarking. alt-text#center](images/create-bucket-1.png "Create Bucket")
6780

68-
- Name the new bucket "benchmark"
69-
- The bucket type will be "Couchbase"
70-
- The Memory Quota can be set to "512 MB"
81+
Now name your bucket `benchmark`. For **Bucket Type**, select **Couchbase**. Set the **Memory Quota** to **512 MB**. These settings help ensure your benchmarking results are accurate and consistent on your Arm-based GCP VM.
7182

72-
![Create Bucket](images/create-bucket-2.png "Create Bucket")
83+
![Couchbase Web Console displaying the Add Bucket form with fields for Bucket Name, Bucket Type, and Memory Quota. The user is entering benchmark as the bucket name, selecting Couchbase as the bucket type, and setting the memory quota to 512 MB. The Add Bucket button is visible in the upper right corner. The sidebar on the left shows navigation options. Transcribed text includes Bucket Name, Bucket Type, Memory Quota, and Add Bucket. The environment is organized and supportive, guiding users through the process of creating a new bucket for benchmarking. alt-text#center](images/create-bucket-2.png "Create Bucket")
7384

7485
| **Parameter** | **Value** |
7586
|----------------|-----------|
7687
| **Bucket Name** | benchmark |
7788
| **Bucket Type** | Couchbase |
7889
| **Memory Quota** | 512 MB |
7990

80-
- You should now see that your bucket has been created:
91+
You should now see that your bucket has been created:
8192

82-
![Created Bucket](images/create-bucket-3.png "Created Bucket")
93+
![Couchbase Web Console showing the newly created benchmark bucket listed under Buckets. The main panel displays a table with columns for Bucket Name, Bucket Type, and Memory Quota. The benchmark bucket appears with type Couchbase and memory quota 512 MB. The sidebar on the left provides navigation options. Visible text includes Bucket Name, Bucket Type, Memory Quota, and benchmark. The environment is organized and supportive, confirming successful bucket creation and encouraging users to continue with benchmarking tasks. alt-text#center](images/create-bucket-3.png "Created Bucket")
8394

84-
#### Additional notes about buckets in Couchbase
95+
## Understanding buckets in Couchbase
8596

86-
- A **bucket** in Couchbase is like a **database** — it stores and manages your data.
87-
- The **benchmark** bucket will be used for **load testing** and **performance benchmarking**.
88-
- Setting the **RAM Quota** ensures Couchbase allocates sufficient memory for **in-memory data operations**, improving overall speed.
97+
A bucket in Couchbase works like a database. It stores and organizes your data. In this guide, you created a benchmark bucket specifically for load testing and performance benchmarking. Setting the Memory Quota (RAM Quota) ensures Couchbase reserves enough memory for fast, in-memory data operations. This helps you get accurate performance results on your Arm-based GCP VM.
8998

9099
You can now proceed to the next section for benchmarking to measure Couchbase's performance.

0 commit comments

Comments
 (0)