Oracle Linux

This section describes the steps for installing and upgrading NXLog on Oracle Linux.

Installing NXLog

First, download the appropriate NXLog installation file from the NXLog website.

Log in to your account, then click My account at the top of the page.
Under the Downloads > NXLog Enterprise Edition files tab, download the correct file for the target platform.

Table 1. Available Oracle Linux NXLog files

Platform Archive

Oracle Linux 8

nxlog-6.9.10227_oracle8_x86_64.tar.bz2

Oracle Linux 9

nxlog-6.9.10227_oracle9_x86_64.tar.bz2

The Oracle Linux 8 and Oracle Linux 9 archives above each contain several RPMs (see NXLog packages in an Oracle Linux archive below). These RPMs have dependencies on system-provided RPMs.
Transfer the file to the target server using SFTP or a similar secure method.

Table 1. Available Oracle Linux NXLog files
Platform	Archive
Oracle Linux 8	nxlog-6.9.10227_oracle8_x86_64.tar.bz2
Oracle Linux 9	nxlog-6.9.10227_oracle9_x86_64.tar.bz2

$ tar -xvf nxlog-6.9.10227_oracle9_x86_64.tar.bz2

Table 2. NXLog packages in an Oracle Linux archive
Package	Description
nxlog-6.9.10227_oracle9.x86_64.rpm	The main NXLog package
nxlog-checkpoint-6.9.10227_oracle9.x86_64.rpm	Provides the im_checkpoint module
nxlog-dbi-6.9.10227_oracle9.x86_64.rpm (available for RHEL 6 and RHEL 7 only)	Provides the im_dbi and om_dbi modules
nxlog-java-6.9.10227_oracle9.x86_64.rpm	Provides the xm_java, im_java, and om_java modules
nxlog-kafka-6.9.10227_oracle9.x86_64.rpm	Provides the im_kafka and om_kafka modules
nxlog-odbc-6.9.10227_oracle9.x86_64.rpm	Provides the im_odbc and om_odbc modules
nxlog-pcap-6.9.10227_oracle9.x86_64.rpm	Provides the im_pcap module
nxlog-perl-6.9.10227_oracle9.x86_64.rpm	Provides the xm_perl, im_perl, and om_perl modules
nxlog-python-6.9.10227_oracle9.x86_64.rpm	Provides the xm_python, im_python, and om_python modules
nxlog-ruby-6.9.10227_oracle9.x86_64.rpm	Provides the xm_ruby, im_ruby, and om_ruby modules
nxlog-systemd-6.9.10227_oracle9.x86_64.rpm	Provides the im_systemd module
nxlog-wseventing-6.9.10227_oracle9.x86_64.rpm	Provides the im_wseventing module
nxlog-zmq-6.9.10227_oracle9.x86_64.rpm	Provides the im_zmq and om_zmq modules

Optional: To change the NXLog user and group for the installation, set the NXLOG_USER and NXLOG_GROUP environment variables. During installation, a new user and a new group will be created based on these environment variables. They will be used for User and Group directives in nxlog.conf, and for the ownership of some directories under /opt/nxlog.
- If the user or group already exists, the installation issues a warning and continues.
- If the user or group creation fails, the installation returns an error and stops.
- The created user and group will be deleted when you uninstall NXLog.
- If the user or group deletion fails, the uninstall issues a warning and continues.
```
$ export NXLOG_USER=nxlog2
$ export NXLOG_GROUP=nxlog2
```
Download the public key file from the NXLog’s public contrib repository and import it to the RPM database.
```
$ sudo rpm --import nxlog-pubkey.asc
```
For more details about the package verification, see the Signature Verification for RPM Packages section in the User Guide.
If you are installing the nxlog-zmq package, enable the EPEL repository so ZeroMQ dependencies will be available:
```
$ sudo yum install -y epel-release
```
Use yum to install the required NXLog packages (or the generic package) and dependencies.
```
$ sudo -E yum install nxlog-6.9.10227_oracle9.x86_64.rpm
```
Configure NXLog by editing /opt/nxlog/etc/nxlog.conf. General information about configuring NXLog can be found in Configuration. For more details about configuring NXLog to collect logs on Linux, see the GNU/Linux summary.

Verify the configuration file syntax.

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

Start the service using the service command:
```
$ sudo service nxlog start
```

Check that the NXLog service is running.

$ sudo service nxlog status
nxlog (pid  9218) is running...

Upgrading NXLog

To upgrade an NXLog installation to the latest release, or to replace a trial installation of NXLog Enterprise Edition with a licensed copy, use yum as in the installation instructions above. It is recommended to make a backup of the configuration files before starting this process.

$ sudo yum install nxlog-6.9.10227_oracle9.x86_64.rpm

The same procedure is used to upgrade from NXLog Community Edition to NXLog Enterprise Edition. However, in such a case, you will need to manually copy the previous configuration to the new installation.

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

To uninstall NXLog, use yum remove. To remove any packages that were dependencies of NXLog but are not required by any other packages, include the --setopt=clean_requirements_on_remove=1 option. Verify the operation before confirming.

$ sudo yum remove 'nxlog-*'

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