Page Comparison

...

In order to connect to a Linux Edge device, specific software must be installed.

Terminal Software

Most steps in the installation will be run via the command terminal and can be accessed on a remote terminal using free software like Putty (you will need to have SSH access to the host.

See https://wwwlearn.putty.org/). In the default configuration, Linux is accessed via an SSH connection to port 22. The default username and password vary by manufacturer.

File Transfer Software

While SCP (Secure Copy) can be used from the command line, many people prefer to use a simple GUI to transfer files in a manner more similar to using Windows Explorer. WinSCP (https://winscp.net/eng/download.php) is a piece of free software that allows an SCP connection via that same port 22, allowing you to copy our installer to your Linux systemmicrosoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse?tabs=gui for more info on installing Windows SSH/SCP tools. Tools like Putty or WinSCP are also very useful.

Installing

...

Transferring the Package

You will need to move transfer AUTOSOL’s .deb package over to your board. There’s many ways of doing it, but a very popular one is using an SFTP client program like WinSCP to transfer the file from your computer. You can also install SCP programs for Windows, Linux, or other operating systems. device. Use the SCP tools described above to accomplish this

If you are using SCP, replace username and 10.10.10.10 with the appropriate user and IP address for your device.

scp autosol_3.5.5.0-generic_all.deb username@10.10.10.10:

Installing the Package

Once you have transferred the package, run the following Linux command to begin the installation:

sudo apt install /path/to/autosol_3.05.45.0-generic_all.deb

You will need to give the full or relative path to the AUTOSOL .deb package

Default Settings

On new installations you will be prompted about entering default values for this unit. Responding n to the first question will continue the installation as per usual.

Would you like to set default values for this Edge Node? (y/n) y

These values will stay in the .ini file across installs. See Defaults Explained further below for details.

Once the installation is complete, visit the IP of your computer device on port 8080 to see the AUTOSOL Edge Manager web configuration page.If this is the first time you’ve installed on this system

Postgres password

On versions older than 3.4.5.0, you will need to set your Postgres password:. The installer will show a message with the following instructions.

sudo -u postgres psql ASIServerDB
ALTER USER postgres WITH PASSWORD 'postgres';
\q
/usr/apps/ASIEdgeManager/core/restart

...

If it fails for any other reason, visit the Troubleshooting section for more information.

Upgrade

The .deb software packages must be uninstalled and reinstalled in order to upgrade. Follow the instructions for Uninstalling and Installing in order to successfully upgrade.

Uninstalling

The software package contains an uninstall script that quickly removes Edge ACM and all of AUTOSOL’s software utilities from your device.

You will need SSH access to your device in order to run the uninstall program. Contact your IT department if you need assistance with this.

Once you have access to a terminal connected to the device, you can run the uninstall.sh script from any location using the fully qualified path.

--ZumIQ Uninstall
sudo /homeusr/devuser/apps/ASIEdgeManager/core/uninstall

Removing the database

If you wish to remove the database you will need to run an additional command.

dropdb -h localhost -GenericU Uninstall
sudo /usr/apps/ASIEdgeManager/core/uninstall

Uninstalling Old Packages

Older packages named appmanager are not uninstalled by the script and need to be disabled and manually uninstalled.

You will need SSH access to your device in order to run the uninstall program. Contact your IT department if you need assistance with this.

Run the following commands as per your platform.

--ZumIQ
sudo rm /home/devuser/service/API
sudo kill `cat /var/run/appmanager.pid`
sudo apt remove appmanager -y
sudo rm -r /home/devuser/apps/API

--Generic
sudo systemctl disable appmanager
sudo systemctl stop appmanager
sudo apt remove appmanager -y
sudo rm -r /usr/apps/APIpostgres ASIServerDB

You can use a similar command to delete other databases by replacing ASIServerDB or the user postgres

Defaults Explained

The installation process generates a defaults.ini file in /etc/autosol/defaults.ini

This file contains a set of values that define the properties of the server.

When installing, the prompts allow you to enter a default broker IP:Port, username/password and if you want to set enable TLS.

TLS will use the default server.crt the unit ships with, which allows for most simple unverified TLS connections.

Would you like to set default values for this Edge Node? (y/n) y
Edge Node name [Unnamed Node]: MyNode
Configure Broker settings? [n] (y/n): y
Broker IP [localhost]: 127.0.0.1                               
Broker Port [1883]: 8883
Username []: brokerusername
Password []: brokerpassword
Enable TLS? [False] (y/n): y

This is what the defaults.ini looks like.

CONTROL

apply

If set to True, the server will use the default values upon a server restart.

SERVER

wildcardname

If set to True, a random 4 digit number will be appended to the name.

BROKER

These properties are related to broker connections. See MQTT TLS for full details.

File type properties (cafile, certfile, keyfile) expect a valid file path to a file located in the unit upon usage of the defaults.ini

[CONTROL]
apply = False

[SERVER]
name = MyNode
compress = True
https = False
wildcardname = False

[BROKER1]
enabled = True
brokerip = 127.0.0.1
brokerport = 8883
connectionretries = 4
connectionretryinterval = 30000
keepalive = 60
clientid = 
cleansession = True
protocolversion = MQTT 3.1
username = brokerusername
password = brokerpassword
enabletls = True
tlsversion = TLS v1.2
cafile = 
certfile = 
keyfile = 
keypassword = 
verifycertificate = False

[BROKER2]
...