Install, configure, and run the PuzzleLogic Agent
The PuzzleLogic Agent is a Java application (JAR file) that works together with the PuzzleLogic Command Line Interface (CLI) to import data from monitoring tools.
NOTE: You will need t
To install, configure, and run the PuzzleLogic Agent:
- From the PuzzleLogic download site, download the file agent-1.7.5.RC3-all.tar.gz to the machine where you wish to import data from.
- Create the directory where you will run the PuzzleLogic Agent.
$ mkdir –p $HOME/<PL_Agent_directory>
For example, to create the directory plviewer-agent, type the following:
$ mkdir –p $HOME/plviewer-agent
- Extract the archive file to the new agent directory.
$ cd $HOME/<PL_Agent_directory> $ cp ~/agent-XXXXXX.tar.gz . $ tar xvf agent-XXXXXX.tar.gz
NOTE: A directory named plviewer-agent-1.7.5.RC3 is created with the following sub-directories:
- /bin contains the Agent JAR file
- /samples contains a sample application.properties file
- /cli contains the Command Line Interface (CLI) Utility.
- Copy the application.properties file from the ./samples directory to the ./bin directory.
$ cd <PL_Agent_directory>/plviewer-agent-XXXXXX/bin $ cp ../samples/application.properties .
- Generate the PuzzleLogic Agent credentials.
- Log in to Service Advisor.
- Click the Account Settings icon (on the left navigation bar) and select Organizations (on the top navigation bar).
- Select your organization. The Edit Organization page appears.
- In the Admin Keys section, click Create. A dialog box appears with a username and password to authenticate the PuzzleLogic Agent.
- Copy the username and password to a safe location. Note that these credentials will not be available once you close the dialog box.
- Set the connection information and Agent credentials in the application.properties file.
- Open the application.properties file in a text editor.
- Set plviewer.auth.base.url to https://puzzlelogic.net.
- Set plviewer.username to the generated Agent username.
- Set plviewer.password to the generated Agent password.
- Save the changes to the application.properties file.
- Start the PuzzleLogic Agent.
$ ./agent.sh start
NOTE: For production environments, consult your system administrator to create auto-start scripts to start the Agent when the system reboots.