Oracle Solaris

This page describes the steps for installing and upgrading NXLog Agent on Oracle Solaris.

Installing NXLog Agent

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

  1. Log in to your account, then click My account at the top of the page.

  2. Under the Downloads > NXLog Agent files tab, choose the correct file for your system.

    Table 1. Available NXLog Agent Solaris files
    Platform Archive

    Solaris 10/11 x86 archive

    nxlog-6.2.9212_solaris_x86.pkg.gz

    Solaris 10/11 SPARC archive

    nxlog-6.2.9212_solaris_sparc.pkg.gz

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

  4. Log in to the target server and extract the contents of the archive.

    $ gunzip nxlog-6.2.9212_solaris_sparc.pkg.gz
  5. Optional: To change the NXLog Agent user and group for the installation, create a /var/sadm/install/admin/nxlog-user_group file with the following command. 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.

    $ echo 'nxlog2:nxlog2' > /var/sadm/install/admin/nxlog-user_group
  6. Install NXLog Agent.

    • For interactive installation, execute the following command and answer y (yes) to the questions.

      $ sudo pkgadd -d nxlog-6.2.9212.pkg NXnxlog
    • For a quiet install, use an administration file. Place the file (nxlog-adm in this example) in the /var/sadm/install/admin/ directory.

      $ sudo pkgadd -n -a nxlog-adm -d nxlog-6.2.9212.pkg NXnxlog
      nxlog-adm
      mail=
      instance=overwrite
      partial=nocheck
      runlevel=nocheck
      idepend=nocheck
      rdepend=nocheck
      space=quit
      setuid=nocheck
      conflict=nocheck
      install
      action=nocheck
      basedir=/opt/nxlog
      networktimeout=60
      networkretries=3
      authentication=quit
      keystore=/var/sadm/security
      proxy=
  7. 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.

  8. Verify the configuration file syntax.

    $ sudo /opt/nxlog/bin/nxlog -v
    2024-01-12 08:05:06 INFO configuration OK
  9. Check that the NXLog Agent service is running with the svcs command.

    $ svcs nxlog
     online     12:40:37 svc:system/nxlog:default
  10. Manage the NXLog Agent service with svcadm. You must restart the service to load the new configuration.

    $ sudo svcadm restart nxlog
    $ sudo svcadm enable nxlog
    $ sudo svcadm disable nxlog
To replace a trial installation of NXLog Agent with a licensed copy of the same version, follow the installation instructions above and use instance=overwrite.

Upgrading NXLog Agent

To update an NXLog Agent installation to the latest version, remove the old version and then install the new one.

  1. Before removing the old version, run the backup script from /opt/nxlog/bin/backup. The backup script creates a backup directory in /opt using the format /opt/nxlog-backup-YYYYMMDD_hhmmss.

    $ sudo bash /opt/nxlog/bin/backup
  2. Uninstall NXLog Agent using pkgrm as described in the uninstallation instructions below.

    $ sudo pkgrm NXnxlog
  3. Install the new NXLog Agent version using pkgadd as described in the installation instructions above.

    $ sudo pkgadd -d nxlog-6.2.9212.pkg NXnxlog
  4. After reinstalling NXLog Agent, use the restore script from the latest backup directory to restore the data to the new NXLog Agent installation.

    $ sudo bash /opt/nxlog-backup-20180101_000001/restore
  5. Optional: To discard the backup files, delete the backup directory.

    $ sudo rm -rf /opt/nxlog-backup-20180101_000001

Uninstalling NXLog Agent

Use pkgrm to uninstall NXLog Agent. To remove the package files from the client’s file system, use the -A option.

$ sudo pkgrm NXnxlog
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).