After installing Unomaly, there are a few first-time configurations you need to do before you can start using the instance: set the instance role, configure network settings, enable email communications, and add a license.

Log in to the console menu

Each Unomaly instance has its own console menu, which is a command line interface used for administrative tasks and troubleshooting.

  1. Use SSH to connect to the Unomaly instance and run the following command to start the console menu:

    sudo /opt/unomaly/bin/console_setup
  2. Log in to the console menu. The default username and password are unomaly/unomaly.

  3. (Recommended) Change the password and restrict access to the console menu.

For more information, see “The Unomaly console menu”.

Configure network settings

Unomaly needs to have the correct communication and network ports available to receive data from systems, to communicate with other Unomaly instances in a distributed setup, and to send email notification to users.

  1. On the console menu, choose option 1 to Set network configuration.

  2. Enter the IP address of the instance, Netmask, and Gateway.

  3. Enable communication ports for the following (as needed):

    Type Protocol/Port
    HTTPS TCP/443
    SSH TCP/22
    Syslog TCP/514, UDP 5514
    SNMP UDP/162
    DNS UDP/53
    NTP UDP/123

    For an overview of the communications and network ports that Unomaly uses, see “Communication settings”.

  4. After you configure these network settings, log back into the instance using SSH to continue setting up the instance.

Select the instance role

  1. On the console menu, choose option 2 to Select instance role.

  2. Choose the Unomaly role to assign: Standalone, Manager, or Worker.

Instance role Description
Standalone (Default) A single Unomaly instance that receives and analyzes the data.
Manager In a distributed deployment of Unomaly, the instance that has all the metadata, learning, license, and web interface. Each manager can have up to 25 worker instances connected to it.
Worker In a distributed deployment of Unomaly, the instance that receives data and sends the analysis to the manager. When you configure a worker, you will be prompted to connect it to the manager instance, which means entering the IP address of the manager.

For more information about the instance roles, see “Unomaly deployment architectures”.

Apply the license to the instance

Each Unomaly instance that analyzes the data needs to have a Unomaly license. For distributed deployments, you only need to add the license to the Manager instance. Unomaly licenses are keyed to the IP address of the instance that they will be installed on.

  1. On the console menu, choose option 8 to Update license.

  2. When prompted to enter a license answer “yes” and paste in the license.

Your license will be immediately validated, and the Unomaly processes will start.

Don’t have a license? Contact Unomaly Support or talk to your Unomaly representative.

Log in to the web interface

  1. Using a supported browser, navigate to the Unomaly web interface.

  2. Log in to the web interface using the default username and password: admin/unomaly.

  3. (Recommended) Change the login password for this admin account. See “Add and edit accounts”.

Configure email notification

  1. (Recommended) Configure SMTP and email settings under Settings > Email so that you receive status notifications from this Unomaly instance. See “Configure email settings”.

Next steps

Start stending data to your Unomaly instance! See “Data inputs overview”.