Introducing the LINBIT GUI

A Visual Approach to LINBIT SDS

Here at LINBIT®, we live at the shell prompt, but on occasion, getting a graphical view of things can provide benefits, so we have developed a graphical user interface (GUI) for LINSTOR® that is available to LINBIT customers with an exciting interface and sensible workflows.

Reasons for Using the LINBIT GUI

The LINBIT GUI allows you to view complex LINSTOR environments quickly and also lets administrators who are unfamiliar with the command line promptly observe the status of deployments without the need to resort to the CLI. By using the GUI, you can deploy new storage resources or edit existing resources. You can easily take control over your NFS, iSCSI, NVMe-oF targets, and much more.

Installing the LINBIT GUI

For existing LINSTOR customers, installing the LINBIT GUI is as simple as using your distribution’s package manager to get up and running in just a few moments. From your LINSTOR controller node, enter the appropriate command below to install the latest version of the LINBIT GUI.

For RPM-based Linux distributions:

# dnf -y install linstor-gui

For APT-based systems:

# apt update && apt -y install linstor-gui

📝 NOTE: Your nodes should already be configured to provide access to LINBIT software package repositories. However, if you need to configure repository access on your controller node, you can use the LINBIT manage node script to do this and enable the drbd-9 LINBIT package repository.

The installation should only take a few seconds. Once the package has been installed, the GUI is ready to go. No additional actions are required.

If you are installing a new instance of LINSTOR, the GUI is automatically installed as part of the linbit-sds-controller meta-package.

Using the LINBIT GUI

Using the LINBIT GUI is as simple as opening up your favorite web browser and then connecting to the LINSTOR controller node where you performed the installation. First, open your web browser and navigate to: http://<CONTROLLER_IP>:3370.

📝 NOTE:: If you have secured your LINSTOR controller with SSL/TLS, you will need to access the GUI via HTTPS using port 3371.

Logging Into The LINBIT GUI

When you first access the GUI, an authentication page will greet you.

You can log in for the first time by using the default username, admin, and default password, admin. After logging in, you will be taken to the dashboard page that provides a quick overview of your cluster. By clicking on your username icon in the upper right corner of the page and then clicking on the “Change Password” menu item, you can change the default password.

Selecting a Different Language

If you prefer working in a language other than English, the GUI supports eight languages: English, German, Chinese, Japanese, Turkish, Spanish, French, and Russian. Just select your desired language from the drop-down menu in the upper right corner.

Navigating the LINBIT GUI Dashboard

From the Dashboard, you can select any option from the left menu to navigate to the appropriate page, for example, to manage your cluster inventory or your storage configuration.

Managing LINSTOR Nodes

The LINBIT GUI supports managing LINSTOR controller and satellite nodes. By expanding the Inventory menu item, you can then click on Nodes to see a list of your LINSTOR cluster nodes showing the controller and the satellites in this view. From this page, you can either view a node’s details or else click on the “three dots” icon to the right of the node to access a menu of actions that you can perform on that node.

For example, you can view and set properties for a node by clicking on the Properties action menu item. You can use LINSTOR node properties to do such things as constraining automatic LINSTOR resource placement.

⚠️ WARNING: Some pages allow you to view and set properties for the nodes or other LINSTOR objects, such as resources or resource groups. This can be very convenient, especially if you are unfamiliar with all available properties. However, use caution before changing properties unless you are familiar with the resulting changes! If you are unsure, check resources like the LINSTOR User’s Guide or the LINBIT Community Slack message board.

The Nodes page also allows you to add or remove nodes from the cluster easily. If this is a new LINSTOR installation, you would start by adding nodes to define your LINSTOR cluster.

Managing Your Software-Defined Storage

After configuring your LINSTOR cluster nodes and storage pools, you can use the LINBIT GUI to create software-defined storage for your applications and services to consume. You do this through actions that are available under the Storage Configuration menu topics. Here, you can create, delete, edit, and otherwise manage LINSTOR storage objects: resource groups, resource definitions, resources, and volumes.

Other Management Actions

Besides managing your LINSTOR cluster nodes and LINSTOR objects, you can also use the LINBIT GUI to create and manage snapshots of your storage, view and delete LINSTOR error reports, and even customize the dashboard reporting by pointing to your own Grafana dashboard.

Benefits of the LINBIT GUI

Providing your administrators with an additional tool to manage the cluster is a great benefit, especially in environments with administrators that might not be familiar with Linux or working from the command line. Productivity does not have to wait for an administrator to climb a CLI learning curve, as drop-down menu navigation and dashboard status representations are intuitive.

This tool is available to LINBIT customers for the low, low price of free! It’s a great tool to make available to your staff.

Getting Started With The LINBIT GUI

If you are interested in trying the LINBIT GUI, LINBIT Solutions Architect, Ryan Ronnander, made a video about using the LINBIT GUI to create a LINSTOR cluster and provision storage resources.