The calaos-os tool

Purpose

calaos-os is the system administration tool. It handles updates and network configuration, and usefully replaces the equivalent Debian commands, since it knows the specifics of Calaos OS.

It is used from a terminal on the server, or remotely over SSH — see SSH access.

Command reference

CommandEffect
calaos-os listLists installed images and packages, and available updates
calaos-os check-updateChecks whether updates are available
calaos-os upgradeUpdates every component
calaos-os upgrade PACKAGEUpdates a single component
calaos-os network listLists the network interfaces
calaos-os network configure dhcp INTERFACEConfigures an interface with an automatic address
calaos-os network configure static INTERFACE IPV4 NETMASK [GATEWAY] [DNS...]Configures an interface with a fixed address

Updates

A complete update cycle looks like this:

# See the current state of the system
calaos-os list

# Check what is available, without changing anything
calaos-os check-update

# Update everything
calaos-os upgrade

To update a single component, for instance to try a new version of a service without touching the rest:

calaos-os upgrade PACKAGE_NAME

A restore point is created automatically before every operation, whichever command you use. See Rolling back.

As Calaos OS is based on Debian, apt also works and acts on the same package repository. calaos-os upgrade and apt full-upgrade produce the same result.

The complete step-by-step procedure is on the Update page.

Network configuration

Always start by finding the interface name:

calaos-os network list

Then configure it, with an automatic address:

calaos-os network configure dhcp eth0

or with a fixed address:

calaos-os network configure static eth0 192.168.1.50 255.255.255.0 192.168.1.1 192.168.1.1

The arguments are, in order: the interface, the IPv4 address, the network mask, the gateway, then one or more DNS servers separated by spaces. The gateway and DNS are optional, but without them the server will have no Internet access.

If you are connected over SSH and change the interface you are connected through, your session will be dropped. Reconnect to the new address.

Detailed explanations are on the Network page.

Not to be confused

Two tools have similar names and are unrelated:

  • calaos-os — with a hyphen — administers the system: updates, network;
  • calaos_config — with an underscore — manages the Calaos server settings: credentials, notifications. See its own page.