Managing the Weka System

The Weka system is now installed. Now let's learn how to view, manage and operate it using either the CLI or the GUI, and perform the first IO to a WekaFS filesystem.
CLI
The Weka CLI is installed on each Weka host and is available through the weka command. It's possible tossh one of the hosts and run the weka command. This displays a list of all available top-level commands. You can go ahead and explore them.
1
$ weka
2
Usage:
3
    weka [--help] [--build] [--version] [--legal]
4
​
5
Description:
6
    The base command for all weka related CLIs
7
​
8
Subcommands:
9
   agent      Command s that control the weka agent (outside the weka containers)
10
   alerts     List alerts in the Weka cluster
11
   cloud      Cloud commands. List the cluster's cloud status, if no subcommand supplied.
12
   cluster    Commands that manage the cluster
13
   debug      Commands used to debug a weka cluster
14
   diags      Diagnostics commands to help understand the status of the cluster and its environment
15
   events     List all events that conform to the filter criteria
16
   fs         List filesystems defined in this Weka cluster
17
   local      Commands that control weka and its containers on the local machine
18
   mount      Mounts a wekafs filesystem. This is the helper utility installed at /sbin/mount.wekafs.
19
   nfs        Commands that manage client-groups, permissions and interface-groups
20
   org        List organizations defined in the Weka cluster
21
   security   Security commands.
22
   smb        Commands that manage Weka's SMB container
23
   stats      List all statistics that conform to the filter criteria
24
   status     Get an overall status of the Weka cluster
25
   umount     Unmounts wekafs filesystems. This is the helper utility installed at /sbin/umount.wekafs.
26
   user       List users defined in the Weka cluster
27
   version    When run without arguments, lists the versions available on this machine. Subcommands allow for
28
              downloading of versions, setting the current version and other actions to manage versions.
29
​
30
Options:
31
   --agent         Start the agent service
32
   -h, --help      Show help message
33
   --build         Prints the CLI build number and exits
34
   -v, --version   Prints the CLI version and exits
35
   --legal         Prints software license information and exits
Copied!
For more information about the CLI, refer to Getting Started with Weka CLI.
GUI
The Weka GUI is accessible at port 14000. It can be accessed from any host or by using the cluster name. For example: https://weka01:14000 or https://WekaProd:14000.
Note: If it's not possible to access the GUI, make sure that it has been opened in your firewall, as described on the Prerequisites page.
Weka Login Page
The initial default username/password is admin/admin, as described in User Management. It is enforced to change the admin password upon the first login.
For more information about the GUI, refer to Getting Started with Weka GUI.
Note: It is possible to set up external monitoring via Grafana. For more information, refer to External Monitoring.
REST API
The Weka system supports a RESTful API. This is useful when automating the interaction with the Weka system and when integrating it into your workflows or monitoring systems.
The API is accessible at port 14000, via the /api/v2 URL, you can explore it via /api/v2/docs when accessing from the cluster (e.g. https://weka01:14000/api/v2/docs).
 Our static API documentation can be accessed from api.docs.weka.io (the version of the .json file can be changed to reflect the desired version, e.g., 3.11.json). This file can also be used to create your client code, using an OpenAPI client generator.
Obtaining an Access Token
You must provide an access token to use the Weka REST API. 
To obtain access/refresh tokens via the CLI, refer to Obtaining an Authentication Token section (there you can also generate an access token with a longer expiry time). To obtain access/refresh tokens via the API, you can call the login API, providing it a username and password. 
If you already obtained a refresh token, you can use the login/refresh API to refresh the access token.
Login
Refresh
Python example calling the login API
1
import requests
2
​
3
url = "https://weka01:14000/api/v2/login"
4
​
5
payload="{\n    \"username\": \"admin\",\n    \"password\": \"admin\"\n}"
6
headers = {
7
  'Content-Type': 'application/json'
8
}
9
​
10
response = requests.request("POST", url, headers=headers, data=payload)
11
​
12
print(response.text)
13
​
Copied!
Python example calling the login refresh API
1
import requests
2
​
3
url = "https://weka01:14000/api/v2/login/refresh"
4
​
5
payload="{\n    \"refresh_token\": \"REPLACE-WITH-REFRESH-TOKEN\"\n}"
6
headers = {
7
  'Content-Type': 'application/json'
8
}
9
​
10
response = requests.request("POST", url, headers=headers, data=payload)
11
​
12
print(response.text)
13
​
Copied!
In response, you will get an access token (valid for 5 minutes), that can be used in the other APIs that require token authentication, along with the refresh token (valid for 1 year), for getting additional access tokens without using the username/password.
Login/Refresh Response
1
{
2
  "data": [
3
    {
4
      "access_token": "ACCESS-TOKEN",
5
      "token_type": "Bearer",
6
      "expires_in": 300,
7
      "refresh_token": "REFRESH-TOKEN"
8
    }
9
  ]
10
}
Copied!
Calling the REST API
Now, that you have obtained an access token, you can call Weka REST API commands with it. For example, you can query the cluster status:
Python example calling cluster status API
1
import requests
2
​
3
url = "https://weka01:14000/api/v2/cluster"
4
​
5
payload={}
6
headers = {
7
  'Authorization': 'Bearer REPLACE-WITH-ACCESS-TOKEN'
8
}
9
​
10
response = requests.request("GET", url, headers=headers, data=payload)
11
​
12
print(response.text)
13
​
Copied!
​

Getting Started with Weka - Previous

Quick Install Guide

Next - Getting Started with Weka

CLI Overview

Last modified 1mo ago

Copy link

Contents

CLI

GUI

REST API

Obtaining an Access Token

Calling the REST API