Perform post-configuration procedures

Once the WEKA cluster is installed and configured, perform the following:

  1. Enable event notifications to the cloud (optional).

  2. Set the license.

  3. Start the cluster IO service.

  4. Check the cluster configuration.

  5. Bypass the proxy server (optional).

  6. Configure default data networking (optional).

1. Enable event notifications to the cloud (optional)

Enable event notifications to the cloud for support purposes using one of the following options:

  • Enable support through Weka Home

  • Enable support through a private instance of Weka Home

Enable support through Weka Home

Command: weka cloud enable

This command enables cloud event notification (via Weka Home), which allows the WEKA Customer Success Team to resolve any issues that may occur.

To learn more about this and how to enable cloud event notification, see WEKA Home - The WEKA support cloud.

Enable support through Local Weka Home

In closed environments, such as dark sites and private VPCs, it is possible to install Local WEKA Home, which is a private instance of WEKA Home.

Command: weka cloud enable --cloud-url=http://<weka-home-ip>:<weka-home-port>

This command enables the WEKA cluster to send event notifications to the Local WEKA Home.

For details, see Local WEKA Home overview.

2. Set the license

Command: weka cluster license set

To run IOs against the cluster, a valid license must be applied. Obtain a valid license and apply it to the WEKA cluster. For details, see License overview.

3. Start the cluster IO service

Command: weka cluster start-io

To start the system IO and exit from the initialization state, use the following command line:

weka cluster start-io

4. Check the cluster configuration

Check the cluster container

Command: weka cluster container

Use this command to display the list of containers and their details.

Example of a list of containers and their details

Check cluster container resources

Command: weka cluster container resources

Use this command to check the resources of each container in the cluster.

weka cluster container resources <container-id>

Example for a drive container resources output
Example of a compute container resources output
Example of a frontend container resources output

Check cluster drives

Command: weka cluster drive

Use this command to check all drives in the cluster.

Example

Check the Weka cluster status

Command: weka status

The weka status command displays the overall status of the WEKA cluster.

For details, see Cluster status.

5. Bypass the proxy server (optional)

If the WEKA cluster is deployed in an environment with a proxy server, a WEKA client trying to mount or download the client installation from the WEKA cluster may be blocked by the proxy server. You can disable the proxy for specific URLs using the shell no_proxy environment variable.

Procedure

  1. Connect to one of the WEKA backend servers (configuration changes made on this server are synchronized with all other servers in the cluster).

  2. Open the /etc/wekaio/service.conf file.

  3. In the [downloads_proxy] section, add to the no_proxy parameter a comma-separated list of IP addresses or qualified domain names of your WEKA clients and cluster backend servers. Do not use wildcards (*).

  4. Restart the agent service using the command:

6. Configure default data networking (optional)

Command: weka cluster default-net set

Instead of individually configuring IP addresses for each network device, WEKA supports dynamic IP address allocation. Users can define a range of IP addresses to create a dynamic pool, and these addresses can be automatically allocated on demand.

Mixed approach for Ethernet networking: For Ethernet networking, a mixed approach is supported. Administrators can explicitly assign IP addresses for specific network devices, while others in the cluster can receive automatic allocations from the specified IP range. This feature is particularly useful in environments with automated client spawning.

Use the following command to configure default data networking:

weka cluster default-net set --range <range> [--gateway=<gateway>] [--netmask-bits=<netmask-bits>]

Parameters

Parameter
Description

range*

A range of IP addresses reserved for dynamic allocation across the entire cluster.. Format: A.B.C.D-E

Example: 10.10.0.1-100

netmask-bits*

Number of bits in the netmask that define a network ID in CIDR notation.

gateway

The IP address assigned to the default routing gateway. It is imperative that the gateway resides within the same IP network as defined by the specified range and netmask-bits. This parameter is not applicable to InfiniBand (IB) or Layer 2 (L2) non-routable networks.

View current settings: To view the current default data networking settings, use the command: weka cluster default-net

Remove default data networking: If a default data networking configuration was previously set up on a cluster and is no longer needed, you can remove it using the command: weka cluster default-net reset

End of the installation and configuration for all workflow paths

What do next?

Add clients to an on-premises WEKA cluster

PreviousManually configure the WEKA cluster using the resource generatorNextAdd clients to an on-premises WEKA cluster

Last updated