Foglight 5.9.4 - Installing Foglight on a UNIX System with an External MySQL Database


	IMPORTANT: Do not use “<“ and “>” in your password, for example jo<anne>123. These characters corrupt the XML in the server.config file, causing Foglight to fail to start successfully.

To encrypt your database password using the keyman command:

Specify the following from the command line:

> bin/keyman -d [FGLHOME/config] encpwd "<new password>" foglight.defaultkey

The encrypted password appears.

Open the server.config file.

Replace the existing database password with the new encrypted database password on the following line:

server.database.password = "q4056753111e8a24c9a722048fc6df1f0"

Restart the Management Server.

Setting up an encrypted database connection with SSL

The following procedure outlines how to set up a secure external MySQL® database connection and verify that the MySQL® Server supports SSL encryption.


	NOTE: This procedure must be performed after installation but before you start the Management Server.

To set up an encrypted external MySQL database connection with SSL:

Import a CA certificate into the Management Server keystore (cacerts) as outlined in Importing a network security certificate.

Update the MySQL configuration file (my.ini) with the new security certificate and key information by adding the following properties:

•

ssl-ca=<cacert.pem>

•

ssl-cert=<server-cert.pem>

•

ssl-key=<server-key.pem>

Uncomment and set the server.database.secureconn attribute in the server.config file to true, as shown below.

server.database.secureconn = "true";


	NOTE: Do not enable this option until the database server’s CA certificate is properly imported into <foglight_home>/jre/lib/security/cacerts.

Start the database.

Start the Management Server.

To verify whether the MySQL Server (mysqld) supports SSL connections:

Ensure that the MySQL Server (mysqld program) for your Foglight database is running.

mysql --host <hostname> –port=<mysql_db_port_number> –user=<mysql_user> --password=<mysql_user_passwword>

At the mysql prompt, run the following query:

show variables like 'have_ssl'

The output shows the variable have_ssl with a value of either YES or DISABLED.

If the value is YES, the MySQL® Server supports SSL connections. If the value is DISABLED, the MySQL Server supports SSL connections but was not started with the appropriate SSL command options (-ssl-<option_name>=<value>). See the MySQL documentation for more information about these options.

Setting up an encrypted LDAP connection with SSL

Use the following instructions if you need to encrypt communication between the Management Server and the LDAP server.

To encrypt communication between Management Server and LDAP:

Acquire the LDAP server certificate in .pem format from the administrator.

Import the certificate into the Management Server keystore, <foglight_home>/jre/lib/security/cacerts (default password: changeit), with the following command:

<foglight_home>/jre/bin/keytool -J-server ‑import ‑file <path_to_cert_file> ‑alias ldapsvrcert ‑keystore <path_to_cacerts> ‑storepass <store_pwd>


	NOTE: If you do not specify the password using the ‑storepass option, keytool prompts you to supply it. NOTE: In addition to the Root CA certificate, there may be one or more intermediate CA certificates. If so, make sure to import the Root CA certificate and all intermediate CA certificates in sequence.

The following are the examples of command for importing Root CA and intermediate CA certificates:

•

Root CA certificate: <foglight_home>\jre\bin\keytool -import -trustcacerts -alias ldapsvrcert -keystore <path_to_cacerts> -storepass changeit -file <path_to_cert_file>

•

Intermediate CA certificate 1: <foglight_home>\jre\bin\keytool -import -alias ldapsvrcert2 -keystore <path_to_cacerts> -storepass changeit -file <path_to_cert_file>

•

Intermediate CA certificate 2: <foglight_home>\jre\bin\keytool -import -alias ldapsvrcert3 -keystore <path_to_cacerts> -storepass changeit -file <path_to_cert_file>

On the navigation panel, under Dashboards, click Administration > Users & Security > Directory Services Settings.

Under LDAP Locations, click Edit.

Specify the LDAP server URL in the following format:

ldaps://ldap_server_host_name:636