Zumasys Documentation
Home » AccuTerm » Web » Installing AccuTerm IO Server

# Installing AccuTerm IO Server

Updated: 3/29/2020, 9:05:56 PM
Created: 3/29/2020, 9:05:56 PM
Last Updated By: Mike Street
Read Time: 4 minute(s)

Created At: 8/8/2019 1:20:16 AM
Updated At: 9/17/2019 12:04:25 AM
Original Doc: accuterm-8-installing-accuterm-web-server-package
Original ID: 441431
Internal: No

# Info

You will need to make sure you have the appropriate root permissions to install AccuTerm IO on the server.

# Installing AccuTerm IO Server

  1. Download the AccuTerm IO Server installation package from the Zumasys Downloads page. You can download the installer directly in Linux with the following commands.  Just cut and paste into your Linux console.
wget https://zdownload.blob.core.windows.net/accuterm/-AccuTerm-IO-Server/Linux/x86/0.1.5.0/install-accutermio.bin
or
curl -O https://zdownload.blob.core.windows.net/accuterm/-AccuTerm-IO-Server/Linux/x86/0.1.5.0/install-accutermio.bin
1
2
3
  1. Allow the install-accutermio file to be executable.
chmod +x install-accutermio.bin
1
  1. Run the installer.
./install-accutermio.bin
1
  1. Press enter to start the installation process.

accuterm-8-installing-accuterm-web-server-package: 1566495022856-1566495022856

  1. Specify the installation directory or press enter to accept the default path (/opt/accutermio).

accuterm-8-installing-accuterm-web-server-package: 1566495108848-1566495108848

  1. Specify the port you wish for AccuTerm IO to use or press enter to accept the default port (4380).

accuterm-8-installing-accuterm-web-server-package: 1566495179748-1566495179748

  1. Setup the systemctl service for AccuTerm Web.

accuterm-8-installing-accuterm-web-server-package: 1566495270203-1566495270203

  1. Update your firewall to allow access to your defined port (default 4380).

accuterm-8-installing-accuterm-web-server-package: 1567036893665-1567036893665

  1. The installer will by default create you a self-signed cert.  You must supply a DNS name for your server.  If you do not use a DNS  you can use an IP address instead.  Please read the section on Security to fully understand certs and how to later create fully signed certs.

accuterm-8-installing-accuterm-web-server-package: 1567037084209-1567037084209

  1. The installer will now run and generate your self signed cert and start up the AccuTerm IO service

accuterm-8-installing-accuterm-web-server-package: 1567037162625-1567037162625

  1. AccuTerm IO Server is now installed.  Let's now test to make sure your workstation can talk to the server.  Open up Chrome or Firefox and open up the test status page.

accuterm-8-installing-accuterm-web-server-package: 1567117613397-1567117613397

This error is because we are using a self-signed cert.  Accept this site click the Advanced Button and choose the Proceed link. The page should respond with a simple 1.  Please read below about Server Security to understand certs and how to install a fully signed cert and remove this error.  While using the self-signed cert each workstation that wishes to connect will need to go directly to the above page and choose to proceed.

Now the server is installed and running and you have accepted the self signed cert you need to build your users and profiles.  Accuterm is actually launched from accuterm.io and your profiles are built at portal.zumasys.com

Getting Started

# Manage AccuTerm IO Server

AccuTerm IO is installed as a Linux systemctl service.

systemctl status accutermio
systemctl stop accutermio
systemctl start accutermio
1
2
3

# Run AccuTerm IO Server in debug mode

As root do

systemctl stop accutermio
cd /opt/accutermio
export DEBUG=express:*
./accutermio-linux
1
2
3
4

# Configure AccuTerm IO Server as Jump Box

By default, AccuTerm IO will call the default Linux /bin/login program.  If you are wanting to connect to an AIX or Windows server from a Linux machine with AccuTerm IO server installed you can modify the /opt/accutermio/config.json.

{
        "port" : 4380,
        "ssl_cert" : "./keys/server_cert.pem",
        "ssl_key" : "./keys/server_key.pem",
        "static_dir" : "./assets",
        "heartbeat" : 60,
        "close_on_heart_failure" : true,
        "trust_proxy" : false,
        "command" : "/usr/bin/telnet",
        "command_args" : ["<ip of your telnet server", "23 - Or custom port for telnet"],
        "defaults" :
        {
                "term" : "vt100",
                "cols" : 80,
                "rows" : 24
        }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

Now restart the AccutermIO service and it should now respond with the telnet prompt of your Pick Box.  This technique can also be used to replace /bin/login also with any other alternative login technique.  For example, you could use the following script to use SSH access instead.

# Notes on AccuTerm IO Server and Security

AccutermIO is a true web application and as such it relies on normal web certificates (https) for security.  Certs can be either purchased from sites such as DigiCertor free ones an be obtained by ACME based services such as Let's Encrypt.

In order to install a real cert you will need

  1. A true DNS entry for your server that can be resolved on the internet.
  2. Access to that DNS to add a special TXT record for authentication.
  3. Root access to the server where AccutermIO is installed to run the cert program.

If you do not have #1 or #2 you can use a free DNS service to give you a DNS name for your server.

Free DNS service:  https://www.duckdns.org

ACME client to install CERT: https://github.com/Neilpang/acme.sh

ACME example with DuckDNS: https://github.com/Neilpang/acme.sh/wiki/dnsapi#27-use-duckdnsorg-api