Connecting
In order to connect to a Linux Edge device, you will need to have SSH access to the host.
See https://learn.microsoft.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
Before you begin: the initial installation of Edge ACM will require the installer to download multiple dependencies. Internet access is required for the initial installation.
Preparing for the Package
Run the following command to confirm your systems package list is current to ensure we can download all needed components:
sudo apt-get update
Transferring the Package
You will need to transfer AUTOSOL’s .deb package over to your 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 command to begin the installation:
sudo apt install /path/to/autosol_3.5.5.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 device on port 8080 to see the AUTOSOL Edge Manager web configuration page.
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
Note: if you don’t want to use the password ‘postgres’ you will need to modify config.ini in /usr/apps/ASIEdgeManager/core
Possible Errors During Install
If the installer doesn’t have enough space despite room on the local drive, you may need to increase your tmp storage. Run the following:
sudo mount -o remount,size=200000000 /tmp
If this was a first time install, Postgres might return errors such as:
"Could not migrate to db."
"Verify Postgres is running.”
“Postgres must have a password."
If so, view the Troubleshooting Postgres Errors before finishing installation.
If it fails for any other reason, visit the Troubleshooting section for more information.
Uninstalling
Always backup configuration data by generating an export before uninstalling/upgrading.
This includes the license file(s) which must be reapplied after the upgrade is complete.
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.
sudo /usr/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 -U postgres 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] ...