Page History
Table of Contents |
---|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
This guide will help you to set up panagenda GreenLight in no time! If you have any comments or suggestions, please contact us at support@panagenda.com.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Easy setup with near zero maintenance effort requirements
Live monitoring dashboard in tabled format and a dynamic topology map
Enterprise scalable data collection
Built-in reporting environment - no need to have comprehensive Excel skills or do frustrating data collection and transformation
Historic data is available anytime for in depth reporting and incident analysis
Export reports as image and PDF - the collected data is never converted into just
images but always at your fingertips
Easy analyzing of database information - makes security audits or simply health checks so much more efficient
Flexible alerting
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Trial Hardware Requirements:
...
Additional resources may be required under all above described conditions, depending on data collection intervals, number of sensors enabled, and number of servers being monitored. panagenda and selected panagenda GreenLight business partners can help you evaluate the optimum hardware specifications for your environment.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Operating System:
panagenda GreenLight comes as a VMWare appliance including its own operating system based on the popular AlmaLinux distribution (https://almalinux.org/de/). The requirements on the underlying operating system running the VMWare server solution depend on the chosen VMWare product. The panagenda GreenLight appliance runs with VMWare Player, Workstation, Server, ESX, ESXi and vSphere as host system. Detailed information about operating system requirements can be found on the VMWare product page of the selected product: www.vmware.com/products/
HCL Domino Notes:
A HCL Domino Notes user ID with access to the servers that are to be monitored and read access to at least one public names and address book on these servers is required.
For a more detailed analysis of historic historical performance data, read access to the HCL Domino log.nsf database may be required.
Depending on mail flow tracking and tracing, reader or author access is required for all mail router boxes (mail.box) and editor access for dedicated mail-in databases. For replication monitoring, application design and database content analysis, the respective HCL Notes user ID requires read access to the respective applications and documents.
For detailed HCL Domino server monitoring, Release 4.5.x or higher of the Domino Server is required.
User ID Requirements:
panagenda GreenLight requires a HCL Domino Notes User ID to access your Domino infrastructure. The ID´s password must be set to "greenLightUseOnly" (case sensitive!). You can set another password in the backend configuration file ramkin-config.properties (see GreenLight Administrator's Guide). The ID must have access to all the servers that should be monitored by panagenda GreenLight.
Network Access:
Company Network
The appliance must be able to reach the monitored servers via a TCP/IP network and must be reachable via web browser to access the panagenda GreenLight Web Interface.
Internet
For automatic license and software updates, panagenda GreenLight requires access to the internet. Alternatively, panagenda GreenLight can be updated via update packages that are installed via file upload to the panagenda GreenLight appliance. To acquire those packages for manual update please contact support@panagenda.com.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Operating System and Software Requirements:
As for hardware, panagenda GreenLight´s Web Interface is available on any operating system supported by HTML5.
Browser Security and Network Access:
No special web browser security settings are required to run the panagenda GreenLight Web Interface.
To access the panagenda GreenLight Web Interface, you need to have access at least to the panagenda GreenLight appliance via TCP/IP, Port 443 (HTTPS).
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
panagenda GreenLight is developed as a virtual appliance:
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
- AlmaLinux 9.3
panagenda GreenLight is based on the very popular AlmaLinux distribution, which is based on the source code of Red Hat Enterprise Linux (RHEL). This Linux distribution was chosen because of its stability and its long-time support (Maintenance until May 2027). Only security patches are configured for automatic update via the YUM (yellowdog updater modified).
- Docker 26 CE
- Docker Compose 1.11
- Tomcat 9 Application Server
- Nginx 1.25 Reverse Proxy Server
- Java 17 Virtual Machine
- PostGreSQL 14 Relational Database Server
- A sub-set of Domino 9.0.1 Linux 64 Bit binaries
Appliance Maintenance and Updates
Please take a look to Appliance Maintenance and Updates to find out how to handle Updates and Maintenance of the Appliance
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Contact panagenda(via website: www.panagenda.com/en_uk/contact or email: office@panagenda.com) or one of our business partners to acquire the following two files:
- greenLight2.ova is a VMWare-specific file
- greenLight2.lic is your panagenda GreenLight license file. Place it in a folder on your local hard drive. This file will be uploaded to the virtual appliance in a later step using the panagenda GreenLight Web Interface.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
- Start VMWare Player or VMWare Server
- Open Virtual Machine
- Navigate to the folder where the greenLight2.ova is located
- Select the file greenLight2.ova
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Open VMWare ESX, ESXi or vSpere and select:
...
- Source: Specify the location where you saved the GreenLight OVM file on your hard drive - for example: C:/Temp/GreenLight290.ova
- OVF Template Details: In this step you can inform yourself about the GreenLight version you are about to deploy. When you are done, just click on Next
- Name and Location: Is the next relevant step for deploying GreenLight. We recommend to name naming this template "panagenda GreenLight 2"
- Storage: Then you have to select a destination storage for the virtual machine files.
- Disk Format: In this step, please select the format you want to store the virtual disks. We recommend to choose choosing "Thick Provision Eager Zeroed"
- Network Mapping: Then select the network the deployed GreenLight template should use.
- Ready to Complete: In the final step you are shown the options you set up. Click on Finish if you are satisfied with you setting to start the deployment task.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
After starting up the appliance for the first time, you should be presented with a panagenda GreenLight welcome screen. If your network has a public DHCP server available, the system might already have acquired an IP address and will display the URL. Use the shown IP address (interface URL) in your web browser to connect to the panagenda GreenLight web interface. If DHCP is not available within your network or the panagenda GreenLight appliance did not acquire any IP address, you have to configure the panagenda GreenLight appliance network settings (see "Network Settings:" on page 13).
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
GreenLight provides a console and a graphical user interface in order to configure operating system level settings like network, time and time zone settings.
Default login information:
user "root" with password "config"
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
After login, basic information, such as disk space, system time and IP address, are shown:
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
There are two ways to use the GUI to configure your GreenLight appliance:
Local
In order to start the GUI locally (Vmware Console), enter the command "startx"
To start the GUI automatically when GreenLight is booted, please enter the following command: "systemctl set-default graphical.target"
Remote Access via VNC
Please note that remote VNC access is only possible if the GreenLight appliance received receives an IP address via DHCP.
Please refer to "Remote Appliance Access (VNC)" for more details on VNC access.
GUI Basics
...
To check an established internet connection, a web browser (Mozilla Firefox) is available on the panagenda GreenLight appliance. You can use the terminal window to check if your TCP/IP connection is established, using Linux ping and ifconfig command. For more information about ping and ifconfig commands, type man ping or man ifconfig in the terminal console window. panagenda GreenLight log files can be found within the /opt/panagenda/logs directory. The main log file (/opt/panagenda/logs/tomcat/greenlight.log) holds essential information about panagenda GreenLight runtime behavior. Use the Files app to navigate to these log files. To check the panagenda GreenLight appliances system behavior, you can use the installed system monitor.
Network Settings:
To change the IP address and DNS configuration please click on the Network icon. Select the Ethernet connection and click on Edit:
...
Go to the IPv4 Settings tab and select Manual from the Method drop-down menu to configure the network settings as required:
...
Info |
---|
|
When changing the host name hostname (default is "GreenLight") in the Host Information application, please make sure to adapt the host alias properties for 127.0.1.1 in /etc/hosts. This can be done using the gedit application. It is recommended that both host name hostname and full fully qualified domain name are entered here:
Time Zone Settings:
Please check the time zone settings of the appliance, and use the Time and Date application to adjust.
Info |
---|
|
CORS Setting
Please modify the following file and enter your GreenLight Server CORS config
- Open a console window and enter: vim /opt/panagenda/appdata/gl/config
- add: PANAGENDA_CORS_ALLOWED_ORIGINS=your_GL_URL
- example: PANAGENDA_CORS_ALLOWED_ORIGINS=https://gl-dev-01.panagenda.local
- Save/close by entering: hit ESC + :wq!
- enter: gl down
- enter: gl start
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
To connect to the panagenda GreenLight Web Interface, you have to enter the host IP address of the appliance (see "Welcome Screen and IP Address" on page 10) or its hostname (FQDN; see "Network Settings:" on page 13) into your web browser's address bar.
panagenda GreenLight uses HTTPS for secure communication between its appliance and its Web Interface, so you have to accept the security certificate, to go on.
Info |
---|
|
Login:
panagenda GreenLight uses an internal account management to support different user roles and access levels for different monitoring tasks. By default a user with administrative credentials is available to access the panagenda GreenLight Web Interface.
Default user login information
- Username: admin
- Password: greenLight
Please keep in mind, that panagenda GreenLight access control and account management implements the following security restrictions:
...
Every time you log into the panagenda GreenLight workspace, you can choose from a list of languages used within the Web Interface. If your preferred language is not available, contact your local panagenda GreenLight administrator for other language packages on hand.
panagenda GreenLight License:
If you connect to your panagenda GreenLight appliance the first time, you will be asked to upload your panagenda GreenLight license file (see "Obtaining panagenda GreenLight" on page 9).
License Agreement
The first time, you install a trial or enterprise license file through the panagenda GreenLight Web Interface, you have to accept the panagenda GreenLight license agreement. Only users with administrative access rights to panagenda GreenLight can accept this. The agreement must be accepted at least once for panagenda GreenLight to work properly.
Info |
---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
After uploading a License File, it is a mandatory step to upload upload a Notes ID for GreenLight.
...
Info |
---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Anchor | ||||
---|---|---|---|---|
|
After filling the required (or desired information) into the form, you can start your domino network discovery. Depending on your network and settings, the duration of the discovery can vary. If it is over,
The panagenda GreenLight Domino network discovery is fully cluster-aware and creates special cluster nodes to monitor and display special cluster information.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
You can add any device to your panagenda GreenLight monitoring environment for example if you would like to add your Domino server manually or devices couldn't be found by the Domino network discovery scan (for example non-domino-servers, printers, routers).
...
You can enter any network Host Name or IP address of an existing network device. After that, you can check, if a Domino Server runs on your device. In case of that, the Domino Server Name will be entered in the corresponding field.
You can select a Network Authority in this dialog as well (see "Network Authority" on page 25). In addition you can set a Location, Time Zone and a Separator Format.
If you click on next, you can define the business hours and maintenance periods (see "Business Hours and Maintenance Periods" on page 24).
If you click further on next, you can specify mail recipients by severities per host.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Here you can define a SMTP mail receiver. Type in at least the required information to the appropriate field to be able to save it, what makes the profile available under SMTP Mail Actions.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
If you wish to use panagenda GreenLight from multiple workstations at the same time, please create as many users as required using this form. Specify a Login Name, a Password and in addition, if this account should be active from now on and if the user should get administrator rights.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
In order to enable access to the Linux GUI, a VNC server is pre-installed on the GreenLight appliance. To start the VNC server, please follow these steps:
...
Info |
---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Please refer to the following article in our kbase: {*}https://www.panagenda.com/kbase/x/dY-o*
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
In order to To adjust the IP ranges for Docker, please perform the following steps:
...
- Save/close
- afterwards execute the following command:
gl customize
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|