Skip to content

Linux

This section describes steps required to install Canvus server on Linux.

Note

On Linux, Canvus Connect server requires 64-bit Ubuntu 18.04 LTS operating system.

Install Canvus server

The preferred way to install Canvus server is to run the following command:

curl http://update.multitouch.fi/install-canvus-server-bionic.sh | sudo bash

Alternatively, you can also install-linux-server-package.

The installation creates two users: mt-canvus-server and mt-canvus-dashboard. The server will run as mt-canvus-server service using the mt-canvus-server user. The web interface for the server will run as mt-canvus-dashboard service using the mt-canvus-dashboard user.

Database setup

Run the following command to install PostgreSQL on the designated host computer:

sudo apt-get install postgresql

Next, setup the Canvus Connect database and database user:

sudo /opt/mt-canvus-server/bin/mt-canvus-server --configure-db

This command will add a new database and a database user with a random password and store those settings in the server configuration file /etc/MultiTaction/canvus/mt-canvus-server.ini. The configuration file is created if it doesn\'t already exist.

This command is safe to run multiple times. Any existing values in the configuration file are used as is.

Alternatively, you can also Configure the database manually.

(Optional) Configure Canvus server

Canvus Connect server will start and work using its default settings. However, if you want to change the default settings you need to edit the server configuration file mt-canvus-server.ini.

When editing the configuration file, any lines starting with ; character are treated as comments. Make sure to remove the preceding ; on the lines you edit.

Tip

server-config-file-linux

You can also change much of the configuration using the web UI.

(Optional) Define connection types

By default, Canvus server will listen on port 443 for encrypted SSL and HTTPS connections. It will also redirect HTTP from port 80 to port 443. Canvus will automatically generate self-signed SSL certificates on startup.

If want to change these default settings, see server-configuration-connections.

If the default settings are fine, continue to start-server-linux.

Start or stop Canvus server

This section describes how to start, restart and stop the Canvus server.

The server runs as the mt-canvus-server service. To start or stop the service:

  1. Open a terminal emulator
  2. Run the following commands, as required:
    • Start the server: sudo systemctl start mt-canvus-server
    • Stop the server: sudo systemctl stop mt-canvus-server
    • Check the status of the server: sudo systemctl status mt-canvus-server

After the Canvus server service has started, log entries record server activity. For details about where to find the log files, see server-log-file.

Start or stop Canvus web UI

This section describes how to start, restart and stop the Canvus server web UI.

The server runs as the mt-canvus-dashboard service. To start or stop the service:

  1. Open a terminal emulator
  2. Run the following commands, as required:
    • Start the server: sudo systemctl start mt-canvus-dashboard
    • Stop the server: sudo systemctl stop mt-canvus-dashboard
    • Check the status of the server: sudo systemctl status mt-canvus-dashboard

After the Canvus server web UI service has started, log entries record server activity. For details about where to find the log files, see server-log-file.

Create administrator user

In order to manage your Canvus server, you need to create at least one administrator user account on the Canvus server.

  1. Open a terminal emulator

  2. Run the following command:

    sudo /opt/mt-canvus-server/bin/mt-canvus-server --create-admin <email>

For example, sudo /opt/mt-canvus-server/bin/mt-canvus-server --create-admin admin@example.com. A password will be automatically generated for the user and displayed in the terminal.

Tip

Use /opt/mt-canvus-server/bin/mt-canvus-server --help for a list of all accepted command-line arguments.

Activate your license

You can now proceed to sign in to the Canvus server web UI and activate your Canvus server license. See server-licensing for details.