1  INTRODUCTION

This document provides steps to install and use Exium Wireless Gateway client(xWGW) for

connecting Exium SASE service. Steps mentioned in this document are applicable for

OpenWRT based distributions.

2  PREREQUISITES

Supported OS Platforms:

• OpenWRT

Install Dependencies:

• ip-tiny
• kmod-tun

3  INSTALLATION

• Login to OpenWRT Device
• Install Dependencies if not already installed
  • ip-tiny
  • kmod-tun
• Download the Exium Client package from the link provided.
• Untar the package Exium_20201118_openwrt_v0.2.1-rc2.tar.gz
• Change directory to Exium_20201118_openwrt_v0.2.1-rc2
• Check if pkg is present using “opkg list-installed | grep exium”
• If already installed, pkg can be removed using “opkg -r exium-client”
• Install pkg using “opkg install exium-client_openwrt_v0.2.1-rc2.ipk”
• Enter Workspace if prompted
• Enter Username if prompted

NOTE: Please make sure to remove the zip file and extracted zip file contents in order to regain the memory space

3.1   SYSTEM INFORMATION

3.2   INSTALLING DEPENDENCIES

3.3   DOWNLOAD THE EXIUM CLIENT PACKAGE

3.4   INSTALL EXIUM CLIENT PACKAGE

4 SERVICE USAGE FROM CLI

• run command “which exium-cli”
  • /usr/local/bin/exium-cli
  • if not able to find exium-cli, try reloading config.
    • source ~/.profile
  • run command “exium-cli”

As part of Verify, an Email gets sent to the User, then the User needs to complete Email verification and revisit this window again

4.1  CONNECT

• Default Selected Server is “exe.exium.net”

4.2  DISCONNECT

4.3   CONNECT TO SPECIFIC SERVER

• Server List can be fetched using “exium-cli servers” command
• Can Connect to specific server using command “exium-cli connect -s ”

4.4  INTERACTIVE CLI

exium-cli interactive

• By default it will check for any updates available. Checking updates can be skipped with additional “-i” flag
  • exium-cli interactive -i
• Menu will be shown with server Id, Default Selected Server,
• exium-cli can be accessed anytime and will show the Connection status and Server Selected

4.4.1        INTERACTIVE CONNECT

• Select option 1 From Main Menu
  • State will transition from “Connection In Progress” to SessionConnected
  • Once Connected you have Secure Access now.

4.4.2        INTERACTIVE DISCONNECT

• Select option 2 From Main Menu to disconnect
  • State will transition from “Connected” to “Disconnect In Progress” to “SessionDisconnected”

4.4.3        SERVER LIST

• Select option 3 From Main Menu to see list of available servers
  • Then server can be selected from this list for which connection needs to established
  • Config gets updated with the selected server
  • Choose option 0 to go Back to Main Menu
  • Then choose option 1 to connect to the selected server

4.4.4        CHECK FOR UPDATES

• This will check for any New Version Available on server.
• If New Version is available, User will be asked to Download the Version
• If User opts for downloading the Version, after download is completed User will be asked for Installing this Version
• User can always skip to Download or Install the Version

4.4.5        LOGOUT

• From Main Menu Select option 6 to logout
• Once you logged out, next time when you open exium-cli it will again ask you to Login with Username

5 SERVICE COMMANDS

• exium-client service can be stopped using
  • “/etc/init.d/exium-client stop”

• exium-client service can be started using
  • “/etc/init.d/exium-client start”

• exium-client service can be restarted using
  • “/etc/init.d/exium-client restart”

• exium-client status can be checked using
  • “/etc/init.d/exium-client status”

6  UNINSTALL

• Check if exium-client is installed using “opkg list-installed | grep exium”
• Uninstall exium-client using “opkg remove exium-client”
• Verify uninstallation using “opkg list-installed | grep exium”