Difference between revisions of "Connector"

From Airangel Wiki
Jump to: navigation, search
(NMS Configuration)
(Installation)
 
(5 intermediate revisions by the same user not shown)
Line 53: Line 53:
  
 
''Install Command''<br>
 
''Install Command''<br>
bash <(curl -s https://repo-ng.captive.net/connector)
+
<code>bash <(curl -s https://repo-ng.captive.net/gpns)</code>
  
 
''Flow''
 
''Flow''
  
<code>[root@localhost ~]# bash <(curl -s https://repo-ng.captive.net/connector)
+
<code>[root@localhost ~]# bash <(curl -s https://repo-ng.captive.net/gpns)</code>
  
 
Welcome to the Captive.net Connector installer
 
Welcome to the Captive.net Connector installer
Line 69: Line 69:
 
This installer assumes that this system is freshly installed CENTOS7 MINIMAL
 
This installer assumes that this system is freshly installed CENTOS7 MINIMAL
  
--------
 
  
Please enter your instalation key:</code>
+
====Web Based Login and Licensing====
 
 
*enter the captive.net installation key
 
 
 
<code>Installing Captive.net repository...
 
 
 
Loaded plugins: fastestmirror
 
 
 
captive-rpm-repo | 2.9 kB 00:00:00
 
 
 
captive-rpm-repo/primary_db | 17 kB 00:00:01
 
 
 
Loading mirror speeds from cached hostfile
 
 
 
base: mirror.kinamo.be
 
 
 
extras: mirror.kinamo.be</code>
 
 
 
*Now system will install all dependencies for the project
 
 
 
*After installing you'll see the complete and the request to configure the webserver
 
 
 
<code>Complete!
 
 
 
Do you want to configure the apache webserver for installed packages? (Y/n):</code>
 
 
 
*Press Y to configure the webserver
 
 
 
<code>Https port for (captive-connector) [443]:</code>
 
*We recommend to keep it on port 433 (just press enter to accept the default)
 
 
 
<code>Web path for (captive-connector) [/connector]: /</code>
 
*Set the path to/to avoid having to enter/connector on each web request
 
 
 
<code>Security-Enhanced Linux (SELinux) is enabled.
 
 
 
Enabling SELinux means you need to set proper context for files and folders and write policies to allow proper runtime of the system.
 
 
 
Please enable this if you are familiar with SELinux and are capable to manage the SELinux rules.
 
 
 
Do you want to keep SELinux enabled? (Y/n):</code>
 
 
 
*Press N unless you are capable of configuring selinux
 
 
 
<code>Do you want to configure the firewall for the required ports? (Y/n):</code>
 
*Press Y, installer will open port 433 to the world
 
 
 
<code>----------------------
 
 
 
Instalation completed</code>
 
 
 
====Step 2 - Web Based Login and Licensing====
 
 
[[File:PMS-Configuration-Box.png|200px|thumb|right|PMS configuration box.]]
 
[[File:PMS-Configuration-Box.png|200px|thumb|right|PMS configuration box.]]
 
[[File:Room-List-Configuration.png|200px|thumb|right|Room list configuration box.]]
 
[[File:Room-List-Configuration.png|200px|thumb|right|Room list configuration box.]]
 
[[File:PMS-Logging.png|200px|thumb|right|PMS logging dialog.]]
 
[[File:PMS-Logging.png|200px|thumb|right|PMS logging dialog.]]
Open a webbrowser and point it to the IP of the newly installed machine (use HTTPS)
+
Open a web browser and point it to the IP of the newly installed machine (use HTTPS)
  
 
*Login using Username: Admin/ Password: Admin
 
*Login using Username: Admin/ Password: Admin

Latest revision as of 14:20, 15 February 2021

Connector

Image of the Connector/PMS setup wizard.

The connector is required where a local agent or proxy services are required to deliver features. This typically runs locally on a micro server but can also run from a cloud instance.

Examples of services using the connector are:

  • FIAS / Opera PMS
  • NMS
  • Radius & 802.1x* with local caching
  • Optional Logging Server

* must install bash <(curl -s https://repo-ng.captive.net/gpns)

Minimum Requirements

It can be installed on any standard x86 hardware as a software package on CentOS 7. The recommended route is to use a CentOS 7 Minimal installation and add the package. Other architectures (e.g. ARM) are not yet supported.

Cloud-Hosted Connector

It is technically possible to run the connector in a public cloud (e.g. AWS) and tunnel traffic to the local site, but some elements may be adversely affected, such as increased latency for RADIUS and NMS.

For AWS use, a t2.micro instance is typically more than sufficient to perform the necessary tasks for one site.

OS Configuration

Notes about suitable configurations of the underlying OS.

Firewall (if required)

Typically, a firewall is not required on the connector itself, since it is already shielded from the Internet by the gateway, and it should sit in a secured network (no direct guest access) given that it is likely to have access to the PMS.

However, if firewall configuration is required, the CentOS 7 standard of firewalld should be used. The installer for the Connector software will open port 443 using firewalld if it is installed.

The simplest command-set for adding firewall rules is, for example:

~# firewall-cmd --permanent --zone=public --add-port=22/tcp
~# firewall-cmd --reload

For further reading see the original documentation or this short guide.

Future Topics

Configuration

  • Licensing
  • Plugin regsitration
  • PMS configuration
    • FIAS
    • PROTEL
    • GUESTLINE
    • ONQ
  • Field policies

Installation

A fully configured Connector Menu

Method
Terminal

Install Command
bash <(curl -s https://repo-ng.captive.net/gpns)

Flow

[root@localhost ~]# bash <(curl -s https://repo-ng.captive.net/gpns)

Welcome to the Captive.net Connector installer

This installer installs all required packages for Captive.net's connector and will provide you basic configuration to get a functional system.

The goal of the initial configuration is to get you up and running quickly and is under no circomstances a replacement for a system administrator that configures and maintains the services or the operating system

The proposed configuration may break or malfunction any existing configuration on the system so DO NOT install this on a production server that is used for other purposes

This installer assumes that this system is freshly installed CENTOS7 MINIMAL


Web Based Login and Licensing

PMS configuration box.
Room list configuration box.
PMS logging dialog.

Open a web browser and point it to the IP of the newly installed machine (use HTTPS)

  • Login using Username: Admin/ Password: Admin
  • Go to Settings at the top right
  • Go to Connector Settings
  • Enter the Captive.net license key, and press save, on success the connector will be licensed to this IP. IMPORTANT, since this IP (or it's URL) will be licensed it's important to use the production IP's or domains. If not, old ones will need to be removed from the license in order to free up licenses for others.
  • Configure a new, more secure password
  • In case applying the license returns invalid license, please contact Captive support with the URL you are licensing and the license key. Possibly the amount of licensed are used up.

PMS Configuration

In the PMS configuration, you configure how the system should connect to the PMS.

Room List

It could be useful to see how what rooms the connector received from the PMS, or to check why a status is set to deny (e.g. a No post flag set by the PMS).Go to the room list in the main menu on the left side and you will find a list of all check-in rooms the the corresponding guest, you can open the profile and check each parameter received by the PMS.

PMS Debug Log

Depending on how PMS is configured a full PMS debug log can be found under logging.

NMS Configuration

NMS.png Access the NMS configuration through Settings and Plugins. Choose the installed connector from the list. In this screen you select the SNMP version and the Community string and password if required.

By populating Notification email addresses here, all triggered alert emails will be sent to these addresses without the need to subscribe to assets individually.