Actian Monitor > Installing Actian Monitor > Installing Actian Monitor on Linux
Was this helpful?
Installing Actian Monitor on Linux
The steps to install Actian Monitor on Linux are as follows:
1. Download the tar file from http://esd.actian.com.
2. Extract the contents of the uncompressed Actian Monitor image. For example:
tar xvf actian_AM.tar
3. Run the install command for Linux with necessary options:
sh install.sh [-t install_directory]
Set options:
Install Options
Description
-t, --install-target
Installation directory (default: current directory)
-i, --instance-id
DBMS instance ID (optional). If left blank, omitted, or set to auto, the installer will try to detect the instance ID automatically. This may not work for customer installations.
-H, --hostname
DBMS leader hostname or IP address. The hostname should be either the DBMS DNS machine name or the IP address.
Note:  Do not use localhost as the hostname.
-u, --ssh-user
The DBMS SSH username (usually ingres or actian) that can log in using SSH to all nodes. In a multi-node installation, all nodes must support identical user credentials.
-p, --ssh-password
SSH password (leave blank or set to 'none' for SSH key authentication)
-P, --ssh-port
SSH port (default: 22)
-e, --instance-setenv
Command to initialize the Ingres/Analytics Engine environment (optional).
If left blank or omitted, the installer assumes the environment is already active for the SSH login.
-j, --jdbc-user
The JDBC username to be used for all JDBC connections. The user requires access to and must have TRACE and IMA_SEC_READ privileges on the IMADB database.
-J, --jdbc-password
JDBC password
-n, --nodes
Additional nodes for multi-node setup. This list is only used for obtaining SSH key fingerprints and can be left blank if the keys will be provided manually. Do not include the leader node in this list.
Note:  To clear out an existing node list, set to ‘none’.
-k, --ssh-server-keys
SSH server key fingerprints (comma-separated). Leave blank or set to ‘auto’ to automatically discover using ssh-keyscan.
Note:  You need SSH key fingerprints for all nodes in a multi-node installation.
-s --ssh_key_paths
List of SSH private key files for key-based authentication (password must be empty)
--container-engine
Select engine used by the installer:
docker
podman
auto (default)
--dry-run
Validate inputs and show planned actions without installing
--unattended
No prompts, exit on error
--tenant-label
Label identifying the database server in metrics (Prometheus/Grafana). This distinguishes servers that share the same instance ID. This option is independent of --hostname, which is used only for the SSH/JDBC connection. Defaults to the server hostname or IP address.
-grafana-access-mode
Selects the Grafana access mode. This option applies only to a full installation (--install-type full). The available modes are:
view-anonymous (default): Users can view dashboards without signing in. To make any changes, login with the randomly generated administrator password is required.
login-required: Users must sign in to view dashboards.
anonymous-admin: Provides behavior from before version 1.2. Users can view and modify dashboards without signing in. The default administrator credentials are admin/admin.
-h, --help
Show help message
Example:
./install.sh \
--hostname db.example.com \
--ssh-user admin \
--ssh-password secret \
--jdbc-user monitor \
--jdbc-password dbpass \
--dry-run
Note:  Command line options are not required. The installer prompts for all required fields before installing Actian Monitor.
Last modified date: 09/11/2026