Skip to content

Unified package Offline Installer

Amos Kong edited this page Aug 20, 2020 · 3 revisions

Offline install procedure

Prepare

  1. Get the unified package
curl http://downloads.scylladb.com.s3.amazonaws.com/relocatable/unstable/master/latest/scylla-unified-package-0.20200819.2e1499ee93f.tar.gz \
-o scylla-unified-package-0.20200819.2e1499ee93f.tar.gz
  1. Uncompress the package
tar xvfz scylla-unified-package-0.20200819.2e1499ee93f.tar.gz

Install and Usage

Install and Usage for users have privileged permission by sudo

  1. Install
./install.sh
  1. Setup
sudo scylla_setup --disks /dev/sdb
  1. Start scylla-server
sudo systemctl start scylla

Install and Usage of Users have poor permission

  1. Install
./install.sh --nonroot --prefix `pwd`/install_root
  1. Setup

Skip for lack of sudo permission. Because scylla_setup requires sudo permission, some setup rely on systemd.

Some setup you can do manually or you can ask the Administrator:

  • raid setup
  • mount data disk
  • set /etc/fstab to mount data disk automatically
  1. Start scylla
cd ./install_root

# scylla scylla-jmx
./jmx/symlinks/scylla-jmx -Xmx256m -XX:+UseSerialGC -XX:+HeapDumpOnOutOfMemoryError -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.host=localhost -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=7199 -Djava.rmi.server.hostname=localhost -Dcom.sun.management.jmxremote.rmi.port=7199 -Djavax.management.builder.initial=com.scylladb.jmx.utils.APIBuilder -jar ./jmx/scylla-jmx-1.0.jar

# start scylla-sever

./bin/scylla --options-file ./etc/scylla/scylla.yaml  --developer-mode 1 --workdir ./var/lib/scylla

Stop scylla / scylla-jmx by Ctrl + C, or kill $pid

Usage

export PATH=$PATH:`pwd`/python3/bin

./bin/cqlsh --version
./bin/nodetool status

Noroot

Some scylla users have poor permission, they can't write system directory, they can't change system configuration.

  1. install.sh of scylla has an option --noroot

  2. developer mode

scylla can't be started for: NOFILE rlimit too low (recommended setting 200000, minimum setting 10000; refusing to start.

  • solution: enable developer-mode by appending '-developer-mode 1' to scylla cmdline

Systemd / Systemctl

If you don't have sudo permission, you can't change systemd configuration in scylla_setup. Then you can't manage scylla/scylla-jmx by systemd, you have to start scylla/scylla-jmx from command-line.

Other services relay on systemd:

  • housekeeping (it isn't disabled by default for install.sh)
  • mount data disk
    • need to manually set /etc/fstab to mount the data disk

Upgrade / Downgrade

Upgrade

The unified package is based on binary package, it's not a RPM / DEB packages, so it doesn't to upgrade or downgrade by yum / apt. Currently only install.sh of scylla supports to upgrade

./install.sh --upgrade ....

install.sh of scylla-jmx and scylla-tools don't support to upgrade.

Downgrade

Downgrade isn't supported by install.sh

Clone this wiki locally