Instructions – xLGW

Instructions – xLGW

1  INTRODUCTION

This document provides steps to install and user Exium XLGW Client for connecting Exium SASE service. Steps mentioned in this document are applicable for Debian based distributions.

2  PREREQUISITES

Supported OS Platforms:

  • Ubuntu 16.04 (Xenial)
  • Ubuntu 18.04 (Bionic)
  • Ubuntu 20.04 (Focal Fossa)
  • Debian 10 (Buster)

If the VM is installed using WSL, Please ensure that systemctl is installed.

For more info you can refer to https://github.com/DamionGans/ubuntu-wsl2-systemd-script

 

 

3 INSTALLATION

3.1 CREATE DEVICE ACCOUNT

Login to your workspace

Click on Device Management link present on left panel

Click on Devices link to add XLGW device details as shown below:

3.2  DOWNLOAD THE EXIUM XLGW PACKAGE

Open https://www.exium.net/downloads in your browser and download LGW software and instructions.

 

3.3 UNTAR THE PACKAGE

 

 

$

 

 

sudo tar xvzf xlgw-installer.tgz
xlgw-installer/

xlgw-installer/uninstall.sh

xlgw-installer/start-xlg-monitoring.sh

xlgw-installer/xlgw

xlgw-installer/install.sh

xlgw-installer/xlgateway

xlgw-installer/monitor-xlg.sh

 

 

3.4 CHANGE DIRECTORY

 

 

$

$

 

cd xlgw-installer/

ls -ltr
total 28

-rwxrwxr-x 1 ubuntu ubuntu    13912 Nov 23 17:58 xlgw

-rwxr-xr-x 1 ubuntu ubuntu     1585 Nov 23 17:58 xlgateway

-rwxrwxr-x 1 ubuntu ubuntu      175 Nov 23 17:58 uninstall.sh

-rwxrwxr-x 1 ubuntu ubuntu      158 Nov 23 17:58 start-xlg-monitoring.sh

-rwxrwxr-x 1 ubuntu ubuntu      487 Nov 23 17:58 monitor-xlg.sh

-rwxrwxr-x 1 ubuntu ubuntu      821 Nov 23 17:58 install.sh

 

 

 

3.5 INSTALL PACKAGE

Use LAN interface name, ex “eth0”, as argument to the install script

 

 

$

 

 

 

 

 

 

 

 

sudo ./install eth0

–2020-11-23 10:43:32–  https://exiumclientreleases.s3-us-west-1.amazonaws.com/linux/amd64/deb/Exium_20201118_amd64_v0.2.1-rc2.zip
Resolving exiumclientreleases.s3-us-west-1.amazonaws.com (exiumclientreleases.s3-us-west-1.amazonaws.com)… 52.219.116.201
Connecting to exiumclientreleases.s3-us-west-1.amazonaws.com (exiumclientreleases.s3-us-west-1.amazonaws.com)|52.219.116.201|:443… connected.
HTTP request sent, awaiting response… 200 OK
Length: 24389155 (23M) [application/zip]
Saving to: ‘Exium_20201118_amd64_v0.2.1-rc2.zip’Exium_20201118_amd64_v0.2.1-rc2.zip 100%[===================================================================>]  23.26M  4.79MB/s    in 5.3s2020-11-23 10:43:39 (4.36 MB/s) – ‘Exium_20201118_amd64_v0.2.1-rc2.zip’ saved [24389155/24389155]Reading package lists… Done
Building dependency tree
Reading state information… Done
The following packages were automatically installed and are no longer required:
linux-aws-5.3-headers-5.3.0-1030 linux-aws-5.3-headers-5.3.0-1032 linux-aws-5.3-headers-5.3.0-1033 linux-aws-5.3-headers-5.3.0-1034
linux-aws-5.3-headers-5.3.0-1035 linux-headers-5.3.0-1035-aws linux-image-5.3.0-1035-aws linux-modules-5.3.0-1035-aws
Use ‘sudo apt autoremove’ to remove them.
Suggested packages:
zip
The following NEW packages will be installed:
unzip
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 167 kB of archives.
After this operation, 558 kB of additional disk space will be used.
Get:1 http://ap-south-1.ec2.archive.ubuntu.com/ubuntu bionic/main amd64 unzip amd64 6.0-21ubuntu1 [167 kB]
Fetched 167 kB in 1s (185 kB/s)
Selecting previously unselected package unzip.
(Reading database … 212387 files and directories currently installed.)
Preparing to unpack …/unzip_6.0-21ubuntu1_amd64.deb …
Unpacking unzip (6.0-21ubuntu1) …
Setting up unzip (6.0-21ubuntu1) …
Processing triggers for mime-support (3.60ubuntu1) …
Processing triggers for man-db (2.8.3-2ubuntu0.1) …
Archive:  Exium_20201118_amd64_v0.2.1-rc2.zip
creating: Exium_20201118_amd64_v0.2.1-rc2/
inflating: Exium_20201118_amd64_v0.2.1-rc2/exium-client_amd64_v0.2.1-rc2.deb
dpkg: warning: ignoring request to remove exium-client which isn’t installed
Selecting previously unselected package exium-client.
(Reading database … 212405 files and directories currently installed.)
Preparing to unpack …/exium-client_amd64_v0.2.1-rc2.deb …
Unpacking exium-client (0.2.1-rc2) …
Setting up exium-client (0.2.1-rc2) …
Enter Workspace[Press Enter for trial]: saurabh_pandey
Enter Username[@saurabh_pandey.exium.net]  (Please enter only prefix): saurabh.pandey.it
Created symlink /etc/systemd/system/multi-user.target.wants/exium-client.service → /etc/systemd/system/exium-client.service.
Starting exium-client service
● exium-client.service – Exium SASE Client service
Loaded: loaded (/etc/systemd/system/exium-client.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2020-11-23 10:44:08 UTC; 10s ago
Main PID: 10813 (exium-client)
Tasks: 25 (limit: 1140)
CGroup: /system.slice/exium-client.service
├─10813 /usr/local/bin/exium-client
├─10918 /usr/local/libexec/ipsec/starter –daemon charon
└─10919 /usr/local/libexec/ipsec/charon –use-syslogNov 23 10:44:08 ip-172-31-200-222 exium-client[10813]: time=”2020-11-23T10:44:08Z” level=info msg=InitUeApp
Nov 23 10:44:08 ip-172-31-200-222 exium-client[10813]: time=”2020-11-23T10:44:08Z” level=error msg=”logfile = “
Nov 23 10:44:08 ip-172-31-200-222 exium-client[10813]: time=”2020-11-23T10:44:08Z” level=error msg=”loglevel = 3″
Nov 23 10:44:08 ip-172-31-200-222 exium-client[10813]: time=”2020-11-23T10:44:08Z” level=error msg=”new loglevel = error”
Nov 23 10:44:10 ip-172-31-200-222 ipsec_starter[10832]: Starting strongSwan 5.7.2dr2 IPsec [starter]…
Nov 23 10:44:10 ip-172-31-200-222 ipsec_starter[10859]: charon (10861) started after 20 ms
Nov 23 10:44:10 ip-172-31-200-222 ipsec_starter[10859]: charon stopped after 200 ms
Nov 23 10:44:10 ip-172-31-200-222 ipsec_starter[10859]: ipsec starter stopped
Nov 23 10:44:13 ip-172-31-200-222 ipsec_starter[10862]: Starting strongSwan 5.7.2dr2 IPsec [starter]…
Nov 23 10:44:13 ip-172-31-200-222 ipsec_starter[10918]: charon (10919) started after 20 ms

 

 

 

3.6 UNINSTALL

 

$

 

 

sudo ./uninstall

  

 

4  SERVICE USAGE

 

4.1  VERIFY SUBSCRIPTION

 

 

$

 

 

sudo exium-cli verify
Verifying User———–> Verified
Config Update in progress———–> ConfigUpdated

 

 

4.2 START APPLICATION

 

 

$

 

 

sudo xlgateway start

  

 

4.3 STATUS OF APPLICATION

 

 

$

 

 

sudo xlgateway status

  

 

4.4 RESTART APPLICATION

 

 

$

 

 

sudo xlgateway restart

  

4.5 STOP APPLICATION

 

 

$

 

 

sudo xlgateway stop