LiquidFiles Documentation
LiquidFiles Documentation

Logging in to the System Console

While console login as root is permitted with LiquidFiles. That does not mean that making any changes are supported.

If you login to the console, it is assumed that you know what you are doing and are comfortable administrating Unix/Linux/Ubuntu systems.

If anything happens and you don't know how to fix it, you will likely have to re-install the LiquidFiles system to get back to a supported state.

Console login is only available after you've installed a valid license.
Please note that this document refers to LiquidFiles v2.x & v3.x. Please see the console v4 guide for documentation how to access the console on a LiquidFiles v4.x system.

How do I login to the console in LiquidFiles?

Every system has a console, either you have a physical system to which you connect a keyboard and monitor, or you have a virtual system where the virtual system provides the console somehow. In VMware ESX for instance, there's a console tab.

VMware ESX Console Example

After you've clicked on the console tab (or where the console is located in your virtual system), you can click F1 (or ESC and F1 on some hosts) to get to the login prompt.

Root password

You login as the user root. There's no default root password. You set the root password in Admin → System → Console Access. If you're using a virtualization system such as Hyper-V, VMware or a physical server you can login with the username `root` and the root password set in the Root Password section.

Setting the Root password

Reset Root password

If you don't remember the root password, you need to reset it. To reset the Root Password, please go to Admin → System → Console Access. Click on the Root Password Tab and you will see the instructions there.

SSH Login — not AWS or Azure

You can also use SSH with an SSH client like Putty (if you're using Windows).

When logging in, you need to enter the hostname or ip address of the LiquidFiles system, and specify TCP port 222 as per the screenshot below (LiquidFiles v2.x and earlier used TCP port 22 for SSH). For login use root super user.

SSH Putty Example

The equivalent example on a Unix/Linux system would be:

user@system% ssh -p 222 root@172.16.5.131

SSH Login with SSH keys — AWS and Azure

With AWS and Azure, you will need to login using the SSH key you used when initiating the instance. In AWS the username will be liquidfiles or centos if the system was started a long time ago (basically try one and if that doesn't work, try the other). In Azure, you got prompted to set a username to login with SSH and your SSH Key when you started the instance.

Again using Putty, we still need to use TCP Port 222 but this time configuring the SSH Key used when you started the instance, along with the username as per the previous paragraph:

SSH Putty login with ssh keys Example

Select the SSH Private Key file to use by selecting Connection → SSH → Auth → Credentials → Private key file for authentication as in the screenshot below:

SSH Putty SSH Key Authentication

The equivalent example on a Unix/Linux system would be:

user@system% ssh -p 222 -i /path/to/private_ssh_key \
    liquidfiles@liquidfiles.mycompany.com

Becoming Root (superuser)

After you've logged in, you can become root (superuser) by running:

[liquidfiles@liquidfiles ~]$ sudo bash

SSH Access Control

If you wish to limit SSH Logins to certain hosts and networks, please go to Admin → System → Console Access. You'll see the following screen:

SSH Access Control Configuration

As per the screenshot, you can limit logins to this LiquidFiles system from certain hosts, ip addresses or networks. This is very useful if you have a general open network and all admin PC's on a specific network.