IBM AIX

This page describes the steps for installing and upgrading NXLog Agent on IBM AIX.

Installing NXLog Agent

First, download the appropriate NXLog Agent installer file from the NXLog website.

Log in to your account, then click My account at the top of the page.
Under the Downloads > NXLog Agent files tab, choose the nxlog-6.5.9781_aix_ppc.rpm package.
Use SFTP or a similar secure method to transfer the archive to the target server.
Install the required NXLog Agent package.
1. Optional: To change the NXLog Agent user and group for the installation, set the NXLOG_USER and NXLOG_GROUP environment variables. During installation, a new user and group will be created from these environment variables. They will be used for the User and Group directives in nxlog.conf, and to set ownership of the /opt/nxlog directory. Specifying an already existing user or group is not supported. The created user and group will be deleted when you uninstall NXLog Agent.
  # export NXLOG_USER=nxlog2 # export NXLOG_GROUP=nxlog2
2. Use rpm to install the package.
  # rpm -ivh nxlog-6.5.9781_aix_ppc.rpm
Configure NXLog Agent by editing /opt/nxlog/etc/nxlog.conf.
See Log collection in the NXLog Platform User Guide for more information and configuration examples.
For more details about configuring NXLog Agent to collect logs on AIX, see IBM AIX log sources.

Verify the configuration file syntax.

# /opt/nxlog/bin/nxlog -v
2017-03-17 08:05:06 INFO configuration OK

Start the service using the init script in /opt/nxlog/etc:
```
# ./init start
```

Upgrading NXLog Agent

To upgrade an NXLog Agent installation to the latest release, use rpm as described in the installation instructions above. We recommend making a backup of the configuration files before starting this process.

# rpm -Uvh nxlog-6.5.9781_aix_ppc.rpm

RPM Package Manager creates a backup of the existing nxlog.conf file as nxlog.conf.rpmsave in the /opt/nxlog/etc/ directory.

The same user and group will be used for the upgrade as was used for the original installation. See installation user and group above. Changing to a different user and group during an upgrade is not supported.

Uninstalling NXLog Agent

Use rpm with the -e option to uninstall NXLog Agent.

# rpm -e nxlog

This procedure may not remove all files that were created while configuring NXLog Agent. Likewise, any files created as a result of NXLog Agent’s operations will not be removed. To find these files, examine the NXLog Agent configuration files and check the NXLog Agent installation directory (/opt/nxlog).