1. Home
  2. Networking
  3. Wi-Fi Management
  4. Installation
  5. GWN Manager - Quick Installation Guide

GWN Manager - Quick Installation Guide

  • Updated on August 4, 2022

GWN Manager is an enterprise-grade, management platform for Grandstream access points. As an ideal choice for private network deployment, this flexible, scalable solution offers simplified configuration and management with good performance and high security. Keep an eye on the network’s performance with real-time monitoring, alerts, statistics, and reports that can be viewed using a web browser or a mobile application. Thanks to streamlined monitoring and maintenance, managing your network has never been easier.

This guide describes the steps on how to install GWN Manager on your Linux machine.

Most Linux commands used in this guide will require a Root (Admin) privilege.

GETTING TO KNOW GWN MANAGER

GWN Manager is an On-premise Access Points Controller used to manage and monitor GWN Access points on your network. It provides an easy and intuitive web-based configuration interface, The GWN Manager can control up to 3000 GWN access points, from different models. Below is the GWN Manager architecture:

blank
Figure 1: GWN Manager Architecture

System Requirements

For up to 200 APs and 2000 Clients:

  • CPU: Intel® Core™ i3-3240 or above
  • RAM: 4GB or above
  • Storage: 250GB (SSD preferred, depending on retained data size)

For up to 3000 APs and 30000 Clients:

  • CPU: Intel® Xeon® Silver 4210
  • RAM: 16GB or above
  • Storage: 250GB (SSD preferred, depending on retained data size)

Prerequisites

  • GWN Manager version 1.0.0.21 package or higher.
  • GWN AP firmware 1.0.13.1 (required) / 1.0.3.4 for GWN7602 or higher.
  • GWN APP version 1.0.6 for iOS / GWN APP 1.0.0.19 for Android.

INSTALLING AND CONFIGURING GWN MANAGER

Installing GWN Manager

  1. First, we start with installing package dependencies using the below commands:
yum install epel-release
yum install jemalloc libaio glibc-devel fontconfig xorg-x11-font-utils freetype
blank
Figure 2: Installing dependencies
  1. After downloading the bundled package from the link: https://www.grandstream.com/support/tools
  2. You will need to uncompress it using the command below:
tar -zxvf GWN_Manager-1.0.0.13-201912121121.tar.gz
blank
Figure 3: Uncompressing the packages

  1. Then install all packages, and replace the version number according to your package, in our example the version used is 1.0.0.13.
rpm -ivh gwn*1.0.0.13*.rpm
blank
Figure 4: Installing the packages

  • Please use the RPM packages we provided to install MariaDB, Redis, Nginx, to avoid GWN Manager working abnormally.
  • GWN Manager installation is supported on virtual machines (Tested on VMware only).

Running GWN Manager

  1. Before running GWN Manager services, you will need to add firewall exceptions using the following commands:
firewall-cmd --zone=public --add-port=8443/tcp -–permanent
firewall-cmd --zone=public --add-port=10014/tcp -–permanent
firewall-cmd --reload
blank
Figure 5: Adding Firewall exceptions

By default, GWN Manager uses port 8443 for the web service (Nginx) and port 10014 for gateway communication separately

  1. Run the script to start the services using the below command:
/gwn/gwn start
blank
Figure 6: Starting GWN services
Information:

Starting version 1.0.20.22.23, GWN Manager service will start automatically after rebooting the Linux host machine.

3. After all services start up, please go to the Web Portal for further configuration.
By default, the Web Portal address is: https://server_ipaddress:8443

In our case it will be as follows:

blank
Figure7: Access GWN Manager from Web Browser

First Use

The below figures show the initial page after installation. On first use, users need to fill in additional information following the initiation Wizard. Click start to begin. For more detailed information please refer to the GWN Manager User Guide.

blank
Figure 8: GWN Manager initial Web page

Once finishing the Wizard, the login page of the GWN Manager will be displayed as below:

blank
Figure 10: Login Page

Configuring GWN Manager

Users can change the Nginx binding protocol, port as well as the access address for communication (You do not need to change the default settings in general)

/gwn/gwn config

  1. If you change the Nginx binding port, you will need to add a new firewall Exception. Moreover, for security considerations, GWN Manager runs as a non-root user, so please consider using a number larger than 1024 as the Nginx binding port number, or the service may fail to start due to denied permission.
  2. HTTPS is used by default due to its security, and GWN Manager will automatically generate a certificate along with the private key after installation. You can also apply for a certificate signed by a trusted authority to replace it.
  3. Below system paths are where you can replace the SSL certificate and private key:
  • certificate: /gwn/conf/nginx/ssl.pem
  • private key: /gwn/conf/nginx/ssl.key

After replacing the two files, restart the GWN service to validate the configuration change:

/gwn/gwn restart
blank
Figure 11: Restarting GWN services
Information:

Starting version 1.0.20.22.23, GWN Manager service will start automatically after rebooting the Linux host machine.

ADDITIONNAL INFORMATION

Configuring GWN Manager to Auto-Start

In case of GWN Manager service is not starting after a reboot, the user can make GWN Manager starts every time the computer boots up, for example in case of a power outage or just a reboot after an update.

sudo echo "/gwn/gwn start > /dev/null &" >> /etc/rc.local
sudo chmod +x /etc/rc.local

Modifying GWN Manager Password

If the user forgets the web login password and didn’t configure the SMTP server as well, he can modify the password from backstage using the below command:

/gwn/gwn modify-password

Upgrading GWN Manager

GWN Manager will check for the new firmware version automatically when you log into web GUI, if a new version is found, a notification will pop up and you may click to complete the upgrade. You can also upgrade manually using the below commands:

rpm -Uvh gwn*1.0.0.13*.rpm
/gwn/gwn restart

Uninstalling GWN Manager

Run these commands to uninstall GWN packages from your Linux system:

rpm -e gwn gwn-redis gwn-mariadb gwn-nginx
rm -rf /gwn

Important Notes

  • GWN Manager only supports one access address at present, so if your machine has more than one network interface, you should set the access address to the one (IP address) that you expect to communicate with the Access point.
  • Please consider setting the right time zone of your machine before running GWN Manager, modifying the time zone may cause data corruption.

Was this article helpful?

Related Articles

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support

Leave a Comment

blank
We use cookies in order to give you the best possible experience on our website. By continuing to use this site, you agree to our use of cookies.
Accept
Privacy Policy