Page Comparison

...

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

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/API/uninstall

Generic Uninstall

On any generic install, run the following command:

sudo /usr/apps/API/uninstall

Installing

In order to install, you have to make sure your board has an internet connection as most of AUTOSOL’s software dependencies are downloaded from Debian servers.

Transferring the package

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

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 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, you can run a simple linux 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 has completed, you should be able to is complete, visit the IP of your box device on port 8080 to see the AUTOSOL App Edge Manager web configuration page where you can configure all AUTOSOL software applications like Edge ACM.

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

...

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;

Change the password.

ALTER USER postgres WITH PASSWORD 'postgres';

Exit the edit database mode:

\q

Restart the server

On a Freewave

sudo /home/devuser
\q
/usr/apps/ASIEdgeManager/core/restart

or on Generic installs.

...

...

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

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

...

Troubleshooting

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

On first install, Postgres returns 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 the webserver doesn’t start or allow access, run the restart script to check for errors:

sudo /usr/apps/ASIEdgeManager/core/restart

If python errors appear, there may be an issue with our dependencies vs. the system packages. You can complete the install by running:

sudo python3 -m pip install -r /usr/apps/ASIEdgeManager/core/requirements.txt --break-system-packages

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