Using Services

HEAVY.AI features two system services: heavydb and heavy_web_server. You can start these services individually using systemd.
Starting and Stopping HeavyDB Using systemd
For permanent installations of HeavyDB, HEAVY.AI recommends that you use systemd to manage HeavyDB services. systemd automatically handles tasks such as log management, starting the services on restart, and restarting the services if there is a problem.
In addition, systemd manages the open-file limit in Linux. Some cloud providers and distributions set this limit too low, which can result in errors as your HEAVY.AI environment and usage grow. For more information about adjusting the limits on open files, see Why am I seeing the error "Too many open files...erno24"? in Frequently Asked Questions.
Initial Setup
You use the install_heavy_systemd.sh script to prepare systemd to run HEAVY.AI services. The script asks questions about your environment, then installs the systemd service files in the correct location. You must run the script as the root user so that the script can perform tasks such as creating directories and changing ownership.
cd $HEAVYAI_PATH/systemd
sudo ./install_heavy_systemd.sh
The install_heavy_systemd.sh script asks for the information described in the following table.
Variable
Use
Default
Notes
HEAVYAI_PATH
Path to HeavyDB installation directory
Current install directory
HEAVY.AI recommends heavyai as the install directory.
HEAVYAI_BASE
Path to the storage directory for HeavyDB data and configuration files
heavyai
Must be dedicated to HEAVY.AI. The installation script creates the directory $HEAVYAI_STORAGE/data, generates an appropriate configuration file, and saves the file as $HEAVYAI_STORAGE/heavy.conf.
HEAVYAI_USER
User HeavyDB is run as
Current user
User must exist before you run the script.
 HEAVYAI_GROUP
Group HeavyDB is run as
Current user's primary group
Group must exist before you run the script.
Starting HeavyDB Using systemd
To manually start HeavyDB using systemd, run:
sudo systemctl start heavydb
sudo systemctl start heavy_web_server
Restarting HeavyDB Using systemd
You can use systemd to restart HeavyDB — for example, after making configuration changes:
sudo systemctl restart heavydb
sudo systemctl restart heavy_web_server
Stopping HeavyDB Using systemd
To manually stop HeavyDB using systemd, run:
sudo systemctl stop heavydb
sudo systemctl stop heavy_web_server
Enabling HeavyDB on Startup
To enable the HeavyDB services to start on restart, run:
sudo systemctl enable heavydb
sudo systemctl enable heavy_web_server
Using Configuration Parameters
You can customize the behavior of your HEAVY.AI servers by modifying your heavy.conf configuration file. See Configuration Parameters.

Installation and Configuration - Previous

Services and Utilities

Using Utilities

Last modified 3mo ago

Export as PDF

Copy link

On this page

Starting and Stopping HeavyDB Using systemd

Initial Setup

Starting HeavyDB Using systemd

Restarting HeavyDB Using systemd

Stopping HeavyDB Using systemd

Enabling HeavyDB on Startup

Using Configuration Parameters

Starting and Stopping HeavyDB Using `systemd`

Initial Setup

Starting HeavyDB Using `systemd`

Restarting HeavyDB Using `systemd`

Stopping HeavyDB Using `systemd`

Enabling HeavyDB on Startup

Using Configuration Parameters