General

At its basic format, XPLG installs as a single process. This process includes everything that is needed to run and use XPLG.
The system scales easily by running multiple processes that supports high daily volumes and data retention. See XPLG Architecture for more information.

This topic includes installation instructions for the following operating systems:

• Windows

• Linux

• Mac OS X

• Generic - Any JAVA supported OS (JAVA should be provided externally)

Downloading the XPLG Software

1. Navigate to the XPLG site http://www.xplg.com and go to the Download Center

2. On the XPLG download page, click the link or button for the product that you want to download.

3. When you are done, click the Download link or the Download Now button.
   Note: Be sure to click the Download Now button for the product you want to install.

4. Do one of the following:

• If the software is downloaded automatically into a default folder, you see a download progress dialog box. Make a note of the directory (folder) and filename for the software that you are downloading.

• If a "Save As" dialog box appears, choose a folder and filename for the software that you are downloading.

Installing XPLG Software

Installing on Windows Server OS

1. After downloading is complete, you may see a "Download successful" dialog box.

2. Open the folder into which the new software was downloaded, copy it to the target machine, and double-click the file that you downloaded. For instance, if you downloaded XPLG, double click the “exe” file. Depending on what you are installing, you may see the Install Anywhere dialog box.

3. When the XPLG Setup Welcome screen appears, read the information and click Next.
   Note: Read the instructions on the following screens. The screens vary depending on what you are installing, but in general you are asked to do some or all of the instructions in the following steps.

4. Choose a destination directory (folder). This is the location where the new software will be installed, normally C:\Program Files\XpoLogCenter. If you install your new software into the XPLG folder that contains your current version of the software, your current version will be overwritten. If you wish to keep a copy of the old version as a backup, simply choose or create a new folder for the software that you are about to install.

5. Choose a name for the program group; the default is XpoLog. Then, click Next.

6. Verify all the details in the preview screen and click Install.
   Note: if you want to edit any of the details that are presented in the preview screen, click Previous to return to the desired location.

7. When you see the prompt telling you that installation is complete, click Done. 
   XPLG starts automatically unless you specified differently during the installation.

Installing on Linux OS

1. After downloading is complete, you may see a "Download successful" dialog box. If you see this dialog box, copy the installation file to your Linux machine.

2. Due to permissions you may have copied the file to the /tmp directory on the linux host. Change the permissions on the file using chmod to an appropriate user and group.

3. Create a user and group the software will install and run as. You may need to do this via your enterprise standard process if integrations are centralised to solutions such as LDAP / AD.

4. Create a target install folder inline with your enterprise standards and ensure that folder has the permissions for the user and group the software will be in stalled and run as

5. Open the folder that the new software was downloaded into on the linux host and copy the file to the target install directory

6. Change the owner and group of the file to the user group you wish to install and run the software as

7. Switch to the target user the software should install as to ensure correct permissions are retained

8. gunzip the file that you downloaded:

9. After unzipping the file, execute the .bin file to start the install wizzard

10. When the following XpoLog Setup message appears, read the information and follow the installation process.

11. Read the instructions on each step.

12. Confirm the install summary

13. When you see the prompt telling you that installation is complete and you will see the installed directories and files

14.  XPLG will be started automatically unless you specified differently.

Installing on Mac OS X

1. After downloading is complete, you may see a "Download successful" dialog box. If you see this dialog box, click Install and go on to step 3. Otherwise, continue with step 2.

2. (Skip this step if installation has already started.) Open the folder that the new software was downloaded into, copy it to the target machine, and unzip the file that you downloaded. For instance, if you downloaded XPLG , unzip the downloaded file (unzip XpoLogCenterSetup.zip).

3. After unzipping the file, ensure there are sufficient permissions to run the file:

   1. Open a terminal and cd to the location where you extracted the file

   2. Run: sudo chmod -R 755 XpoLogCenterSetup.app/

4. execute the installer - Right Click the XpoLogCenterSetup and select Open.
   The installation wizard will start.

5. When the XPLG Setup message appears, read the information and follow the installation process.

6. Read the instructions on each step.

7. When you see the prompt telling you that installation is complete, XPLG will be started automatically.

Installing on UNIX without bundles JVM

This XPLG Installer does not contain JAVA and uses an external JAVA which should already be available on the machine that you plan to run XpoLog on. Important: JAVA 17 is required.

1. On the XPLG download page, click the link or button for the product that you want to download (without internal JVM).

2. Check the target machine you are installing XPLG on to ensure JAVA is available. Run the command

3. If installation has already started jump to step 5.

4. Open the folder that the new software was downloaded into, copy it to the target machine, and gunzip the file that you downloaded. For instance, if you downloaded XPLG, gunzip the downloaded file

3. Execute the command to start the wizzard;

Note: As you have chosen the installer without Java built in the wizard looks for a local JAVA to be used using the JAVA_HOME environment variable. It is possible to specify the full JAVA path that should be used by executing the installation with a specified JAVA full path

4. When the XpoLog Setup message appears, read the information and follow the installation process.

5. Read the instructions on each step.

6. When you see the prompt telling you that installation is complete, XpoLog will be started automatically, unless you specified otherwise during installation.

Installing as a System Service

Windows Service

There is a single process - XpoLogCenter, which is presented in the Windows Services panel. It is highly recommended to configure a user on the XpoLogCenter service, which XpoLog can use while reading logs from machines in the environment.

To run your new software:

1. Recommended: In the Windows Services panel, under the log on tab, type a username that XPLG service can use in order to connect and read logs over the Windows network authentication in your organization.

Linux Daemon

It is recommended to set up the xplg service as a system service inline with your enterprise standards.

MacOS Daemon

It is recommended to set up the xplg service as a system service inline with your enterprise standards.

Starting and Stopping XpolgCentre

XPLG starts automatically after installation unless you specified differently. There are several useful commands for starting, stopping, restarting, or finding out the status of the server:

1. cd to the installation directory of XPLG

2. XPLG should start automatically after installation. To control and verify, use these commands:

Starting XpologCentre

Stopping XpogLogCentre

Check XpologCentre Status

3. Open a browser with the following URL: http://MACHINE_NAME:30443
   You will be redirected to the XPLG homepage. 

Support