Offline Installs and Upgrades
Overview
This documentation provides instructions for installing or upgrading LogZilla in an offline environment. You can perform these actions by downloading a pre-built package from any system with internet access, such as a local laptop, and then manually transferring it to the offline LogZilla server.
Prerequisites
- A system with internet access to download the LogZilla offline package.
- The offline LogZilla server where the installation or upgrade will occur.
- Root access on the logzilla server
Downloading the LogZilla Offline Package
On any system with internet access:
-
Download the Offline Package:
Download the pre-built LogZilla package from:
https://license.logzilla.net/logzilla-offline.tgz
-
Transfer the Package:
Manually transfer the
logzilla-offline.tgz
package to your offline LogZilla server using a USB drive, SCP, RSYNC, or any other file transfer method.
Installation on the Offline LogZilla Server
All commands in the sections below must be run as the root user.
New Installation
IMPORTANT: This method is ONLY for new installs, for upgrades, refer to the Upgrade Procedure section below.
For new installations on the offline server:
-
Extract the LogZilla Package:
-
Run the Installation Script:
Navigate to the directory where you extracted the files and run:
-
License Retrieval and Startup:
After installation, follow the on-screen instructions to retrieve the license and start LogZilla.
Upgrade Procedure
For upgrading an existing installation:
-
Extract the LogZilla Package:
-
Run the Upgrade Command:
From the directory where you extracted the files, execute:
Ensure that the path provided to
--offline-dir
is correct. -
Verify the Upgrade:
After the upgrade, check the new version:
This should display the upgraded version number.
Example Walkthrough
Performing an Offline Upgrade
-
Download and Transfer the Package:
- Download
logzilla-offline.tgz
fromhttps://license.logzilla.net/logzilla-offline.tgz
. - Transfer the file to the offline LogZilla server.
- Download
-
Check currently installed version:
root@logzilla-server:/tmp$ logzilla version v6.28.0
-
Verify Internet Access Unreachable:
This step is not necessary, it is here to show that the system we ran the upgrade on does not have internet access.
root@logzilla-server:~$ ping 8.8.8.8 ping: connect: Network is unreachable
-
Extract the offline package:
root@logzilla-server:~$ cd /tmp root@logzilla-server:/tmp$ tar xzvf logzilla-offline.tgz logzilla-offline/ logzilla-offline/kickstart.sh logzilla-offline/logzilla-front:v6.30.0.tar.gz logzilla-offline/library-postgres:15.2-alpine.tar.gz logzilla-offline/logzilla-sec:v6.30.0.tar.gz logzilla-offline/logzilla-runtime:v6.30.0.tar.gz logzilla-offline/logzilla-etcd:v3.5.7.tar.gz logzilla-offline/library-redis:6.2.6-alpine.tar.gz logzilla-offline/manifest logzilla-offline/logzilla-syslogng:v6.30.0.tar.gz logzilla-offline/logzilla-mailer:v6.30.0.tar.gz logzilla-offline/library-influxdb:1.8.10-alpine.tar.gz logzilla-offline/library-telegraf:1.20.4-alpine.tar.gz
-
Begin the upgrade procedure:
root@logzilla-server [tmp]:# logzilla upgrade --offline-dir logzilla-offline lz.manager INFO Loading /tmp/logzilla-offline/library-influxdb:1.8.10-alpine.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/library-postgres:15.2-alpine.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/library-redis:6.2.6-alpine.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/library-telegraf:1.20.4-alpine.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/logzilla-etcd:v3.5.7.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/logzilla-front:v6.30.0.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/logzilla-mailer:v6.30.0.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/logzilla-runtime:v6.30.0.tar.gz ... lz.manager INFO Assuming version v6.30.0 lz.manager INFO Loading /tmp/logzilla-offline/logzilla-sec:v6.30.0.tar.gz ... lz.manager INFO Loading /tmp/logzilla-offline/logzilla-syslogng:v6.30.0.tar.gz ... Starting LogZilla upgrade to 'v6.30.0' lz.setup INFO Setup init lz.docker INFO Decommission: queryupdatemodule, front lz.docker INFO Decommission: httpreceiver, celerybeat, queryeventsmodule-1 lz.docker INFO Decommission: triggersactionmodule, gunicorn, aggregatesmodule-1, dictionarymodule, parsermodule, celeryworker lz.docker INFO Decommission: storagemodule-1 lz.docker INFO Decommission: logcollector, telegraf, tornado, mailer lz.docker INFO Decommission: syslog lz.docker INFO Decommission: postgres lz.docker INFO Decommission: redis, influxdb lz.docker INFO Decommission: etcd lz.docker INFO Start: etcd lz.docker INFO Start: influxdb, redis lz.docker INFO Start: postgres lz.containers.postgres INFO Running postgres v15 migration ... lz.containers.postgres INFO Postgres v15 migration finished successfully Operations to perform: Apply all migrations: admin, api, auth, contenttypes, django_celery_beat, sessions Running migrations: No migrations to apply. lz.setup INFO Update group permissions lz.setup INFO Update internal triggers lz.docker INFO Start: syslog lz.docker INFO Start: logcollector, tornado, telegraf, mailer lz.docker INFO Start: storagemodule-1 lz.docker INFO Start: triggersactionmodule, celeryworker, dictionarymodule, aggregatesmodule-1, gunicorn, parsermodule lz.docker INFO Start: celerybeat, httpreceiver, queryeventsmodule-1 lz.docker INFO Start: queryupdatemodule, front lz.docker INFO Start: watcher LogZilla successfully upgraded to 'v6.30.0'
-
Verify that the new version is running:
root@logzilla-server [tmp]:# logzilla version v6.30.0