Connecting
If this is your first time connecting to a Linux edge device, you will need some basic software to continue.
Terminal Software
Most steps in the installation will be run via the command terminal; this can be accessed on a remote terminal using free software like Putty (https://www.putty.org/). In the default configuration, Linux can be 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 system.
Installing
Before you begin: the initial installation of eACM will require the installer to download multiple dependencies. Internet access is required for the initial installation.
Preparing for the package
Get your systems package list up to date to ensure we can download all needed components:
sudo apt-get update
Transferring the package
You will need to move 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.
Installing the package
Once you have transferred the package, you can run a simple linux command to begin the installation
sudo apt install /path/to/autosol_1.0.0-zumiq_armhf.deb
You will need to give the full or relative path to the AUTOSOL .deb package
Once the installation has completed, you should be able to visit the IP of your box on port 8080 to see the AUTOSOL App Manager web configuration page where you can configure all AUTOSOL software applications like Edge ACM.
If this was a first time install, it is possible that you got some output regarding postgres. You should see something like this:
"Could not migrate to db." "Verify postgres is running. Postgres must have a password."
If so, you will need to follow the instructions below to finish installation.
If the installer doesn’t have enough space despite room on the local drive, you may need to increase your tmp storage. Run the followoing:
sudo mount -o remount,size=200000000 /tmp
If it failed in any other way, visit the Troubleshooting section for further info
Postgres
The latest installation requires that you install and setup postgres. This next steps are typically only needed on first time setup
Postgres is installed automatically by installing the autosol package so you dont need to install it, yet you need to first time configuration below.
Changing the postgres password
Select the database to work with. This will open the database so you can make changes.
sudo -u postgres psql ASIServerDB;
If that failed, it might be possible that the database was not created by our install process. Scroll further down to Making the database
Change the password.
ALTER USER postgres WITH PASSWORD 'postgres';
By default the software is configured to use password “postgres”. If you want something else, you’ll need to set the password in the conf.ini file under the install folder.
On a Freewave
/home/devuser/apps/ASIEdgeManager/conf.ini
or on Generic installs.
/usr/apps/ASIEdgeManager/conf.ini
Exit the edit database mode:
\q
Restart the server
On a Freewave
sudo /home/devuser/apps/ASIEdgeManager/restart
or on Generic installs.
sudo /usr/apps/ASIEdgeManager/restart
Once the restart has completed, you should be able to visit the IP of your box on port 8080 to see the AUTOSOL App Manager web configuration page where you can configure all AUTOSOL software applications like Edge ACM.
Making the database
The database we use (ASIServerDB) is typically automatically created by our scripts that run during the installation. If this somehow wasn’t the case, you can attempt to create it manually.
sudo -u postgres createdb ASIServerDB
If this fails, it is possible that postgres was not installed correctly. Scroll down to Installing postgres.
Once you make the database, you can attempt a reinstall, by following the Uninstalling and Installing instructions again, or you can try a restart of the service by following the restart instructions further above.
Installing postgres
Postgres is required as a dependency by our package. If it wasnt installed or you want to install it manually, you can run a couple of commands to give it a try
sudo apt-get update sudo apt-get install postgresql
If this fails, it is possible that you don’t have a good internet connection. It is also possible that you have bad DNS settings so the system cannot identify a good way to hit the debian package repositories online. In either case, contact your IT to get further assistance.
Once you get postgres installed, you can attempt a reinstall, by following the Uninstalling and Installing instructions again.
Upgrade
Currently you will need to uninstall and reinstall our .deb software packages in order to upgrade.
Follow the instructions for Uninstalling and Installing in order to successfully upgrade.
Uninstalling
Always backup your configuration data by generating an export before you upgrade. All data is lost and you will need to reconfigure after upgrading.
Our latest software package contains a handy uninstall script that allows you to quickly remove Edge ACM and all of AUTOSOL’s software utilities from your device.
You will need to gain SSH access to your device in order to run the uninstall program. SSH access is out of the scope of this guide, so we will not go into much detail here.
Once you have access to a terminal connected to the device, you can run the uninstall.sh script from any location as long as you give the full path to it.
ZumIQ Uninstall
On the ZumIQ, run the following command:
sudo /home/devuser/apps/ASIEdgeManager/uninstall
Generic Uninstall
On any generic install, run the following command:
sudo /usr/apps/ASIEdgeManager/uninstall
Uninstalling old packages
It is possible that you have an older package installed. Newer packages are named autosol, this includes the underlying service running on Linux as well as the filename.
Older packages were named appmanager. These packages do not have an uninstall program available and you will need to uninstall and disable it manually.
You will need SSH access to the board. Once you are connected. Run the following commands as per your platform.
ZumIQ
The ZumIQ has some small differences from the generic install
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/API