Skip to content

Commit 80fa888

Browse files
committed
Direct users to official Linux install instruction
... not bespoke `curl` commands that can break. Fixes DOC-13739
1 parent c5383da commit 80fa888

14 files changed

+40
-292
lines changed

src/current/_includes/v25.2/misc/linux-binary-prereqs.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

src/current/_includes/v25.2/performance/scale-cluster.md

Lines changed: 2 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,6 @@
11
1. SSH to one of the `n2-standard-4` instances in the `us-west1-a` zone.
22

3-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, extract the binary, and copy it into the `PATH`:
4-
5-
{% include_cached copy-clipboard.html %}
6-
~~~ shell
7-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
8-
| tar -xz
9-
~~~
10-
11-
{% include_cached copy-clipboard.html %}
12-
~~~ shell
13-
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
14-
~~~
3+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
154

165
1. Run the [`cockroach start`]({% link {{ page.version.version }}/cockroach-start.md %}) command:
176

@@ -31,18 +20,7 @@
3120

3221
1. SSH to one of the `n2-standard-4` instances in the `us-west2-a` zone.
3322

34-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, extract the binary, and copy it into the `PATH`:
35-
36-
{% include_cached copy-clipboard.html %}
37-
~~~ shell
38-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
39-
| tar -xz
40-
~~~
41-
42-
{% include_cached copy-clipboard.html %}
43-
~~~ shell
44-
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
45-
~~~
23+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
4624

4725
1. Run the [`cockroach start`]({% link {{ page.version.version }}/cockroach-start.md %}) command:
4826

src/current/_includes/v25.2/performance/start-cluster.md

Lines changed: 2 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,7 @@
22

33
1. SSH to the first `n2-standard-4` instance.
44

5-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, extract the binary, and copy it into the `PATH`:
6-
7-
{% include_cached copy-clipboard.html %}
8-
~~~ shell
9-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
10-
| tar -xz
11-
~~~
12-
13-
{% include_cached copy-clipboard.html %}
14-
~~~ shell
15-
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
16-
~~~
5+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
176

187
1. Run the [`cockroach start`]({% link {{ page.version.version }}/cockroach-start.md %}) command:
198

@@ -35,20 +24,7 @@
3524

3625
1. SSH to the fourth instance, the one not running a CockroachDB node.
3726

38-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
39-
40-
{% include_cached copy-clipboard.html %}
41-
~~~ shell
42-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
43-
| tar -xz
44-
~~~
45-
46-
1. Copy the binary into the `PATH`:
47-
48-
{% include_cached copy-clipboard.html %}
49-
~~~ shell
50-
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
51-
~~~
27+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
5228

5329
1. Run the [`cockroach init`]({% link {{ page.version.version }}/cockroach-init.md %}) command:
5430

src/current/_includes/v25.2/prod-deployment/insecure-scale-cluster.md

Lines changed: 2 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -12,22 +12,7 @@ For each additional node you want to add to the cluster, complete the following
1212

1313
1. SSH to the machine where you want the node to run.
1414

15-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
16-
17-
{% include_cached copy-clipboard.html %}
18-
~~~ shell
19-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
20-
| tar -xz
21-
~~~
22-
23-
1. Copy the binary into the `PATH`:
24-
25-
{% include_cached copy-clipboard.html %}
26-
~~~ shell
27-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
28-
~~~
29-
30-
If you get a permissions error, prefix the command with `sudo`.
15+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
3116

3217
1. Run the [`cockroach start`]({% link {{ page.version.version }}/cockroach-start.md %}) command, passing the new node's address as the `--advertise-addr` flag and pointing `--join` to the three existing nodes (also include `--locality` if you set it earlier).
3318

@@ -52,21 +37,7 @@ For each additional node you want to add to the cluster, complete the following
5237

5338
1. SSH to the machine where you want the node to run. Ensure you are logged in as the `root` user.
5439

55-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
56-
57-
{% include_cached copy-clipboard.html %}
58-
~~~ shell
59-
curl -o cockroach-{{ page.release_info.version }}.linux-amd64.tgz; tar xzvf cockroach-{{ page.release_info.version }}.linux-amd64.tgz
60-
~~~
61-
62-
1. Copy the binary into the `PATH`:
63-
64-
{% include_cached copy-clipboard.html %}
65-
~~~ shell
66-
cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
67-
~~~
68-
69-
If you get a permissions error, prefix the command with `sudo`.
40+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
7041

7142
1. Create the Cockroach directory:
7243

src/current/_includes/v25.2/prod-deployment/insecure-start-nodes.md

Lines changed: 1 addition & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -59,41 +59,7 @@ After completing these steps, nodes will not yet be live. They will complete the
5959

6060
1. SSH to the machine where you want the node to run. Ensure you are logged in as the `root` user.
6161

62-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
63-
64-
{% include_cached copy-clipboard.html %}
65-
~~~ shell
66-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
67-
| tar -xz
68-
~~~
69-
70-
1. Copy the binary into the `PATH`:
71-
72-
{% include_cached copy-clipboard.html %}
73-
~~~ shell
74-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
75-
~~~
76-
77-
If you get a permissions error, prefix the command with `sudo`.
78-
79-
1. CockroachDB uses custom-built versions of the [GEOS]({% link {{ page.version.version }}/architecture/glossary.md %}#geos) libraries. Copy these libraries to the location where CockroachDB expects to find them:
80-
81-
{% include_cached copy-clipboard.html %}
82-
~~~ shell
83-
$ mkdir -p /usr/local/lib/cockroach
84-
~~~
85-
86-
{% include_cached copy-clipboard.html %}
87-
~~~ shell
88-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/
89-
~~~
90-
91-
{% include_cached copy-clipboard.html %}
92-
~~~ shell
93-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/
94-
~~~
95-
96-
If you get a permissions error, prefix the command with `sudo`.
62+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
9763

9864
1. Create the Cockroach directory:
9965

src/current/_includes/v25.2/prod-deployment/insecure-test-load-balancing.md

Lines changed: 1 addition & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -12,22 +12,7 @@ For comprehensive guidance on benchmarking CockroachDB with TPC-C, see [Performa
1212

1313
This should be a machine that is not running a CockroachDB node.
1414

15-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
16-
17-
{% include_cached copy-clipboard.html %}
18-
~~~ shell
19-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
20-
| tar -xz
21-
~~~
22-
23-
1. Copy the binary into the `PATH`:
24-
25-
{% include_cached copy-clipboard.html %}
26-
~~~ shell
27-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
28-
~~~
29-
30-
If you get a permissions error, prefix the command with `sudo`.
15+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
3116

3217
1. Use the [`cockroach workload`]({% link {{ page.version.version }}/cockroach-workload.md %}) command to load the initial schema and data, pointing it at the IP address of the load balancer:
3318

src/current/_includes/v25.2/prod-deployment/secure-scale-cluster.md

Lines changed: 2 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -12,22 +12,7 @@ For each additional node you want to add to the cluster, complete the following
1212

1313
1. SSH to the machine where you want the node to run.
1414

15-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
16-
17-
{% include_cached copy-clipboard.html %}
18-
~~~ shell
19-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
20-
| tar -xz
21-
~~~
22-
23-
1. Copy the binary into the `PATH`:
24-
25-
{% include_cached copy-clipboard.html %}
26-
~~~ shell
27-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
28-
~~~
29-
30-
If you get a permissions error, prefix the command with `sudo`.
15+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
3116

3217
1. Run the [`cockroach start`]({% link {{ page.version.version }}/cockroach-start.md %}) command, passing the new node's address as the `--advertise-addr` flag and pointing `--join` to the three existing nodes (also include `--locality` if you set it earlier).
3318

@@ -52,21 +37,7 @@ For each additional node you want to add to the cluster, complete the following
5237

5338
1. SSH to the machine where you want the node to run. Ensure you are logged in as the `root` user.
5439

55-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
56-
57-
{% include_cached copy-clipboard.html %}
58-
~~~ shell
59-
curl -o cockroach-{{ page.release_info.version }}.linux-amd64.tgz https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz; tar xzvf cockroach-{{ page.release_info.version }}.linux-amd64.tgz
60-
~~~
61-
62-
1. Copy the binary into the `PATH`:
63-
64-
{% include_cached copy-clipboard.html %}
65-
~~~ shell
66-
cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
67-
~~~
68-
69-
If you get a permissions error, prefix the command with `sudo`.
40+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
7041

7142
1. Create the Cockroach directory:
7243

src/current/_includes/v25.2/prod-deployment/secure-start-nodes.md

Lines changed: 1 addition & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -59,41 +59,7 @@ After completing these steps, nodes will not yet be live. They will complete the
5959

6060
1. SSH to the machine where you want the node to run. Ensure you are logged in as the `root` user.
6161

62-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
63-
64-
{% include_cached copy-clipboard.html %}
65-
~~~ shell
66-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
67-
| tar -xz
68-
~~~
69-
70-
1. Copy the binary into the `PATH`:
71-
72-
{% include_cached copy-clipboard.html %}
73-
~~~ shell
74-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
75-
~~~
76-
77-
If you get a permissions error, prefix the command with `sudo`.
78-
79-
1. CockroachDB uses custom-built versions of the [GEOS]({% link {{ page.version.version }}/architecture/glossary.md %}#geos) libraries. Copy these libraries to the location where CockroachDB expects to find them:
80-
81-
{% include_cached copy-clipboard.html %}
82-
~~~ shell
83-
$ mkdir -p /usr/local/lib/cockroach
84-
~~~
85-
86-
{% include_cached copy-clipboard.html %}
87-
~~~ shell
88-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/
89-
~~~
90-
91-
{% include_cached copy-clipboard.html %}
92-
~~~ shell
93-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/
94-
~~~
95-
96-
If you get a permissions error, prefix the command with `sudo`.
62+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
9763

9864
1. Create the Cockroach directory:
9965

src/current/_includes/v25.2/prod-deployment/secure-test-load-balancing.md

Lines changed: 1 addition & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,22 +10,7 @@ For comprehensive guidance on benchmarking CockroachDB with TPC-C, refer to [Per
1010

1111
This should be a machine that is not running a CockroachDB node, and it should already have a `certs` directory containing `ca.crt`, `client.root.crt`, and `client.root.key` files.
1212

13-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
14-
15-
{% include_cached copy-clipboard.html %}
16-
~~~ shell
17-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
18-
| tar -xz
19-
~~~
20-
21-
1. Copy the binary into the `PATH`:
22-
23-
{% include_cached copy-clipboard.html %}
24-
~~~ shell
25-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
26-
~~~
27-
28-
If you get a permissions error, prefix the command with `sudo`.
13+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
2914

3015
1. Use the [`cockroach workload`]({% link {{ page.version.version }}/cockroach-workload.md %}) command to load the initial schema and data, pointing it at the IP address of the load balancer:
3116

src/current/v25.2/deploy-cockroachdb-on-premises-insecure.md

Lines changed: 6 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -55,27 +55,12 @@ Each CockroachDB node is an equally suitable SQL gateway to your cluster, but to
5555

5656
1. Install HAProxy:
5757

58-
{% include_cached copy-clipboard.html %}
59-
~~~ shell
60-
$ apt-get install haproxy
61-
~~~
62-
63-
1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:
64-
65-
{% include_cached copy-clipboard.html %}
66-
~~~ shell
67-
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
68-
| tar -xz
69-
~~~
70-
71-
1. Copy the binary into the `PATH`:
72-
7358
{% include_cached copy-clipboard.html %}
7459
~~~ shell
75-
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
60+
$ apt-get install haproxy
7661
~~~
7762

78-
If you get a permissions error, prefix the command with `sudo`.
63+
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).
7964

8065
1. Run the [`cockroach gen haproxy`]({% link {{ page.version.version }}/cockroach-gen.md %}) command, specifying the address of any CockroachDB node:
8166

@@ -90,10 +75,10 @@ Each CockroachDB node is an equally suitable SQL gateway to your cluster, but to
9075

9176
1. Start HAProxy, with the `-f` flag pointing to the `haproxy.cfg` file:
9277

93-
{% include_cached copy-clipboard.html %}
94-
~~~ shell
95-
$ haproxy -f haproxy.cfg
96-
~~~
78+
{% include_cached copy-clipboard.html %}
79+
~~~ shell
80+
$ haproxy -f haproxy.cfg
81+
~~~
9782

9883
1. Repeat these steps for each additional instance of HAProxy you want to run.
9984

0 commit comments

Comments
 (0)