Foglight 5.9.8 - Command-Line Reference Guide

fms

Running the Server in High Availability Mode

foglight_db_upgrade

The foglight_db_upgrade command verifies the database version and upgrades it to a higher version if necessary. This command is useful when you need to migrate data from a Foglight environment that is running a lower version of the embedded database. This typically happens when the database upgrade that is initiated through the installer fails to complete.

Syntax

foglight_db_upgrade [-config path_to_server.config] [-debug]

Table 4. Options and arguments
Options	Argument	Description
config	path_to_server.config	Provides the location to the server.config file.
debug	None	Prints debugging information.

Example

C:\Quest\Foglight\bin>foglight_db_upgrade -debug

2012-09-05 10:03:09.875 INFO Starting up the embedded database...

2012-09-05 10:03:13.281 INFO Checking if the embedded database still running...

2012-09-05 10:03:14.234 INFO Successfully shutdown the embedded database

2012-09-05 10:03:15.250 INFO STDIN/mysqld:120905 10:03:14 [Note] Plugin

'FEDERATED' is disabled.

2012-09-05 10:03:20.250 INFO STDIN/mysqld:120905 10:03:19 InnoDB: Started; log

sequence number 0 717068346

2012-09-05 10:03:20.250 INFO STDIN/mysqld:120905 10:03:19 [Note] Event

Scheduler: Loaded 0 events

2012-09-05 10:03:20.250 INFO STDIN/mysqld:120905 10:03:19 [Note]

C:\Quest\Foglight\mysql\bin\mysqld.exe: ready for connections.

2012-09-05 10:03:20.250 INFO STDIN/mysqld:Version: '5.1.45-enterprise-

commercial-pro' socket: '' port: 13306 MySQL Enterprise Server - Pro

Edition (Commercial)

2012-09-05 10:03:22.437 INFO Embedded database successfully started

2012-08-29 13:07:50.843 INFO STDIN/mysqld:120829 13:07:49 [Note] Plugin

'FEDERATED' is disabled.

2012-08-29 13:07:51.843 INFO STDIN/mysqld:120829 13:07:50 InnoDB: Started; log

sequence number 0 221724334

2012-08-29 13:07:51.843 INFO STDIN/mysqld:120829 13:07:50 [Note] Event

Scheduler: Loaded 0 events

2012-08-29 13:07:51.843 INFO STDIN/mysqld:120829 13:07:50 [Note]

C:\Quest\Foglight\mysql\bin\mysqld.exe: ready for connections.

2012-08-29 13:07:51.843 INFO STDIN/mysqld:Version: '5.1.45-enterprise-

commercial-pro' socket: '' port: 13306 MySQL Enterprise Server - Pro

Edition (Commercial)

2012-08-29 13:07:53.109 INFO Embedded database successfully started

...

Managing Encryption Keys

Foglight stores encrypted passwords and uses application tokens to look up encryption keys. In a default installation, keystore and database passwords are encrypted using the foglight.defaultkey, stored in the <foglight_home>/config/mstkey.properties file.

In some cases, you may need to change the database password or the default keystore password, for extra security. A newly changed password must be encrypted using the keyman command, and updated in the appropriate configuration file:

•

Foglight database password is stored encrypted in the <foglight_home>/config/server.config file, in one of the following configuration parameters:

•

server.database.password sets the password used by the Management Server to establish the connection with the database.

•

server.database.embedded.password sets the password of the embedded database. The Management Server uses this value to start the embedded database. This is usually the root password that can be changed and encrypted.

•

The <foglight_home>/config/tomcat.keystore password is stored encrypted in the <foglight_home>/server/tomcat/server.xml file. The default keystore password is nitrogen.

To change, encrypt, and update a database password:

Open a Command Prompt window (Windows) or a terminal window (UNIX® or Linux®).

Encrypt the new password.

On the Management Server machine, navigate to the <foglight_home>/bin directory.

Issue the following command:

keyman encpwd <password> foglight.defaultkey

Where password is the newly changed database password.

Record the output of the keyman command. For example:

Encrypted Password: q40799f927b44ba22192f3a4fa2f1cc91

For more information about the keyman command, see keyman .

Update the server.config file with the newly encrypted database password.

On the Management Server machine, open the <foglight_home>/config/server.config file for editing.

In the server.config file, replace the value of the appropriate entry (server.database.password for external database or server.database.embedded.password for embedded database) with the encrypted password, as recorded in Step c.


	IMPORTANT: The password must be enclosed in double quotes.

Save the changes to the server.config file and restart the Management Server.

Change the password for the Management Server user in the database (the default user name is foglight). For more information, see your database documentation.

To change, encrypt, and update a tomcat.keystore password:

Open a Command Prompt window (Windows) or a terminal window (UNIX® or Linux®).

On the Management Server machine, navigate to the <foglight_home> directory and issue the following command:

jre/bin/keytool -J-server -storepasswd -keystore

<keytool_path>/tomcat.keystore

Where keytool_path is the directory path to the tomcat.keystore file.

Change the password for all of the keys within the keystore:

jre/bin/keytool -J-server -keypasswd -alias <key_name> -keystore

<keytool_path>/tomcat.keystore

Where:

key_name is the name of the key in the keystore whose password you want to change.

keytool_path is the directory path to the tomcat.keystore file.


	TIP: To list a keystore for all of its aliases, issue the following command: jre/bin/keytool -J-server -keystore <keytool_path>/tomcat.keystore -storepass <password> --list -v Where: keytool_path is the directory path to the tomcat.keystore file. password is the keystore password.

For more information about the keytool command, see your Oracle® JavaTM documentation

Encrypt the new password.

On the Management Server machine, navigate to the <foglight_home>/bin directory.

Issue the following command:

keyman encpwd <password> foglight.defaultkey

Where password is the newly changed tomcat.keystore password.

Record the output of the keyman command. For example:

Encrypted Password: q40799f927b44ba22192f3a4fa2f1cc91

For more information about the keyman command, see keyman .

Update the server.xml file with the newly encrypted tomcat.keystore password.

On the Management Server machine, open the <foglight_home>/server/tomcat/server.xml file for editing.

In the server.xml file, locate the keystorePass attribute, and update its value with the newly encrypted password, as recorded in Step c.


	IMPORTANT: The password must be enclosed in double quotes.

Save the changes to the server.xml file and restart the Management Sever.

keyman

The keyman command allows you to encrypt passwords, to change, add, or delete encryption keys, or to generate application tokens.

Syntax

keyman [chmstkey old_key new_key] [addappkey key_name key_text key_pwd]

[delappkey key_name] [encpwd "pwd_str" key_name] [getapptkn key_name key_pwd]

Table 5. Options
Option	Description
addappkey	Adds an application key.
chmstkey	Changes the master key
delappkey	Deletes an application key.
encpwd	Encrypts a password string using an encryption key.
getapptkn	Generates an application token.

Table 6. Arguments
Argument	Description
key_name	Specifies the name of the application key.
key_pwd	Specifies the password that protects the key.
key_text	Specifies the key value.
new_key	Specifies the new key value.
old_key	Specifies the old key value.
pwd_str	Specifies the password value that is to be encrypted. NOTE: This value must always be enclosed in double quotes. For example: keyman encpwd "my_new_password" foglight.defaultkey

Example

C:\Quest\Foglight\bin>keyman addappkey my_key my_key_text my_key_pwd

KeyToken: f3f3d72d81b1959bdf32416357b57e97aa63b199

Managing the Foglight Agent Manager

The Foglight Agent Manager is an application that manages Foglight agents on monitored hosts and allows them to communicate with the Foglight Management Server.

Foglight offers a set of commands that allow you to perform Foglight Agent Manager operations through the command-line interface. You can use these commands to perform a variety of tasks, such as start or stop the Foglight Agent Manager, display the version information, manage JVM options, or create a Foglight Agent Manager support bundle.

The Foglight Agent Manager component manages agent instances and their communication with the Foglight Management Server. Foglight Management Server installs include an embedded Foglight Agent Manager. The embedded Foglight Agent Manager on the Foglight Management Server starts up and stops with the server. This agent manager instance can be used to deploy agents and monitor the host on which the Foglight Management Server is installed, if required. To monitor additional hosts in your environment, you must install an agent manager component separately on each host computer. For more information about installing agent managers on monitored hosts, see the Agent Manager Guide.


	IMPORTANT: Embedded Foglight Agent Manager instances do not automatically start on server startup if you are upgrading the server. You can override this behavior by setting the parameter server.fglam.embedded in <foglight_home>/config/server.config to true.

•

Getting Started

•

Starting or Stopping the Foglight Agent Manager

•

Creating Agent Manager Support Bundles

製品を選択してください:

サービス向上のために、「Purpose of your Chat（チャットの目的）」を記入してください。

お客様の不具合に推奨されるソリューション

Foglight 5.9.8 - Command-Line Reference Guide

foglight_db_upgrade

Managing Encryption Keys

keyman

Managing the Foglight Agent Manager