1 |
UNIX® platforms only. If required, change the permissions for the installer file to make it executable (as described in To download and run the Agent Manager installer page using a file retrieval tool: ). |
IMPORTANT: On Windows® 7 and Vista, you must run the command-line installer from an administrator version of cmd.exe or PowerShell (not just logged in as administrator) if you want the installer to install the Agent Manager as a service. |
• |
1 |
When the first part of the License Agreement step appears, press Enter to page through the license agreement. |
2 |
At the prompt Do you accept the terms of the license agreement? [Y/N], type Y and press Enter to accept the terms, and to continue the installation. |
IMPORTANT: If you are running an AIX® operating system with IPv6 support enabled and the Agent Manager installer detects problems resolving IP addresses and host names, an AIX compatibility warning appears. This warning provides information about an alternate command-line option for running the installer and a URL that you can consult for more information. See Frequently asked questions for more information. |
NOTE: You can configure Management Server URLs at a later time using the Agent Manager configuration interface. See Configuring the Agent Manager for information about launching this interface post-installation. |
a |
c |
Press Enter. |
2 |
a |
a |
b |
a |
b |
6 |
a |
b |
c |
Press Enter. |
d |
a |
c |
Press Enter. |
d |
8 |
• |
Downstream non-SSL connections, but only if you started the installer on the command line with the --allow-unsecured option (as instructed in Installing the Agent Manager using the installer interface ). |
1 |
4 |
• |
• |
To edit the path to point to the executable for a sudo-like application, type that path and press Enter. |
1 |
• |
If you want to use the default configuration options, type Y, and press Enter. Then, continue to Step 10: Summary. |
• |
2 |
Using the Select the Unix/Linux distribution menu, specify the number in the identifies your operating system. |
• |
3 |
At the Enter the user the service will run as prompt, specify the user account that runs the Agent Manager daemon. |
5 |
6 |
NOTE: The default answer to this question is Y (Yes). However, if you started the installer with the --no-start-on-exit option, the default answer to this question is set to N (No). For more information, see Installing the Agent Manager from the command line. |
• |
2 |
NOTE: The default answer to this question is Y (Yes). However, if you started the installer with the --no-start-on-exit option, the default answer to this question is set to N (No). For more information, see Installing the Agent Manager from the command line. |
• |
Press Enter to complete the installation and exit the command-line installer. |
NOTE: For complete information about the fglam command, see “Managing the Foglight Agent Manager” in the Command-Line Reference Guide. |
The URL to the Management Server, where host and port specify the host name of the machine on which the Foglight Management Server is installed, and the port number the server uses to communicate with the Foglight Agent Manager. | ||||
The password associated with the user name needed to connect to the proxy server. The password is saved encrypted in the Agent Manager configuration file (<fglam_home>/state/<state name>/config/fglam.config.xml) the next time you start or restart the Agent Manager | ||||
true|false |
||||
true|false |
||||
When used with --configure, this option creates a downstream connection.
The port argument specifies the number of the port the Agent Manager uses to listen for downstream connections. | ||||
Small allocates 10 MB for the disk queue and 512 MB of memory. | ||||
Medium allocates 100 MB for the disk queue and 768 MB of memory. | ||||
Large allocates 500 MB for the disk queue and 1 GB of memory. | ||||
Huge allows unlimited amounts of disk space for the queue, and up to 4 GB or 85% of system memory, whichever is less. | ||||
Maximum allows unlimited amounts of disk space for the queue, and 85% of available system memory. | ||||
When used with --configure, this option deletes a downstream connection given its port number. | ||||
When used with --configure, this option deletes all downstream connections. |
3 |
On UNIX® platforms, if necessary, change the permissions for the installer file so that it is executable (as described in To download and run the Agent Manager installer page using a file retrieval tool: ). |
4 |
Run the installer executable with the --silent option. |
IMPORTANT: On Windows® 7 and Windows Vista®, you must run the silent installer from an administrator version of cmd.exe or PowerShell (not just logged in as administrator) if you want the installer to install the Agent Manager as a service. |
• |
silent prevents the installer from prompting for configuration options. It uses default values unless they are specified on the command line. |
• |
• |
<platform> is the appropriate installer name for your operating system. Consult the matrix in Downloading the Agent Manager installer for the installer name. |
• |
<install_directory_path> is the full path to the directory where you want to install the Agent Manager. The installdir option is mandatory. |
IMPORTANT: Ensure that there is no existing installation of the Agent Manager in the directory that you specify with the --installdir <install_directory_path> parameter. If there is an Agent Manager installation in the directory, you must specify a different directory or the installer fails. The installer aborts, to protect you from overwriting your existing installation. Consult the Foglight Upgrade Guide for upgrade instructions. |
• |
--fms <url_and_other_parameters>, where <url_and_other_parameters> is a comma-separated list of parameters for configuring the connection to a Management Server. See Configuring Management Server URLs from the command line for a description of the parameters for the --fms option. |
• |
--noservice (on UNIX) prevents an init.d-style script from being installed (that would automatically start the Agent Manager). On Windows®, this option causes the Agent Manager not to be installed as a service. |
• |
--host-display-name <display_name>, where <display_name> is the host display name that you want to set manually for the Agent Manager. This is the host name that the Agent Manager uses to identify itself and the name under which it submits metrics to the Management Server. By default, the Agent Manager uses the host name that it automatically detects for the machine on which it is being installed. There are certain cases in which you should explicitly set the host display name: for example, if the host name is already in use by another machine. |
• |
--spid <path_to_SPID>, where <path_to_SPID> is the path to an existing SPID installation. This allows you to (optionally) migrate agents from an existing SPID installation to the new Agent Manager installation. The Agent Manager automatically detects any agents managed by SPID from the old installation and copies the agent instances to the new Agent Manager installation. |
• |
--certificate alias=<path> allows you to add an SSL certificate, where <path> is the directory path to the SSL certificate file. |
• |
--downstream allows you to create a downstream connection. |
• |
port=<port> specifies the number of the port the Agent Manager uses to listen for downstream connections. This argument is mandatory. |
• |
key-password=<password> specifies the password needed to access the private key contained in the keystore. |
• |
type=<https|http> specifies the type of the supported protocol. |
• |
host=<host> specifies the host name to be set in the certificate. |
• |
size=<Small|Medium|Large|Huge|Maximum> specifies the amounts of disk and memory resources that are allocated to downstream connections. |
• |
--allow-unsecured enables the configuration of HTTP downstream connections. |
• |
--no-start-on-exit prevents the Agent Manager Windows service or Unix daemon from starting immediately after the installation. |
• |
-h or --help lists the arguments available with the installer executable and exits. |
• |
-v or --version display the Agent Manager version number and exits. |
• |
-j or --javavm sets the location of the Java virtual machine, for example, the directory that JAVA_HOME points to. |
• |
--installer-properties sets the path to the installer properties file. This file contains the default installer values used during installation. Its contents must be in a Java Properties format and can include a mix of installer arguments and arbitrary properties for use by the installer runtime. All installer options can be defined here but must be prefixed with “installer.” and have the “--” removed from the argument name. All other argument value setting constraints still apply. For installer arguments that can be declared multiple times, a numeric value must be appended to the end of the property name in order to make the key unique. For example: |
• |
--headless launches the Agent Manager and configuration interface on the command line. If not specified, the graphical interface is displayed. |
• |
--auth-token registers an authentication token during the installation. The token is generated from the Management Server and provides authorization for this Agent Manager to connect. |
• |
--noservice prevents the Agent Manager service from being installed on Windows. On UNIX, it prevents the installer from installing an init.d script that automatically starts the Agent Manager. |
• |
--host-display-name specifies the display name used to identify this Agent Manager instance. |
• |
--detectha locates and configures additionally available high availability (HA) servers. |
1 |
Launch a Command Prompt window on the Agent Manager host machine and navigate to the <fglam_home>\bin directory. |
IMPORTANT: On Windows 7 and Vista, you must issue the command to manually install the Agent Manager as a Windows service using an administrator version of cmd.exe or PowerShell (not just logged in as administrator). |
3 |