Skip to content

AxonOps GUI installation

AxonOps GUI service is installed as a separate service to AxonOps Server. The GUI service (axon-dash) can be co-hosted on the same server as the AxonOps Server process, or they can be running on 2 separate servers.

This section describes the installation process for the GUI service.

Step 1 - Installation

CentOS / RedHat installer

curl -1sLf 'https://repo.axonops.com/public/yum/cfg/setup/bash.rpm.sh' | sudo bash
sudo yum install axon-dash

Debian / Ubuntu installer

curl -1sLf 'https://repo.axonops.com/public/apt/cfg/setup/bash.deb.sh' | sudo bash
sudo apt-get install axon-dash

Step 2 - Configuration

Change axon-dash configuration to specify axon-server listening address.

  • /etc/axonops/axon-dash.yml
axon-dash: #  The listening address of axon-dash
  host: 0.0.0.0
  port: 3000

axon-server:
  public_endpoints: "http://axon-server.public:8080, https://axon-server.public" # Public HTTP endpoint to axon-server API. This can be a list with comma separator. http://127.0.0.1 or http://locahost are always wrong.
  context_path: "" # example: "/gui"

axon-server default listening port is 8080

Step 3 - axon-server configuration update

Update axon-server configuration by setting the correct axon-dash host and port:

  • /etc/axonops/axon-server.yml
host: 0.0.0.0  # axon-server endpoint used by the API and the agents
api_port: 8080 # API port (axon-server <> axon-dash)
agents_port: 1888 # axon-server <> axon-agents
elastic_hosts: 
  - http://localhost:9200 
#  - http://localhost:9201
#elastic_skipVerify: true

# axon-dash configuration
axon-dash:
  host: 127.0.0.1
  port: 3000
  https: false

...

Step 4 - Restart axon-server after updating it's configuration

sudo systemctl restart axon-server

Step 5 - Start axon-dash

sudo systemctl daemon-reload
sudo systemctl start axon-dash
sudo systemctl status axon-dash

This will start the axon-dash process as the axonops user, which was created during the package installation. The default listening address is 0.0.0.0:3000.

Package details

  • Configuration: /etc/axonops/axon-dash.yml
  • Binary: /usr/share/axonops/axon-dash
  • Logs: /var/log/axonops/axon-dash.log
  • Systemd service: /usr/lib/systemd/system/axon-dash.service
  • Copyright : /usr/share/doc/axonops/axon-dash/copyright
  • Licenses : /usr/share/axonops/licenses/axon-dash/

Step 6 - Installing agents

Now axon-dash is installed, you can start installing cassandra-agent