Installing Asset Gateway for 64-bit Linux

This page describes how to download and install the deviceWISE Asset Gateway for 64-bit Linux product on a 64-bit Linux computer.

Follow these steps to download the Asset Gateway for Linux install file:

Log on to the Management Portal
Navigate to Developers >> Resources
Click on the appropriate build folder(if you are not sure, pick the latest available build. For example: 24.01).
Navigate to OS_Linux>>Linux-X64-Generic>>Asset_Gateway
Click on DWGateway_Install.Linux-X64-Generic.XXX.tar.gz (where XXX is the version of the Asset Gateway software you want to download) and download the file to a temporary location on your computer.
Telnet or log on to the target Linux computer as root.
Copy the downloaded DWGateway_Install.Linux-X64-Generic.XXX.tar.gz file from the temporary download computer and location into the Linux computer's /tmp directory.
At the command line enter:
/tmp>gunzip DWGateway_Install.Linux-X64-Generic.XXX.tar.gz and press Enter.
This creates a file with a .tar extension (DWGateway_Install.Linux-X64-Generic.XXX.tar).
Unpack the created .tar file:
/tmp>tar -xvf DWGateway_Install.Linux-X64-Generic.XXX.tar and press Enter
This creates a directory called dwgateway under the current directory.
At the command line, change to the dwgateway directory:
/tmp>cd dwgateway and press Enter
Run the Linux install program from the dwgateway directory:
/tmp/dwgateway>./devicewise.install(and press Enter).
A message and prompt appears asking if you want to continue installing the software.
Type Yes and press Enter.
A license agreement is displayed.
Page down through the license agreement until the end.
You are asked if you agree with the terms of the license agreement.
Type Yes and press Enter.
When the installation is complete, the following directory structure is created:
/opt/dw/
The Asset Gateway software should be running.

Starting, Stopping, or Restarting the deviceWISE Asset Gateway Software

The deviceWISE Asset Gateway for Linux software runs as service or daemon, and will normally be started when the operating system is started.

However, provided with the software is a service control script which can be used in situations where the software service requires manual intervention.

Depending on your particular Linux distribution and version, one of the following techniques can be used. Traditionally, most Linux distributions have used what is known commonly as the "System V" style init system. For these distributions, you will probably use the service(8) utility. More recently, Linux distributions have begun to use the systemd software suite to perform the init procedure. On such systems, use the systemctl(1) utility.

Please note that in each circumstance you must call the utility described below as the user 'root'.

Example: Using the service(8) Utility

Within Linux distributions based on the traditional System V init, the service(8) utility can be used to call the deviceWISE init script:

# service devicewise [status|start|stop|restart]

Example: Using the systemctl(1) Utility

For Linux distributions using systemd, the systemctl(1) utility can be used to invoke the deviceWISE init script:

# systemctl [status|start|stop|restart] devicewise

Calling the Script Directly

If your Linux distribution does not provide either of the aforementioned utilities, it may still be possible to control the deviceWISE service by calling the deviceWISE init script directly. The following example assumes that the installation path of deviceWISE was /opt/dw:

Invoking the deviceWISE init Script Directly

# /opt/dw/devicewise [status|start|stop|restart]

Uninstalling the deviceWISE Asset Gateway Software

You need to do a node Back Up before uninstalling the product to capture the current application definition and system configuration information.

First, stop the deviceWISE service using one of the previously documented methods (see section titled: Starting, Stopping, or Restarting the deviceWISE Asset Gateway Software).

Remove the deviceWISE directory

# rm -rf /opt/dw

For System V init based distributions, remove any remaining deviceWISE components from the /etc:

Removing the deviceWISE init Script

# find /etc -name "*devicewise*" | xargs rm -f

For systemd based distributions, remove the deviceWISE service from the systemd manager:

Removing the deviceWISE systemd service

# systemctl disable devicewise.service
# systemctl daemon-reload
# find /usr/lib/systemd -name "devicewise.service" | xargs rm -f

Linux Firewall Configuration

In order to access the deviceWISE Asset Gateway services using the deviceWISE Workbench, you may be required to implement the following change to your system's firewall policy, including intermediate network devices which may reside in the network path of the server and the system from which you will be accessing the server using the deviceWISE Workbench.

Allow traffic to flow bidirectionally through the associated interfaces and network path between your server and the system from which you will be accessing the deviceWISE Asset Gateway services:

Protocol:Port	Description
TCP:4012	Primary communication between the Workbench and the node.
UDP:4009	Workbench to node Scan and status information.

Linux firewall configuration varies among distributions and versions of Linux, so please refer to your system's documentation and confer with your organization's network administration team when applying these policy changes.