mirror of
https://github.com/scylladb/scylladb.git
synced 2026-05-25 09:11:10 +00:00
855c503c63
This commit updates the documentation for the unified installer. - The Open Source example is replaced with version 2025.1 (Source Available, currently supported, LTS). - The info about CentOS 7 is removed (no longer supported). - Java 8 is removed. - The example for cassandra-stress is removed (as it was already removed on other installation pages). Fixes https://github.com/scylladb/scylladb/issues/28150 Closes scylladb/scylladb#28152
144 lines
3.9 KiB
ReStructuredText
144 lines
3.9 KiB
ReStructuredText
====================================================
|
||
Install ScyllaDB Without root Privileges
|
||
====================================================
|
||
|
||
This document covers installing, uninstalling, and upgrading ScyllaDB using Unified Installer.
|
||
Unified Installer is recommended when you do not have root privileges to the server.
|
||
If you have root privileges, we recommend installing ScyllaDB with
|
||
:doc:`ScyllaDB Web Installer </getting-started/installation-common/scylla-web-installer/>`
|
||
or by downloading the OS-specific packages (RPMs and DEBs) and installing them with
|
||
the package manager (dnf and apt).
|
||
|
||
Prerequisites
|
||
---------------
|
||
Ensure your platform is supported by the ScyllaDB version you want to install.
|
||
See `OS Support <https://docs.scylladb.com/stable/versioning/os-support-per-version.html>`_
|
||
for information about supported Linux distributions and versions.
|
||
|
||
Download and Install
|
||
-----------------------
|
||
|
||
#. Download the latest tar.gz file for ScyllaDB version (x86 or ARM) from ``https://downloads.scylladb.com/downloads/scylla/relocatable/scylladb-<version>/``.
|
||
|
||
**Example** for version 2025.1:
|
||
|
||
- Go to https://downloads.scylladb.com/downloads/scylla/relocatable/scylladb-2025.1/
|
||
- Download the ``scylla-unified`` file for the patch version you want to
|
||
install. For example, to install 2025.1.9 (x86), download
|
||
``scylla-unified-2025.1.9-0.20251010.6c539463bbda.x86_64.tar.gz``.
|
||
|
||
#. Uncompress the downloaded package.
|
||
|
||
**Example** for version 2025.1.9 (x86) (downloaded in the previous step):
|
||
|
||
.. code::
|
||
|
||
tar xvfz scylla-unified-2025.1.9-0.20251010.6c539463bbda.x86_64.tar.gz
|
||
|
||
#. (Root offline installation only) For root offline installation on Debian-like
|
||
systems, two additional packages, ``xfsprogs`` and ``mdadm``, should be
|
||
installed to be used in RAID setup.
|
||
|
||
#. Install ScyllaDB as a user with non-root privileges:
|
||
|
||
.. code:: console
|
||
|
||
./install.sh --nonroot
|
||
|
||
Configure and Run ScyllaDB
|
||
----------------------------
|
||
|
||
#. Run the ScyllaDB setup script:
|
||
|
||
.. code:: console
|
||
|
||
~/scylladb/sbin/scylla_setup
|
||
|
||
#. Start ScyllaDB:
|
||
|
||
.. code:: console
|
||
|
||
systemctl --user start scylla-server
|
||
|
||
#. Verify that ScyllaDB is running:
|
||
|
||
.. code:: console
|
||
|
||
systemctl --user status scylla-server
|
||
|
||
Now you can start using ScyllaDB. Here are some tools you may find useful.
|
||
|
||
|
||
Run nodetool:
|
||
|
||
.. code:: console
|
||
|
||
~/scylladb/bin/nodetool nodetool status
|
||
|
||
Run cqlsh:
|
||
|
||
.. code:: console
|
||
|
||
~/scylladb/bin/cqlsh
|
||
|
||
|
||
.. note::
|
||
|
||
You can avoid adding the extended prefix to the commands by exporting the binary directories to PATH:
|
||
|
||
``export PATH=$PATH:~/scylladb/python3/bin:~/scylladb/share/cassandra/bin/:~/scylladb/bin:~/scylladb/sbin``
|
||
|
||
|
||
Upgrade/ Downgrade/ Uninstall
|
||
---------------------------------
|
||
|
||
.. _unified-installed-upgrade:
|
||
|
||
Upgrade
|
||
=========
|
||
|
||
The unified package is based on a binary package; it’s not a RPM / DEB packages, so it doesn’t upgrade or downgrade by yum / apt. To upgrade ScyllaDB, run the ``install.sh`` script.
|
||
|
||
Root install:
|
||
|
||
.. code:: sh
|
||
|
||
./install.sh --upgrade
|
||
|
||
Nonroot install
|
||
|
||
.. code:: sh
|
||
|
||
./install.sh --upgrade --nonroot
|
||
|
||
.. note:: The installation script does not upgrade scylla-tools. You will have to upgrade them separately.
|
||
|
||
Uninstall
|
||
===========
|
||
|
||
Root uninstall:
|
||
|
||
.. code:: sh
|
||
|
||
sudo ./uninstall.sh
|
||
|
||
Nonroot uninstall
|
||
|
||
.. code:: sh
|
||
|
||
./uninstall.sh --nonroot
|
||
|
||
|
||
Downgrade
|
||
===========
|
||
|
||
To downgrade to your original ScyllaDB version, use the Uninstall_ procedure, then install the original ScyllaDB version.
|
||
|
||
Next Steps
|
||
------------
|
||
|
||
* :doc:`Configure ScyllaDB </getting-started/system-configuration>`
|
||
* Manage your clusters with `ScyllaDB Manager <https://manager.docs.scylladb.com/>`_
|
||
* Monitor your cluster and data with `ScyllaDB Monitoring <https://monitoring.docs.scylladb.com/>`_
|
||
* Get familiar with ScyllaDB’s :doc:`command line reference guide </operating-scylla/nodetool>`.
|
||
* Learn about ScyllaDB at `ScyllaDB University <https://university.scylladb.com/>`_ |