Observeit Unix Agent Quick Installation Guide: Prerequisites
Observeit Unix Agent Quick Installation Guide: Prerequisites
Observeit Unix Agent Quick Installation Guide: Prerequisites
Prerequisites
This document assumes you already have the ObserveIT server-side infrastructure in place. This includes the ObserveIT Application and Web Management server(s) running on IIS on a Microsoft Windows Server 2003/2008 serve(s), and the ObserveIT Database stored on a Microsoft SQL Server 2005/2008, running on Microsoft Windows Server 2003/2008. In addition, you must meet the following prerequisites: 1. Obtain the ObserveIT UNIX Agent installation file and copy it to the UNIX server(s). 2. Log in to the target server with root permissions. Or, alternatively, use the pfexec command. 3. Run the ls l command and verify that the file has execute permissions (-rwxr-xr-x). Otherwise, use chmod +x for the Agents file name. 4. Make sure that the UNIX server can communicate with the ObserveIT Application server by using the correct TCP port. By default, the port number used by the ObserveIT Application server is 4884. To verify you can use the following command on the UNIX server:
telnet <ServerIP> <Port>
Where <ServerIP> is the IP address or name of the ObserveIT Application server and <Port> is the TCP port used by the ObserveIT Application server.
Quick Installation
The quick installation method is a simple way to install the Agent on a UNIX server by using a one-line command.
Where <ServerIP> is the IP address or name of the ObserveIT Application server and <Port> is the TCP port used by the ObserveIT Application server. By default, the port number used by the ObserveIT Application server is 4884.
For Solaris Sparc:
./observeit-agent-solaris-sparc-release-5.2.07.run -- s <ServerIP>:<Port>
Where <ServerIP> is the IP address or name of the ObserveIT Application server and <Port> is the TCP port used by the ObserveIT Application server. By default, the port number used by the ObserveIT Application server is 4884. The result should look like this:
Verifying archive integrity... All good. Uncompressing ObserveIT Solaris agent... Installing ObserveIT agent Copyright 2010 ObserveIT LTD. All rights reserved.
Use is subject to license terms. Installation of <OBSVobit> was successful. Successfully registered this machine and saved configuration
You may wish to check the Agents registration and health status. To do so, run the following command: /usr/lib/obit/oitcheck The result should look like this:
Check for OBSVobit package: PASS
VERSION:
5.2.07
Check that obitd daemon running: PASS Check for /var/run/observeit directory: PASS Check for /etc/observeit/obit.conf: PASS HostURL: http://192.168.200.116:4884/observeitapplicationserver http://OITYIGAL2:4884/ObserveIT
WebConsoleURL:
Two-Step Installation
The 2-step installation method lets you separate the installation and registration process into 2 steps. First installing the package, and later configuring and registering it against the ObserveIT Application server.
To check the Agents health status, you may use the following script. Run the following command: /usr/lib/obit/oitcheck The result should look like this:
Check for OBSVobit package: PASS VERSION: 5.2.07
Check that obitd daemon running: Not PASS Check for /var/run/observeit directory: Not PASS Check for /etc/observeit/obit.conf: Not PASS Check for liboit.so.1 linkage: PASS
15:22:05 svc:/application/obitd:default
If the STATE value is online, you must run the following command to disable the service: svcadm disable obitd Next, register the Agent by running the following command: /usr/lib/obit/obitd r s <ServerIP>:<Port>
Where <ServerIP> is the IP address or name of the ObserveIT Application server and <Port> is the TCP port used by the ObserveIT Application server. By default, the port number used by the ObserveIT Application server is 4884. The result should look like this:
Successfully registered this machine and saved configuration
Next, enable the obitd service by running the following command: svcadm enable obitd Finally, check the Agents registration and health status. To do so, run the following command: /usr/lib/obit/oitcheck The result should look like this:
Check for OBSVobit package: PASS VERSION: 5.2.07
Check that obitd daemon running: PASS Check for /var/run/observeit directory: PASS Check for /etc/observeit/obit.conf: PASS HostURL: http://192.168.200.116:4884/observeitapplicationserver http://OITYIGAL2:4884/ObserveIT
WebConsoleURL:
Agent Removal
In order to remove the ObserveIT Agent you need to log in to the target server with root permissions. Or, alternatively, use the pfexec command. Run the following command pkgrm OBSVobit Press y to acknowledge the removal of the package. Otherwise press n or q. Press y to acknowledge the running of scripts with super-user permissions. Otherwise press n or q.
Note that the Agent is still running in the servers memory for the current session. Therefore, to terminate it, you must close the current session by typing exit or pressing CTRL+D.