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 Configure Tomcat memory and classpath settings
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)
iObeya monitoring using JMX (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
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
Configure Tomcat memory and classpath settings
Restart iObeya
Monitoring iObeya using JMX
Overview
Enabling JMX on Tomcat
Monitoring with JConsole
JMX Attributes
Global Attributes
Screenshot Attributes
iObeya Events
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
Advanced webapp configuration
Setup and maintenance
Index