Please NOTE:  Whatsup Gold supports Elasticsearch 8.x at this time, and we recommend the latest 8.x available to get the current security updates.

Our recommended minimum hardware requirements for the Elasticsearch server are as follows: 

CPU speed >= 2.6 GHz
CPU count >= 8 cores
RAM >= 16 GB

 

STEP 1: Download Elasticsearch 

This guide was written using versions 8.X and following link below will allow the search for Supported Versions of Elasticsearch. 

• Search for Elasticsearch Versions to download NOTE: WUG DOES NOT SUPPORT MAJOR VERSION 9.X

 
STEP 2: Installing Elasticsearch 

NOTE: When running the following steps below use the Built-In\Administrator account as it will be the OWNER over the Elasticsearch folders to generate Certificates for HTTPS.
 

1. Choose where you would like to install and store the Elasticsearch database files (this guide is using C:\Elasticsearch though you can install it wherever you would like.) 
2. Unzip and copy the contents of the zip to your chosen installation directory (Do not to use special characters in the naming of the Elasticsearch directory) 
3. Open a command prompt (As Administrator) 
4. Navigate to the bin directory where Elasticsearch is installed. (Example: C:\Elasticsearch\bin) and run the following as this will use Elasticsearch's Security Auto Configuration to setup HTTPS.

5. Once the following text shows us you can press CTL+C to get an 'Terminate batch job(Y/N)?' prompt and type 'Y' and press enter.

6. Now the Elasticsearch Service can be installed in the Services Control Panel (services.msc) with the command below.

7. You should get several lines of output with "The service 'elasticsearch' has been installed." at the end 
8. Open the Services Control Panel (services.msc) find the Elasticsearch service and open its properties and set its startup type to Automatic. 
   1. Example of Service Name: Elasticsearch 8.11.1 (elasticsearch-service-x64)     

9. Start the "Elasticsearch Service"
10. Open a web browser (not IE) and navigate to HTTPS://localhost:9200
    1. * This assumes that Internet Information Services (IIS) is already installed on the Server; if it is not please see Microsoft documentation on how to install IIS.
11. Check to see if a login page populates, if so, please continue to the steps below to setup a user.

STEP 3: Configuring Authentication 
 

1. By default Elasticsearch 8.X will not have any created users. The steps below will give information to create the users and for more advance step please view the vendor documentation.  
2. Open a command prompt (As Administrator) 
3. Navigate to the bin directory where Elasticsearch is installed. (Example:  C:\Elasticsearch\bin) and run 

User List example:  (List should blank for a new installation) 
 
Example: C:\Elasticsearch\bin> elasticsearch-users list  (If you are using PowerShell or Terminal instead of Command Prompt, make sure to add .\  before the command such as C:\Elasticsearch\bin> .\elasticsearch-users list)

User Setup example: (elasticsearch-users useradd <username> -p <password> -r <role>) 

Example: C:\Elasticsearch\bin> elasticsearch-users useradd wugtest –p wugtest –r superuser (If you are using PowerShell or Terminal instead of Command Prompt, make sure to add .\  before the command such as C:\Elasticsearch\bin> .\elasticsearch-users useradd wugtest –p wugtest –r superuser)

  For information on Commands and Roles please view the below hyperlinks.

• Commands 

• Roles
   

4. Open a web browser (not IE) and navigate to HTTPS://localhost:9200 (or whatever port you chose for http.port earlier in the config) 
5. Enter the username and the password created in the steps above. 
6. Verify that you can successfully login

STEP 4: Configuring WUG 
 

1. Login to WUG's WebUI 
2. Navigate to Settings > Log Management > Log Management Settings 
3. For the Elasticsearch host enter the HOSTNAME or FQDN of the server where Elasticsearch is installed.
4. Enter the correct port 
5. Enter the username and the correct password created in the section on Configuring Authentication 
6. Enable Use SSL 
7. Disable Ignore Certificate Errors 
8. Click Upload and specify the http_ca.crt file from the Elasticsearch install directory <ES_Install_Dir>\Config\Certs\http_ca.crt  NOTE: As Elasticsearch needs to be installed on a separate system then you will need to copy that file to somewhere that is accessible for you to upload.
9. Enable Ignore Certificate Errors 
10. In the Log Management Settings change the "Online Retention Setting" to specify the number of days log data should be retained before WhatsUp Gold begins deletion of older logs. 
11. Click Save (If you have done everything correctly there should not be any errors) 
12. Open an Admin command prompt on the WUG server 
13. First run "iisreset" to restart IIS as the Elasticsearch connection settings are cached and restarting IIS is required to reload the new values.
14. Before Continuing restart the Windows Service "IPSwitch Service Control Manager"
15. Now navigate to where WUG is installed and run

16. Now verify that the CA is present by Navigate to Settings > Log Management > Log Management Settings.
17. Log back into the WUG NmConsole and view any of the Log Management reports and verify you do not receive any errors in the upper right of the screen. (Note the reports are likely blank since no logging data would have been collected yet.) 
18. Now you can deploy WUG Agents and or configure Log Management settings