Deploy monitoring tools using the WEKA Management Station (WMS)

Deploy the monitoring tools, LWH, WEKAmon, and SnapTool, using the WEKA Management Station (WMS) in an on-premises environment.

The WEKA Management Station (WMS) is an installation kit similar to an OS installation disk that simplifies the installation and configuration of the Local WEKA Home (LWH), WEKAmon, and SnapTool in an on-premises environment. The WMS installs the WEKA OS, drivers, and WEKA software automatically and unattended.

The WMS can also install a WEKA cluster by deploying the WEKA Software Appliance (WSA) package on bare metal servers.

See the related topics to learn about the tools installed with the WMS.

Related topics

WEKA Home - The WEKA support cloud

Set up the WEKAmon external monitoring

Set up the SnapTool external snapshots manager

WEKA cluster installation on bare metal servers

WMS deployment prerequisites

The server or VM must meet the following requirements:

  • Boot drives: One or two identical boot drives as an installation target.

    • A system with two identical boot drives has the OS installed on mirrored partitions (LVM).

    • A system with one drive has a simple partition.

  • Minimum boot drive capacity:

    • If not configuring LWH: SSD 125 GiB.

    • If configuring LWH: See the SSD-backed storage requirements section in #1.-verify-prerequisites.

  • Boot type: UEFI boot (BIOS boot is also supported but deprecated).

  • Cores and RAM:

    • If not configuring LWH: minimum 4 cores and 16 GiB.

    • If configuring LWH, see the Server minimum CPU and RAM requirements section in #1.-verify-prerequisites.

  • Network interface: 1 Gbps.

  • Firewall rules: The WMS listens on multiple ports depending on which service you are accessing. See Required ports

This workflow only applies to installation on a server or VM. It does not apply to installation on AWS. To install on AWS, contact the Customer Success Team.

Before you begin

Before deploying the WMS, adhere to the following:

  • The root password is WekaService

  • The WEKA user password is weka.io123

  • If errors occur during installation and the installation halts (no error messages appear), use the system console to review the logs in /tmp. The primary log is /tmp/ks-pre.log.

  • To get a command prompt from the Installation GUI, do one of the following:

    • On macOS, type ctrl+option+f2

    • On Windows, type ctrl+alt+f2.

  • Creating a unique local username dedicated to WMS with a ClusterAdmin or OrgAdmin role is highly recommended. The unique username is displayed in the event logs, making identifying and troubleshooting issues easier. To create a local user, see the Create local users topic.

WMS deployment workflow

Install the WMS


  1. Download the latest WMS image from (requires sign-in).

  2. Boot the server from the WMS image. The following are some options to do that:

Copy the WEKA Management Station ISO image to an appropriate location so the server’s BMC (Baseboard Management Controller) can mount it or be served through a PXE (Preboot Execution Environment).

Once you boot the server, the WEKA Management Station installs the WEKA OS (Rocky Linux), drivers, and WEKA software automatically and unattended (no human interaction required).

Depending on network speed, this can take about 10-60 mins (or more) per server.

Configure the WMS

Once the WMS installation is complete and rebooted, configure the WMS.


  1. Run the OS using one of the following options:

Run the OS through the BMC’s Console. See the specific manufacturer’s BMC documentation.

  1. Browse to the WMS Admin UI using the following URL: https://<WMS-hostname-or-ip>:8501

  1. If you have created a local username dedicated to WMS, as recommended, enter its credentials. Otherwise, enter the default username and password admin/admin. Then, select Login. The Landing Page appears.

Change password

The default password is admin. It is recommended to change it for security reasons.


  1. From the left pane, select Change Password.

  2. Provide your current password, choose a new password, confirm the new password, and click Reset.

Configure the email notifications

Set up email notifications by configuring the SMTP Relay to enable WMS for sending notifications related to:

  • LWH alerts and events: The LWH sends email alerts and events notifications.

  • WEKAmon quota notifications: The WEKAmon Alert Manager sends email alerts when a user reaches the soft quota limit.


  1. From the left pane, select Email Notification Settings.

  2. Set the required details:

    • Email From Name: The designated name for the sender of WMS emails.

    • Email From Address: The email address used for outgoing emails from WMS.

    • Email Relay Host: The smart host or upstream SMTP Relay address WMS uses for sending emails.

    • Email Relay Port: The port number used on the SMTP Relay. Typically set to 25, 465, 587, or 2525.

    • SMTP Relay allows/requires TLS: Select if the SMTP Relay uses TLS encryption.

    • Email Relay Username: Enter the username for logging into the SMTP Relay, if necessary.

    • Email Relay Password: Enter the password for logging into the SMTP Relay, if necessary.

    • Allow Insecure TLS with SMTP Relay: Enable TLS for an SMTP Relay with a self-signed certificate.

  3. Select Save.

Install and configure the LWH


  1. From the left pane, select Configure Local WEKA Home.

  2. Set the required details:

    • Listen Address/Domain: Specify the address or hostname on which LWH will listen. Leave it blank or use to listen on all interfaces. Alternatively, input an IP address, hostname, or FQDN as the TLS certificate requires.

    • Email Alert Domain Name (REQUIRED): Enter a domain name (or IP address) for Alert Email URL links. For instance, if you input, the links appear as Typically, this is the domain you use to access WMS (this server's name).

    • Enable Ingress TLS: Toggle to enable TLS for all connections.

    • TLS Cert: Specify the TLS certificate to be used.

    • TLS Key: Enter the TLS key corresponding to the specified certificate above.

    • Enable email notifications (configure in the Email Notification Setting page): Activate email notifications and set up your email server configurations in the Email Notification Settings page.

    • Enable forwarding data to Cloud WEKA Home: Activate this feature to send data to Cloud WEKA Home. Internet connectivity to is required for this functionality. The default setting is activated.

  1. Select Save. The WMS saves the configuration and installs the Minikube and LWH. This process can take several minutes. When the process completes, the following appears:

  1. Retrieve the LWH Admin and Grafana passwords as follows:

    • Select Get Admin Password. The password appears below the button.

    • Select Get Grafana Password. The password appears below the button. This password only applies to the Grafana instance within LWH (not related to the Grafana instance of the WEKAmon).

  1. Register the cluster with the LWH.

    • Choose one of the backend servers in your cluster to run the command.

    • Run the appropriate command based on your TLS configuration. If TLS is configured, use the following command with the WMS server IP or hostname:

      weka cloud enable --cloud-url https://<WMS server IP or hostname>

      If TLS is not configured, use the following command with the WMS server IP or hostname:

      weka cloud enable --cloud-url http://<WMS server IP or hostname>

      Ensure that the provided WMS server IP or hostname matches the WMS instance information.

The WMS can have multiple IP interfaces, such as when installed as a jump host with distinct interfaces for the corporate network and the cluster network. In scenarios where the cluster is isolated from the corporate network, it is essential to specify the IP address of the WMS associated with the cluster network.

  1. Log in to the LWH. On the Landing Page, select Open Local WEKA Home. If the tab does not appear, check that the browser pop-up blocker does not block it. When prompted for a password, enter the Admin password retrieved in the previous steps. The LWH Cluster Overview page opens on a new tab.

Reconfiguring LWH: If required, return to the LWH configuration page, update the configuration, and select Save again. The LWH configuration will be updated and restarted.

Configure the WEKAmon


  1. From the left pane, select Configure WEKAmon.

  1. Select the services you want to enable. Possible options:

    • Enable Metrics Exporter & Grafana: Select to activate metrics exporter and Grafana integration to visualize and analyze performance metrics seamlessly.

    • Enable Quota Exporter & Notifications: Select to enable the WEKAmon to send notifications for soft storage quotas.

    • Enable Snaptool: Select to activate the snapshots manager, facilitating scheduled snapshots and automated operations.

    • Enable WEKAmon Log Storage: Select this option to enable long-term event storage within WEKAmon.

To set the quota limits, see Quota management.

  1. Set the hostname or public IP address, username, and password of the cluster to monitor (it can be a backend server of the cluster). Then, select Save.

If DNS does not have the hostnames of the cluster, do one of the following:

  • Edit the /etc/hosts file before trying again. See Edit the hosts file.

  • Use the Cockpit Web Interface on port 9090 to change the DNS settings. See Cockpit Web Interface in Configure the WMS.

Once the WMS successfully logs in to the cluster, the WEKAmon installation begins. When the WEKAmon installation is completed, you can open it from the WMS Landing Page.

  1. Log in to Grafana. On the Landing Page, select Grafana. If the tab does not appear, check that the browser pop-up blocker does not block it. When prompted for a username and password, enter the enter admin/admin (not the username/password that was retrieved for LWH). The Grafana page opens on a new tab.

Edit the hosts file

If the WEKA cluster servers are not resolvable with a DNS, resolve the server names and associate them with the relevant IP addresses accessible to the WMS in the /etc/hosts file.

The WMS provides a simple text editor to facilitate editing the /etc/hosts file.


  1. From the left pane, select Edit Hosts File.

  2. Add the IP addresses of the cluster servers. Type, copy, and paste as in any other simple text editor.

  3. Select Save.

Configure the Snaptool

Snaptool is pre-installed in the /opt/snaptool directory and includes all the containers, so there is no need to download anything. Only configuration is required.


  1. From the left pane, select Snaptool Configuration.

  2. In the Snaptool Configuration Editor, if required, you can update the configuration. For details, see Edit the configuration in the snaptool.yml file. Snaptool shares the same cluster login information as WEKAmon and automatically detects and re-loads its configuration when any changes are made.

  3. Select Save.

Download diagnostics logs

If errors occur during the WMS installation, download the diagnostics logs and send them to the Customer Success Team.


  1. From the left pane, select Download Logs.

  2. Select Gather Logs to collect the logs.

  3. Once finished, select Download Logs to save a local copy of the diagnostics tarball on your workstation.

  1. Share the downloaded files with the Customer Success Team.

Last updated