Skip to content

Manual Install/Upgrade

For installation or upgrades, you may use an internet-connected system to manually pull all LogZilla containers and package them up for use in an offline system using the logzilla download command, then copy the files to the offline system.

Prerequisites

A source server with internet access must be used to obtain the images which may then be manually copied to the secure destination server. To install LogZilla on an internet-connected host, follow the instructions on our website. If you are unable to bring up a LogZilla server with internet access, please let us know and we will provide the images for you to download.

Environment

For this walk-through, we are using two servers named:

  • logzilla-online-source [192.168.1.1]
  • logzilla-offline-dest [192.168.1.2]

logzilla-online-source

The logzilla-online-source should already have the latest version of LogZilla installed by using the instructions on our website.

logzilla-offline-dest

The logzilla-offline-dest is the server where LogZilla will be installed or upgraded without direct internet access.

Steps for Source and Destination Commands

Source

The source server is responsible for updating LogZilla, downloading the required containers, packaging them, and transferring them to the destination server.

1 . Update LogZilla

Ensure the source server has the latest version of LogZilla installed by running logzilla upgrade

2. Download LogZilla Containers

Use the logzilla download command to download the necessary containers for LogZilla into an existing directory named lz-offline:

mkdir lz-offline
logzilla download lz-offline

3. Package LogZilla Containers

Package the downloaded containers into a TGZ file:

tar czvf lz-offline.tgz lz-offline/

4. Transfer LogZilla Package

Copy the package to the destination server using SCP, RSYNC, or another transfer method:

scp, if available
scp lz-offline.tgz [email protected]:/tmp
rsync, if available
rsync -zavh --progress lz-offline/ 192.168.1.2:/tmp/lz-offline/

Destination

The destination server is responsible for receiving the LogZilla package, extracting the contents, and performing either a new installation or an upgrade.

New Installation Procedure

DO NOT use this method if you are upgrading an existing installation, see instructions for offline upgrade

For new installations, extract the contents of the LogZilla TGZ file and run the bash kickstart.sh command:

tar xzvf lz-offline.tgz
bash lz-offline/kickstart.sh
License Retrieval and LogZilla Startup

After the offline installation completes, you will see a message similar to the one below:

To manually retrieve the license you must:
* enter the URL:
  https://license.logzilla.net/keys/a15f260215fac0953b0ca11669d8e5cdf52c26bc3b9c7bc879313efadcef5a89?public_md5=831523407a004af9506e2b3f5f6ce073&issue_demo=1
* paste the contents of that URL into a file with any name such as lic.json
* load license:
  logzilla license load lic.json
* start LogZilla:
  logzilla start

Cannot start LogZilla without a valid license
Installation completed
  1. Visit the URL provided in the terminal output. It should be similar to the following:

NOTE: replace a15f260215fac0953b0ca11669d8e5cdf52c26bc3b9c7bc879313efadcef5a89?public_md5=831523407a004af9506e2b3f5f6ce073&issue_demo=1 with your actual information provided during the installation procedure.

https://license.logzilla.net/keys/a15f260215fac0953b0ca11669d8e5cdf52c26bc3b9c7bc879313efadcef5a89?public_md5=831523407a004af9506e2b3f5f6ce073&issue_demo=1

  1. Copy the contents of the URL and save it to a file with any name, such as lic.json.

  2. Load the license on the offline server using the following command:

logzilla license load lic.json
  1. Start LogZilla:
logzilla start

Upgrade Procedure

DO NOT use this method if this is a new install, see instructions for new install

For upgrades, extract the contents of the LogZilla TGZ file and run the logzilla upgrade command:

tar xzvf lz-offline.tgz
logzilla upgrade --offline-dir lz-offline