Skip to content

Direct users to official Linux install instruction #19625

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion src/current/_includes/v25.2/misc/linux-binary-prereqs.md

This file was deleted.

26 changes: 2 additions & 24 deletions src/current/_includes/v25.2/performance/scale-cluster.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,6 @@
1. SSH to one of the `n2-standard-4` instances in the `us-west1-a` zone.

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`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).

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

Expand All @@ -31,18 +20,7 @@

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

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`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).

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

Expand Down
28 changes: 2 additions & 26 deletions src/current/_includes/v25.2/performance/start-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,7 @@

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

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`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).

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

Expand All @@ -35,20 +24,7 @@

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ sudo cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~
1. [Install CockroachDB for Linux]({% link {{ page.version.version }}/install-cockroachdb-linux.md %}).

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,22 +12,7 @@ For each additional node you want to add to the cluster, complete the following

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

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).

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

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
curl -o cockroach-{{ page.release_info.version }}.linux-amd64.tgz; tar xzvf cockroach-{{ page.release_info.version }}.linux-amd64.tgz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

1. Create the Cockroach directory:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,41 +59,7 @@ After completing these steps, nodes will not yet be live. They will complete the

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

If you get a permissions error, prefix the command with `sudo`.

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:

{% include_cached copy-clipboard.html %}
~~~ shell
$ mkdir -p /usr/local/lib/cockroach
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/
~~~

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

1. Create the Cockroach directory:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,22 +12,7 @@ For comprehensive guidance on benchmarking CockroachDB with TPC-C, see [Performa

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

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:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,22 +12,7 @@ For each additional node you want to add to the cluster, complete the following

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

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).

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

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
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
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

1. Create the Cockroach directory:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,41 +59,7 @@ After completing these steps, nodes will not yet be live. They will complete the

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

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

If you get a permissions error, prefix the command with `sudo`.

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:

{% include_cached copy-clipboard.html %}
~~~ shell
$ mkdir -p /usr/local/lib/cockroach
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/
~~~

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/
~~~

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

1. Create the Cockroach directory:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,22 +10,7 @@ For comprehensive guidance on benchmarking CockroachDB with TPC-C, refer to [Per

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.

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
~~~

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

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:

Expand Down
27 changes: 6 additions & 21 deletions src/current/v25.2/deploy-cockroachdb-on-premises-insecure.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,27 +55,12 @@ Each CockroachDB node is an equally suitable SQL gateway to your cluster, but to

1. Install HAProxy:

{% include_cached copy-clipboard.html %}
~~~ shell
$ apt-get install haproxy
~~~

1. Download the [CockroachDB archive](https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz) for Linux, and extract the binary:

{% include_cached copy-clipboard.html %}
~~~ shell
$ curl https://binaries.cockroachdb.com/cockroach-{{ page.release_info.version }}.linux-amd64.tgz \
| tar -xz
~~~

1. Copy the binary into the `PATH`:

{% include_cached copy-clipboard.html %}
~~~ shell
$ cp -i cockroach-{{ page.release_info.version }}.linux-amd64/cockroach /usr/local/bin/
$ apt-get install haproxy
~~~

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

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

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

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

{% include_cached copy-clipboard.html %}
~~~ shell
$ haproxy -f haproxy.cfg
~~~
{% include_cached copy-clipboard.html %}
~~~ shell
$ haproxy -f haproxy.cfg
~~~

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

Expand Down
Loading
Loading