NXLog User Guide

10. SUSE Linux Enterprise Server

10.1. Installing

Download the appropriate NXLog install archive from the NXLog website.

Under the Downloads › NXLog Enterprise Edition files tab, choose the correct archive for your system.

Table 17. Available SLES Files
Platform	Archive
SUSE Linux Enterprise Server 11	nxlog-4.6.4661_sles11_x86_64.tar.bz2
SUSE Linux Enterprise Server 12	nxlog-4.6.4661_sles12_x86_64.tar.bz2
SUSE Linux Enterprise Server 15	nxlog-4.6.4661_sles15_x86_64.tar.bz2

Note	The SLES 11, SLES 12 and SLES 12 archives above each contain several RPMs (see Packages in an SLES Archive below). These RPMs have dependencies on system-provided RPMs.

Use SFTP or a similar secure method to transfer the archive to the target server.

# tar xjf nxlog-4.6.4661_sles12_x86_64.tar.bz2

Table 18. Packages in an SLES Archive
Package	Description
nxlog-4.6.4661_sles12.x86_64.rpm	The main NXLog package
nxlog-dbi-4.6.4661_sles12.x86_64.rpm	Provides the im_dbi and om_dbi modules
nxlog-odbc-4.6.4661_sles12.x86_64.rpm	Provides the im_odbc and om_odbc modules
nxlog-perl-4.6.4661_sles12.x86_64.rpm	Provides the xm_perl, im_perl, and om_perl modules
nxlog-wmi-4.6.4661_sles12.x86_64.rpm	Provides the im_wmi module
nxlog-wseventing-4.6.4661_sles12.x86_64.rpm	Provides the im_wseventing module

Optional: To change the NXLog user and group for the installation, set the NXLOG_USER and NXLOG_GROUP environment variables. The specified user and group will be created, used for the User and Group directives in nxlog.conf, and used for the ownership of some directories under /opt/nxlog. Specifying an already existing user or group is not supported. The created user and group will be deleted on NXLog removal.
```
# export NXLOG_USER=nxlog2
# export NXLOG_GROUP=nxlog2
```
Install the required NXLog packages and their dependencies (this example installs the main NXLog package only).
```
# zypper install nxlog-4.6.4661_sles12.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.

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

Start the service using the service command:
```
# systemctl start nxlog.service
```

Check that the NXLog service is running with the systemctl command.

# systemctl | grep nxlog
  nxlog.service                      loaded active running   LSB: logging daemon

10.2. Upgrading

To update an NXLog installation to the latest release, use zypper as in the installation instructions above.

# zypper install nxlog-4.6.4661_sles12.x86_64.rpm

To replace a trial installation of NXLog Enterprise Edition with a licensed copy of the same version, follow the installation instructions.

Note	The same user and group will be used for the upgrade as was used for the original installation (see installation step 4 above). Changing to a different user and group during upgrade is not supported.

10.3. Uninstalling

To uninstall NXLog, use zypper remove. To remove any packages that were dependencies of NXLog but are not required by any other packages, include the --clean-deps option. Verify the operation before confirming!

# zypper remove 'nxlog*'

Note	This procedure may not remove all files that were created in order to configure NXLog, or that were created as a result of NXLog’s logging operations. To find these files, consult the configuration files that were used with NXLog and check the installation directory (`/opt/nxlog`).