You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pr@cassandra.apache.org by GitBox <gi...@apache.org> on 2020/04/07 09:48:51 UTC
[GitHub] [cassandra] flightc opened a new pull request #520: CASSANDRA-15466
Improved installation page, added YUM instructions
flightc opened a new pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] flightc commented on issue #520: CASSANDRA-15466
Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
flightc commented on issue #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#issuecomment-610758148
All requested updates made and committed. Cheers! 🍻
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] flightc commented on a change in pull request #520:
CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
flightc commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405264069
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
+- CentOS & RedHat Enterprise Linux (RHEL) including 6.6 to 7.7
+- Amazon Linux AMIs including 2016.09 through to Linux 2
+- Debian versions 8 & 9
+- SUSE Enterprise Linux 12
+
+This is not an exhaustive list of operating system platforms, nor is it prescriptive. However users will be
+well-advised to conduct exhaustive tests of their own particularly for less-popular distributions of Linux.
+Deploying on older versions is not recommended unless you have previous experience with the older distribution
+in a production environment.
+
Prerequisites
^^^^^^^^^^^^^
-- The latest version of Java 8, either the `Oracle Java Standard Edition 8
+- Install the latest version of Java 8, either the `Oracle Java Standard Edition 8
<http://www.oracle.com/technetwork/java/javase/downloads/index.html>`__ or `OpenJDK 8 <http://openjdk.java.net/>`__. To
verify that you have the correct version of java installed, type ``java -version``.
-
+- **NOTE**: *Experimental* support for Java 11 was added in Cassandra 4.0 (`CASSANDRA-9608 <https://issues.apache.org/jira/browse/CASSANDRA-9608>`__).
+ Running Cassandra on Java 11 is *experimental*. Do so at your own risk. For more information, see
+ `NEWS.txt <https://github.com/apache/cassandra/blob/trunk/NEWS.txt>`__.
- For using cqlsh, the latest version of `Python 2.7 <https://www.python.org/downloads/>`__. To verify that you have
the correct version of Python installed, type ``python --version``.
-Installation from binary tarball files
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Choosing an installation method
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For most users, installing the binary tarball is the simplest choice. The tarball unpacks all its contents
+into a single location with binaries and configuration files located in their own subdirectories. The most
+obvious attribute of the tarball installation is it does not require ``root`` permissions and can be
+installed on any Linux distribution.
+
+Packaged installations require ``root`` permissions. Install the RPM build on CentOS and RHEL-based
+distributions if you want to install Cassandra using YUM. Install the Debian build on Ubuntu and other
+Debian-based distributions if you want to install Cassandra using APT. Note that both the YUM and APT
+methods required ``root`` permissions and will install the binaries and configuration files as the
+``cassandra`` OS user.
+
+Installing the binary tarball
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+1. Verify the version of Java installed. For example:
+
+::
+
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
+
+2. Download the binary tarball from one of the mirrors on the `Apache Cassandra Downloadi <http://cassandra.apache.org/download/>`__
+ site. For example, to download 3.11.6:
+
+::
+
+ $ curl -OL http://apache.mirror.digitalpacific.com.au/cassandra/3.11.6/apache-cassandra-3.11.6-bin.tar.gz
+
+NOTE: The mirrors only host the latest versions of each major supported release. To download an earlier
+version of Cassandra, visit the `Apache Archives <http://archive.apache.org/dist/cassandra/>`__.
+
+3. OPTIONAL: Verify the integrity of the downloaded tarball using one of the methods `here <https://www.apache.org/dyn/closer.cgi#verify>`__.
+ For example, to verify the hash of the downloaded file using GPG:
+
+::
+
+ $ gpg --print-md SHA256 apache-cassandra-3.11.6-bin.tar.gz
+ apache-cassandra-3.11.6-bin.tar.gz: CE34EDEB D1B6BB35 216AE97B D06D3EFC 338C05B2
+ 73B78267 556A99F8 5D30E45B
+
+Compare the signature with the SHA256 file from the Downloads site:
+
+::
+
+ $ curl -L https://downloads.apache.org/cassandra/3.11.6/apache-cassandra-3.11.6-bin.tar.gz.sha256
+ ce34edebd1b6bb35216ae97bd06d3efc338c05b273b78267556a99f85d30e45b
+
+4. Unpack the tarball:
+
+::
+
+ $ tar xzvf apache-cassandra-3.11.6-bin.tar.gz
+
+The files will be extracted to the ``apache-cassandra-3.11.6/`` directory. This is the tarball installation
+location.
+
+5. Located in the tarball installation location are the directories for the scripts, binaries, utilities, configuration, data and log files:
+
+::
+
+ <tarball_installation>/
+ bin/
+ conf/
+ data/
+ doc/
+ interface/
+ javadoc/
+ lib/
+ logs/
+ pylib/
+ tools/
+
+For information on how to configure your installation, see
+`Configuring Cassandra <http://cassandra.apache.org/doc/latest/getting_started/configuring.html>`__.
+
+6. Start Cassandra:
+
+::
+
+ $ cd apache-cassandra-3.11.6/
+ $ bin/cassandra
+
+NOTE: This will run Cassandra as the authenticated Linux user.
+
+You can monitor the progress of the startup with:
+
+::
+
+ $ tail -f logs/system.log
+
+Cassandra is ready when you see an entry like this in the ``system.log``:
+
+::
+
+ INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on /x.x.x.x:9042 (unencrypted)...
+
+7. Check the status of Cassandra:
+
+::
+
+ $ bin/nodetool status
+
+The status column in the output should report UN which stands for "Up/Normal".
+
+Alternatively, connect to the database with:
+
+::
+
+ $ bin/cqlsh
-- Download the latest stable release from the `Apache Cassandra downloads website <http://cassandra.apache.org/download/>`__.
+Installing the Debian packages
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- Untar the file somewhere, for example:
+1. Verify the version of Java installed. For example:
::
- tar -xzvf apache-cassandra-3.6-bin.tar.gz
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
-The files will be extracted into ``apache-cassandra-3.6``, you need to substitute 3.6 with the release number that you
-have downloaded.
+2. Add the Apache repository of Cassandra to the file ``cassandra.sources.list``. The latest supported
+ major version is 3.11 and the corresponding distribution name is ``311x`` (with an "x" as the suffix).
+ For older releases use ``30x`` for C* 3.0 series, ``22x`` for 2.2 and ``21x`` for 2.1. For example,
+ to add the repository for version 3.11 (``311x``):
+
+::
-- Optionally add ``apache-cassandra-3.6\bin`` to your path.
-- Start Cassandra in the foreground by invoking ``bin/cassandra -f`` from the command line. Press "Control-C" to stop
- Cassandra. Start Cassandra in the background by invoking ``bin/cassandra`` from the command line. Invoke ``kill pid``
- or ``pkill -f CassandraDaemon`` to stop Cassandra, where pid is the Cassandra process id, which you can find for
- example by invoking ``pgrep -f CassandraDaemon``.
-- Verify that Cassandra is running by invoking ``bin/nodetool status`` from the command line.
-- Configuration files are located in the ``conf`` sub-directory.
-- Since Cassandra 2.1, log and data directories are located in the ``logs`` and ``data`` sub-directories respectively.
- Older versions defaulted to ``/var/log/cassandra`` and ``/var/lib/cassandra``. Due to this, it is necessary to either
- start Cassandra with root privileges or change ``conf/cassandra.yaml`` to use directories owned by the current user,
- as explained below in the section on changing the location of directories.
+ $ echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
Review comment:
I've made the switch now to `40x` in both the deb & RPM sections. Cheers!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] rustyrazorblade commented on a change in pull request
#520: CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
rustyrazorblade commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405200739
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
+- CentOS & RedHat Enterprise Linux (RHEL) including 6.6 to 7.7
+- Amazon Linux AMIs including 2016.09 through to Linux 2
+- Debian versions 8 & 9
+- SUSE Enterprise Linux 12
+
+This is not an exhaustive list of operating system platforms, nor is it prescriptive. However users will be
+well-advised to conduct exhaustive tests of their own particularly for less-popular distributions of Linux.
+Deploying on older versions is not recommended unless you have previous experience with the older distribution
+in a production environment.
+
Prerequisites
^^^^^^^^^^^^^
-- The latest version of Java 8, either the `Oracle Java Standard Edition 8
+- Install the latest version of Java 8, either the `Oracle Java Standard Edition 8
<http://www.oracle.com/technetwork/java/javase/downloads/index.html>`__ or `OpenJDK 8 <http://openjdk.java.net/>`__. To
verify that you have the correct version of java installed, type ``java -version``.
-
+- **NOTE**: *Experimental* support for Java 11 was added in Cassandra 4.0 (`CASSANDRA-9608 <https://issues.apache.org/jira/browse/CASSANDRA-9608>`__).
+ Running Cassandra on Java 11 is *experimental*. Do so at your own risk. For more information, see
+ `NEWS.txt <https://github.com/apache/cassandra/blob/trunk/NEWS.txt>`__.
- For using cqlsh, the latest version of `Python 2.7 <https://www.python.org/downloads/>`__. To verify that you have
the correct version of Python installed, type ``python --version``.
-Installation from binary tarball files
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Choosing an installation method
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For most users, installing the binary tarball is the simplest choice. The tarball unpacks all its contents
+into a single location with binaries and configuration files located in their own subdirectories. The most
+obvious attribute of the tarball installation is it does not require ``root`` permissions and can be
+installed on any Linux distribution.
+
+Packaged installations require ``root`` permissions. Install the RPM build on CentOS and RHEL-based
+distributions if you want to install Cassandra using YUM. Install the Debian build on Ubuntu and other
+Debian-based distributions if you want to install Cassandra using APT. Note that both the YUM and APT
+methods required ``root`` permissions and will install the binaries and configuration files as the
+``cassandra`` OS user.
+
+Installing the binary tarball
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+1. Verify the version of Java installed. For example:
+
+::
+
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
+
+2. Download the binary tarball from one of the mirrors on the `Apache Cassandra Downloadi <http://cassandra.apache.org/download/>`__
+ site. For example, to download 3.11.6:
Review comment:
It's a little odd to tell people to download 3.11 in the 4.0 documentation. Can you edit this to be a little more generic (or at least use version 4.0)?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] flightc commented on a change in pull request #520:
CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
flightc commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405263848
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
+- CentOS & RedHat Enterprise Linux (RHEL) including 6.6 to 7.7
+- Amazon Linux AMIs including 2016.09 through to Linux 2
+- Debian versions 8 & 9
+- SUSE Enterprise Linux 12
+
+This is not an exhaustive list of operating system platforms, nor is it prescriptive. However users will be
+well-advised to conduct exhaustive tests of their own particularly for less-popular distributions of Linux.
+Deploying on older versions is not recommended unless you have previous experience with the older distribution
+in a production environment.
+
Prerequisites
^^^^^^^^^^^^^
-- The latest version of Java 8, either the `Oracle Java Standard Edition 8
+- Install the latest version of Java 8, either the `Oracle Java Standard Edition 8
<http://www.oracle.com/technetwork/java/javase/downloads/index.html>`__ or `OpenJDK 8 <http://openjdk.java.net/>`__. To
verify that you have the correct version of java installed, type ``java -version``.
-
+- **NOTE**: *Experimental* support for Java 11 was added in Cassandra 4.0 (`CASSANDRA-9608 <https://issues.apache.org/jira/browse/CASSANDRA-9608>`__).
+ Running Cassandra on Java 11 is *experimental*. Do so at your own risk. For more information, see
+ `NEWS.txt <https://github.com/apache/cassandra/blob/trunk/NEWS.txt>`__.
- For using cqlsh, the latest version of `Python 2.7 <https://www.python.org/downloads/>`__. To verify that you have
the correct version of Python installed, type ``python --version``.
-Installation from binary tarball files
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Choosing an installation method
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For most users, installing the binary tarball is the simplest choice. The tarball unpacks all its contents
+into a single location with binaries and configuration files located in their own subdirectories. The most
+obvious attribute of the tarball installation is it does not require ``root`` permissions and can be
+installed on any Linux distribution.
+
+Packaged installations require ``root`` permissions. Install the RPM build on CentOS and RHEL-based
+distributions if you want to install Cassandra using YUM. Install the Debian build on Ubuntu and other
+Debian-based distributions if you want to install Cassandra using APT. Note that both the YUM and APT
+methods required ``root`` permissions and will install the binaries and configuration files as the
+``cassandra`` OS user.
+
+Installing the binary tarball
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+1. Verify the version of Java installed. For example:
+
+::
+
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
+
+2. Download the binary tarball from one of the mirrors on the `Apache Cassandra Downloadi <http://cassandra.apache.org/download/>`__
+ site. For example, to download 3.11.6:
Review comment:
I've only picked 3.11.6 because I didn't have URLs for a non-alpha 4.0 and I wasn't sure that the version designation would be -- `4.0` vs `4.0.0`. :)
I've fudged it now to use `4.0.0`. Cheers!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] rustyrazorblade closed pull request #520:
CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
rustyrazorblade closed pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] flightc commented on a change in pull request #520:
CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
flightc commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405264466
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
Review comment:
It was a hangup from the `2.x` releases. I've updated it now to "16.04 to 18.04". 👍
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] rustyrazorblade commented on a change in pull request
#520: CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
rustyrazorblade commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405201208
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
Review comment:
We don't test on Ubuntu 14. I'm wary of listing it. I don't know if we have an "official" supported release of Ubuntu, but I don't think anyone's using a version this old. Personally I'd limit this to no earlier than Ubuntu 16.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org
[GitHub] [cassandra] rustyrazorblade commented on a change in pull request
#520: CASSANDRA-15466 Improved installation page, added YUM instructions
Posted by GitBox <gi...@apache.org>.
rustyrazorblade commented on a change in pull request #520: CASSANDRA-15466 Improved installation page, added YUM instructions
URL: https://github.com/apache/cassandra/pull/520#discussion_r405200895
##########
File path: doc/source/getting_started/installing.rst
##########
@@ -19,88 +19,306 @@
Installing Cassandra
--------------------
+These are the instructions for deploying the supported releases of Apache Cassandra on Linux servers.
+
+Cassandra runs on a wide array of Linux distributions including (but not limited to):
+
+- Ubuntu, most notably LTS releases 14.04 to 18.04
+- CentOS & RedHat Enterprise Linux (RHEL) including 6.6 to 7.7
+- Amazon Linux AMIs including 2016.09 through to Linux 2
+- Debian versions 8 & 9
+- SUSE Enterprise Linux 12
+
+This is not an exhaustive list of operating system platforms, nor is it prescriptive. However users will be
+well-advised to conduct exhaustive tests of their own particularly for less-popular distributions of Linux.
+Deploying on older versions is not recommended unless you have previous experience with the older distribution
+in a production environment.
+
Prerequisites
^^^^^^^^^^^^^
-- The latest version of Java 8, either the `Oracle Java Standard Edition 8
+- Install the latest version of Java 8, either the `Oracle Java Standard Edition 8
<http://www.oracle.com/technetwork/java/javase/downloads/index.html>`__ or `OpenJDK 8 <http://openjdk.java.net/>`__. To
verify that you have the correct version of java installed, type ``java -version``.
-
+- **NOTE**: *Experimental* support for Java 11 was added in Cassandra 4.0 (`CASSANDRA-9608 <https://issues.apache.org/jira/browse/CASSANDRA-9608>`__).
+ Running Cassandra on Java 11 is *experimental*. Do so at your own risk. For more information, see
+ `NEWS.txt <https://github.com/apache/cassandra/blob/trunk/NEWS.txt>`__.
- For using cqlsh, the latest version of `Python 2.7 <https://www.python.org/downloads/>`__. To verify that you have
the correct version of Python installed, type ``python --version``.
-Installation from binary tarball files
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Choosing an installation method
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For most users, installing the binary tarball is the simplest choice. The tarball unpacks all its contents
+into a single location with binaries and configuration files located in their own subdirectories. The most
+obvious attribute of the tarball installation is it does not require ``root`` permissions and can be
+installed on any Linux distribution.
+
+Packaged installations require ``root`` permissions. Install the RPM build on CentOS and RHEL-based
+distributions if you want to install Cassandra using YUM. Install the Debian build on Ubuntu and other
+Debian-based distributions if you want to install Cassandra using APT. Note that both the YUM and APT
+methods required ``root`` permissions and will install the binaries and configuration files as the
+``cassandra`` OS user.
+
+Installing the binary tarball
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+1. Verify the version of Java installed. For example:
+
+::
+
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
+
+2. Download the binary tarball from one of the mirrors on the `Apache Cassandra Downloadi <http://cassandra.apache.org/download/>`__
+ site. For example, to download 3.11.6:
+
+::
+
+ $ curl -OL http://apache.mirror.digitalpacific.com.au/cassandra/3.11.6/apache-cassandra-3.11.6-bin.tar.gz
+
+NOTE: The mirrors only host the latest versions of each major supported release. To download an earlier
+version of Cassandra, visit the `Apache Archives <http://archive.apache.org/dist/cassandra/>`__.
+
+3. OPTIONAL: Verify the integrity of the downloaded tarball using one of the methods `here <https://www.apache.org/dyn/closer.cgi#verify>`__.
+ For example, to verify the hash of the downloaded file using GPG:
+
+::
+
+ $ gpg --print-md SHA256 apache-cassandra-3.11.6-bin.tar.gz
+ apache-cassandra-3.11.6-bin.tar.gz: CE34EDEB D1B6BB35 216AE97B D06D3EFC 338C05B2
+ 73B78267 556A99F8 5D30E45B
+
+Compare the signature with the SHA256 file from the Downloads site:
+
+::
+
+ $ curl -L https://downloads.apache.org/cassandra/3.11.6/apache-cassandra-3.11.6-bin.tar.gz.sha256
+ ce34edebd1b6bb35216ae97bd06d3efc338c05b273b78267556a99f85d30e45b
+
+4. Unpack the tarball:
+
+::
+
+ $ tar xzvf apache-cassandra-3.11.6-bin.tar.gz
+
+The files will be extracted to the ``apache-cassandra-3.11.6/`` directory. This is the tarball installation
+location.
+
+5. Located in the tarball installation location are the directories for the scripts, binaries, utilities, configuration, data and log files:
+
+::
+
+ <tarball_installation>/
+ bin/
+ conf/
+ data/
+ doc/
+ interface/
+ javadoc/
+ lib/
+ logs/
+ pylib/
+ tools/
+
+For information on how to configure your installation, see
+`Configuring Cassandra <http://cassandra.apache.org/doc/latest/getting_started/configuring.html>`__.
+
+6. Start Cassandra:
+
+::
+
+ $ cd apache-cassandra-3.11.6/
+ $ bin/cassandra
+
+NOTE: This will run Cassandra as the authenticated Linux user.
+
+You can monitor the progress of the startup with:
+
+::
+
+ $ tail -f logs/system.log
+
+Cassandra is ready when you see an entry like this in the ``system.log``:
+
+::
+
+ INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on /x.x.x.x:9042 (unencrypted)...
+
+7. Check the status of Cassandra:
+
+::
+
+ $ bin/nodetool status
+
+The status column in the output should report UN which stands for "Up/Normal".
+
+Alternatively, connect to the database with:
+
+::
+
+ $ bin/cqlsh
-- Download the latest stable release from the `Apache Cassandra downloads website <http://cassandra.apache.org/download/>`__.
+Installing the Debian packages
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- Untar the file somewhere, for example:
+1. Verify the version of Java installed. For example:
::
- tar -xzvf apache-cassandra-3.6-bin.tar.gz
+ $ java -version
+ openjdk version "1.8.0_222"
+ OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)
+ OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
-The files will be extracted into ``apache-cassandra-3.6``, you need to substitute 3.6 with the release number that you
-have downloaded.
+2. Add the Apache repository of Cassandra to the file ``cassandra.sources.list``. The latest supported
+ major version is 3.11 and the corresponding distribution name is ``311x`` (with an "x" as the suffix).
+ For older releases use ``30x`` for C* 3.0 series, ``22x`` for 2.2 and ``21x`` for 2.1. For example,
+ to add the repository for version 3.11 (``311x``):
+
+::
-- Optionally add ``apache-cassandra-3.6\bin`` to your path.
-- Start Cassandra in the foreground by invoking ``bin/cassandra -f`` from the command line. Press "Control-C" to stop
- Cassandra. Start Cassandra in the background by invoking ``bin/cassandra`` from the command line. Invoke ``kill pid``
- or ``pkill -f CassandraDaemon`` to stop Cassandra, where pid is the Cassandra process id, which you can find for
- example by invoking ``pgrep -f CassandraDaemon``.
-- Verify that Cassandra is running by invoking ``bin/nodetool status`` from the command line.
-- Configuration files are located in the ``conf`` sub-directory.
-- Since Cassandra 2.1, log and data directories are located in the ``logs`` and ``data`` sub-directories respectively.
- Older versions defaulted to ``/var/log/cassandra`` and ``/var/lib/cassandra``. Due to this, it is necessary to either
- start Cassandra with root privileges or change ``conf/cassandra.yaml`` to use directories owned by the current user,
- as explained below in the section on changing the location of directories.
+ $ echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
Review comment:
same versioning issue as above.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: pr-unsubscribe@cassandra.apache.org
For additional commands, e-mail: pr-help@cassandra.apache.org