Complete guide for installing ScyllaDB, Java 8, and enabling the Ecosystem Add-On
This guide covers installing and configuring ScyllaDB (v5.4), Java 8, and enabling the Ecosystem Add-On for your Bicrypto platform. You'll also learn how to manually create a new ScyllaDB user and update your .env accordingly.
Open the Root Terminal in Virtualmin (or SSH into your server).
Execute the following commands to install ScyllaDB version 5.4:
sudo mkdir -p /etc/apt/keyrings
sudo gpg --homedir /tmp --no-default-keyring --keyring /etc/apt/keyrings/scylladb.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys d0a112e067426ab2
sudo curl -L --output /etc/apt/sources.list.d/scylla.list https://downloads.scylladb.com/deb/ubuntu/scylla-5.4.list
sudo apt-get update
sudo apt-get install -y scylla
Run the following commands to install Java 8:
sudo apt-get update
sudo apt-get install -y openjdk-8-jre-headless
sudo update-java-alternatives --jre-headless -s java-1.8.0-openjdk-amd64
This ensures Java 8 is installed and set as your default Java runtime for headless environment.
nano /etc/scylla/scylla.yaml
Find api_port: 10000 and modify it to api_port: 10001. This avoids conflicts with Virtualmin's default port 10000.
Locate # authenticator: AllowAllAuthenticator and change it to:
authenticator: PasswordAuthenticator
Press Ctrl + X, type Y to confirm, then Enter to save.
sudo scylla_setup
Follow the on-screen prompts. The setup process includes multiple configuration steps:
sudo systemctl start scylla-server
sudo systemctl enable scylla-server
Go to your site's Admin side: System > Extensions.
Select the Ecosystem extension page.
Verify your License: If it's your first time, you may need to verify the license or install the add-on manually by contacting support.
Check for Updates: Click Check for Updates, then Update. Refresh the page once it's done.
Enable the Extension: If you're on the latest version, click Enable.
Run PNPM Updator: Open the User Terminal, navigate to public_html, and run:
pnpm updator
Here's how to create a new ScyllaDB user manually:
Open the Root Terminal in Virtualmin (or SSH into your server).
By default, ScyllaDB comes with cassandra:cassandra for the superuser. Run:
cqlsh -u cassandra -p cassandra
Inside the cqlsh prompt, type:
CREATE ROLE IF NOT EXISTS new_username WITH PASSWORD = 'new_password' AND LOGIN = true AND SUPERUSER = true;
new_username = Your desired usernamenew_password = A strong password
Press Enter to execute. This will create (or update) a superuser role.
Exit cqlsh by typing exit or pressing Ctrl + D, then reconnect using your new credentials:
cqlsh -u new_username -p new_password
If you can run describe keyspaces; without errors, the new user is valid.
Go to File Manager and edit the .env file:
In your .env file (within public_html or your project root), add or edit these lines:
SCYLLA_USERNAME="new_username"
SCYLLA_PASSWORD="new_password"
Save and close the file. Make sure you have the correct syntax (use quotes if needed).
If you need to set up an encryption passphrase for KMS (Key Management Service) within Bicrypto:
Go to the User Terminal and enter public_html:
cd public_html
Run the following command to generate a passphrase:
node ./scripts/kms/generate.mjs
This script will:
ENCRYPTED_ENCRYPTION_KEY to your .env if not already setStill in the User Terminal, run:
pnpm updator:backend
This applies any new environment settings (e.g., .env changes, encryption keys) to your Bicrypto backend.
ScyllaDB Status
Check systemctl status scylla-server
Check Logs
Use journalctl -u scylla-server or pm2 log
Ecosystem Features
Confirm advanced trading features work properly
Additional Modules
Test blockchain integration and wallet functionality
By installing ScyllaDB, configuring Java 8, enabling password authentication, and integrating the Ecosystem add-on, your Bicrypto platform can leverage high-performance features and additional functionalities. Always secure your server, rotate credentials periodically, and monitor logs for potential issues.