Index
Contents:
About the Setup and Maintenance Guide
Introduction
Legend
Installation Guide
Step 1: Check and install the technical requirements
Step 2: Download the iObeya on-prem package
Step 3: Extract and configure the webapp
1 Configure application logs
2 Configure the database connection
3 Create the folder structure on the application server
4 Configure the web application
Step 4: Database initialization
Liquibase directory structure
Liquibase configuration
Initialize the database
MySQL: Initializing the database with default settings
MySQL: Initializing the database with custom settings
MariaDB: Initializing the database with default settings
MariaDB: Initializing the database with custom settings
Oracle: Initializing the database with default settings
Oracle: Initializing the database with custom settings
Step 5: Application server configuration
1 Upload the iObeya installation directory
2 Deploy the iObeya webapp
Tomcat directory
iObeya webapp directory
Step 6: Final steps
1 Installing fonts
Install fonts on Windows
Install fonts on Linux
2 Increase server memory allocation
Increase server memory allocation on Windows
Increase server memory allocation on Linux
3 Start Tomcat
Set the iObeya license
Access to the application
Step 7: Optional configurations
Configure Tomcat to run on a different port (Optional)
Configure Tomcat to run as a service (Optional)
Configure Tomcat to run as a Windows service
Configure Tomcat to run as a Linux service
Running iObeya over HTTPS (Optional)
Upgrade Guide
Upgrade path
Getting started
Step 1: Prepare your environment
Step 2: Backing up your environment
Step 3: Practicing on a test environment
Step 4: Downloading the iObeya on-premise package
Step 5: Extract and configure the webapp
1 Configure application logs
2 Configure the database connection
3 Configuring the web application
Step 6: Database upgrade
Liquibase directory structure
Liquibase configuration
Prepare your database for Liquibase
MySQL: Prepare your database for Liquibase
MariaDB: Prepare your database for Liquibase
Oracle: Prepare your database for Liquibase
Upgrading the iObeya database schema
MySQL: Upgrading the iObeya database schema
MariaDB: Upgrading the iObeya database schema
Oracle: Upgrading the iObeya database schema
Step 7: Upgrade the web application
Step 8: Final steps
Add-ons
Installing an add-on
Updating an add-on
Backup and restore
Backup your iObeya data
STEP 1. Prerequisites
STEP 2. Backup your settings
Backup your context file
Backup your Log4j2 configuration file
Backup your add-ons configuration
STEP 3. Backup your assets
STEP 4. Backup your database
Backup your MySQL 8.0 database
Backup your MariaDB database
Backup your Oracle database
Restore your iObeya data
STEP 1. Prerequisites
STEP 2. Restore your settings
Restore your context file
Restore your Log4j2 configuration file
Restore your add-ons configuration
STEP 3. Restore your assets
STEP 4. Restore your database
Liquibase directory structure
Liquibase configuration
Restore your database on MySQL
Restore your database on MariaDB
Restore your Oracle database
Components used in the application
Java
Administration HTML
Javascript
Enable notifications from iObeya Mobile Application
Introduction
Setup the Firebase key file
Firewall configuration
Advanced webapp configuration
Setup and maintenance
Index