Page Comparison

Connecting

If this is your first time connecting In order to connect to a Linux edge Edge device, you will need some basic software to continuespecific software must be installed.

Terminal Software

Most steps in the installation will be run via the command terminal ; this and can be accessed on a remote terminal using free software like Putty (https://www.putty.org/). In the default configuration, Linux can be 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 system.

Installing

Preparing for the

...

Package

Run the following command to confirm your systems package list up to date is current 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 run the following 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 is complete, visit the IP of your box computer on port 8080 to see the AUTOSOL App Manager web configuration page where you can configure all AUTOSOL software applications like Edge ACM.

...

.

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

Postgres

The latest installation requires that you install and setup postgres. This next steps are typically only needed on first time setup

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;

Change the password.

ALTER USER postgres WITH PASSWORD 'postgres';

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

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

Upgrade

Currently you will need to uninstall and reinstall our .deb software packages in order to upgrade.

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.

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

Our latest The software package contains a handy an uninstall script that allows you to quickly remove removes 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 hereContact 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 as long as you give the full path to it.

ZumIQ Uninstall

On the ZumIQ, run the following command:using the fully qualified path.

--ZumIQ Uninstall
sudo /home/devuser/apps/ASIEdgeManager/uninstall
--Generic

...

On any generic install, run the following command:

 Uninstall
sudo /usr/apps/ASIEdgeManager/uninstall

Uninstalling

...

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.

...

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 the board. Once you are connected. 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.

...

The ZumIQ has some small differences from the generic install

--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

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