The agent is supported on the following systems:
Footnotes
| [1] | (1, 2, 3, 4, 5, 6) On x86_64 the agent still runs as a 32-bit application, the OS needs to have the adequate 32-bit compatible userland support installed. |
| [2] | (1, 2) These platforms have reached their end-of-life date as specified by their original vendors and are only supported on a best effort basis. It is possible that not all agent functionality will be available. |
When using the Oracle monitor on AIX there are some extra requirements on the platform:
Windows installation is generally very easy and performed using an MSI installer, however the user performing the installation must have full administration rights. In complex, heavily controlled and administered environments the following points should be noted:
The UNIX installation archive is named:
asagent_<VERSION>_<ARCH>.tar.gz
Make sure you have an archive that matches the platform you want to install to (although the installer will detect a mismatch an tell you).
Unpack the archive as follows:
$ tar -xof asagent_<VERSION>_<ARCH>.tar.gz
Navigate to the directory extracted and invoke the installer:
$ cd asagent_<VERSION>_<ARCH>
$ ./install.sh
Run install.sh with the --help argument to get details on all its command line options. The installer will automate the installation of MA onto a UNIX system into its default location of /opt/abilisoft.com/, unless --prefix is used.
Some recommended environment variables are printed after installation, however the --profile option can be used to automatically appended them to /etc/profile. If the profile was updated, by using --profile or manually, make sure it is effective by sourcing it or logging out and in again. Otherwise you could source the setup script in the current shell which will have the same effect:
. /opt/abilisoft.com/asagent/tools/env.sh
When not exporting these environment variables in the current shell you can still invoke the installed applications by using the full pathname to their installed binaries.
After installation an init script will be available in:
/opt/abilisoft.com/asagent/etc/init.d/abilisoft.com-asagent
This init.d script can be automatically installed to /etc/init.d/ and appropriate symbolic links created by using the --initd parameter. This will start the Agent in run-levels 3, 4 and 5 and stop it in all other run-levels.
Refer to the asagent section for details on running the agent.
The Windows installer is delivered as an MSI package named:
asagent_<VERSION>_x86-win32.msi
The MSI can be executed by double-clicking the MSI installer icon, via a management service like SMS or running it from the command line as follows:
c:\> msiexec /i asagent_<VERSION>_x86-win32.msi
Note
You can use the /quiet option for an unattended installation
There are many command line installation options, any of the agent’s runtime configuration settings can be defined during the installation procedure. Refer to MSI Command Line Options for details of MSI command line options.
Follow the installation prompts, using the defaults are recommended. The agent will be installed as a Windows service and in general a reboot will not be required.
Once installed you will need to run the agent; refer to the asagent section for details on running the agent.
Note that for installations on 64 bit Windows platforms the default agent installation directory is C:\Program Files (x86)\Abilisoft.com.
Make sure the agent is not running, i.e. execute the command:
$ asagent --stop
If the agent has been using monitoring and runtime configuration in the default location of $AS_HOME/etc then take a backup copy.
Note
It is possible to configure your agent to get runtime and monitoring configuration from a source outside the installation directory. Refer to Using Configuration Outside the Installation Directory for details.
Simply delete the directory /opt/abilisoft.com using the command:
$ rm -rf /opt/abilisoft.com
To upgrade asagent, perform the un-installation procedure followed by the installation procedure. Take care to back up any configurations before upgrading.
Open the Windows Control Panel navigate to the ‘Add/Remove Programs’ screen. Right-click Abilisoft asagent and select Un-install. The asagent service will be stopped (if running) and the software un-installed.
To upgrade asagent, perform the un-installation procedure followed by the installation procedure. Take care to back up any configurations before upgrading.
There are two key environment variables that are essential to the operation of the Agent:
This specifies the installed directory of the Agent, by default it is /opt/abilisoft.com/asagent.
On Windows it is not required to have this environment variable set since the registry key HKEY_LOCAL_MACHINE\SOFTWARE\abilisoft\mtm\as_home will be used if present. This key is automatically created during the windows installation by the MSI. The usual value for this variable on windows is C:\Program Files\Abilisoft.com\asagent.
Most UNIX systems will have an sh compatible shell available. As a quick refresher there are several ways in which you can set environment variables using an interactive shell:
$ VAR=value
Will set the variable in the current shell only, which means any process started from the shell will not have this environment variable. To make the variable available to the children of the shell it must be exported:
$ VAR=value
$ export VAR
Lastly it is also possible to set an environment variable for just one child process created by the shell, e.g. using the echo command:
$ VAR=value echo The value is: $VAR
This manual may use any of these techniques in examples, but in each case any technique which sets a variable in the environment of the agent is appropriate.
This directory contains the Agent runtime configuration file asagent.conf. This is a standard INI file format; sections are used for various groups of settings. An example is shown below:
[settings]
loglevel = DEBUG
manifest_uri = http://example.com/asagent/manifests/default.xml
This configuration mode can also be used on Windows if preferred, however configuration settings are stored in the Registry by default.
Agent log files are written here by default (although one can configure them to be written elsewhere). The current log file has a *.log extension, rolled log files have a *.log.1, *.log.2 etc extensions. The number of rolled logs can be configured.
UNIX man pages are available as well:
maql (1) command line remote asagent client
asagent.conf (5) asagent runtime configuration file
asagent (8) Abilisoft Monitoring Agent