What are the commands available for the Virtual Appliance?

What are the commands available for the Virtual Appliance?

The table below lists the available configuration and management commands for the Lumu Virtual Appliance. Some commands will require privileges, in which case you will be prompted to enter the sudo credentials.

lumu-appliance [argument]

Argument

Description

-h or --help

Print all the available commands with their description.

-v or --version

Show the appliance version.

init

Initialize the appliance components and basic configuration.

set 

Manage the appliance configuration (networks, resolver, preferences, etc). Use -h to obtain help on additional arguments.

show

Print settings and statistics (networks, resolver, preferences, usage, etc). Use -h to obtain help on the additional arguments.

reset

Reset appliance configuration (activation code, etc). Use -h to obtain help on the available options.

start

Start the appliance’s components.

stop

Stop the appliance’s components.

reload

Reload the appliance. Some services may be restarted when using this command.

status

Print appliance’s status information.

logs

Connect the terminal to the appliance logs.

enable

Enable optional features such as proxy, reverse DNS, etc. Use -h to obtain help on the available options.

disable

Disable optional features. Use -h to obtain help on the available options.

check

Perform checks regarding connection mode, if the appliance is initialized, etc. Use -h to obtain help on the available options.

update

Update the appliance’s components. If the appliance is running, it will be stopped and it should be started manually via command.

upgrade

Check if a new version of the appliance is available. If yes, you can download and install it.

downgrade

Rollback to a previously installed version of the appliance. You should specify a target version. Use -h to obtain help on additional arguments.

send-heartbeat

Send heartbeat information to Lumu. It includes information that can be used for diagnosing and troubleshooting purposes.

collectors

Create or remove custom collectors hosted by the appliance. Use -h to obtain help on the available options. 

To learn more about Lumu Virtual Appliance, consult our documentation.
    Still can’t find an answer?
    Send a message to our experts.
    Contact Us

        • Related Articles

        • How can I increase the storage of a Lumu Virtual Appliance?

          It is strongly recommended to save a Snapshot of the current state of the VA in your hypervisor before you begin. First, shut down the appliance, then increase its capacity using the hypervisor.  To shut down the Lumu Virtual Appliance execute the ...

        • Does the use of Lumu DNS or the Virtual Appliance affect the latency of our systems?

          Lumu DNS is designed for speed and reliability. We invite you to test the latency by yourself. By implementing a Virtual Appliance, you add a component that contributes to a nominal amount of latency in your internal network. The difference in ...

        • What Hostname permissions should I add to my Firewall before deploying a VA?

          What are the Hostname permissions required by my Firewall to prevent it from blocking the Lumu VA? For the proper operation of the Lumu Virtual Appliance, you must configure your network’s firewall to allow connections to the hostnames listed below ...

        • How to solve “Booting SMP configuration” on VMware?

          Some customers running VMWare in a machine with Intel Xeon CPUs hangs when having more than VCPu showing “Booting SMP configuration” in the console. This error is related to VMWare failing to apply an intel microcode update according to this forum ...

        • Circumvention and Firewall Rules

          Savvy users may try to modify their DNS settings to circumvent the environment’s default DNS settings. Most routers and firewalls will allow you to force all DNS traffic over port 53 on the router, thus requiring everyone on the network to use the ...