| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Connecting
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
| Info |
|---|
Before you begin: the initial installation of eACM 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:
| Code Block |
|---|
sudo apt-get update |
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.
| Code Block |
|---|
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:
| Code Block |
|---|
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.
| Code Block |
|---|
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.
| Code Block |
|---|
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
...
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:
| Code Block |
|---|
sudo mount -o remount,size=200000000 /tmp |
If this was a On first time install, Postgres might return 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 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
| Note |
|---|
All configuration data is deleted when 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.
...
| language | bash |
|---|
...
the webserver doesn’t start or allow access, run the restart script to check for errors:
| Code Block |
|---|
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.
| Code Block |
|---|
--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/APIrestart |
If python errors appear, there may be an issue with our dependencies vs. the system packages. You can complete the install by running:
| Code Block |
|---|
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.