OTOBO Installation Tutorial
This is the OTOBO Installation Manual. It serves as a reference for administrators during the installation process, as well as for migrating and updating existing OTOBO systems.
Contents
- Introduction
- Hardware and Software Requirements
- OTOBO Installation
- OTOBO Installation Docker
- OTOBO Installation on Ubuntu
- Step 1: Unpack and Install OTOBO
- Step 2: Install Additional Programs and Perl Modules
- Step 3: Create the OTOBO User
- Step 4: Activate the Default Configuration File
- Step 5: Configure systemd services for OTOBO
- Step 6: Configure the Nginx Web Server
- Step 6: Set File Permissions
- Step 7: Setup the Database
- Step 8: Setup Elasticsearch
- Step 9: Basic System Configuration
- Step 10: First Login
- Step 11: Start the OTOBO Daemon
- Step 13: Setup Bash Auto-Completion (optional)
- Step 14: Further Information
- OTOBO Installation on RHEL
- Preparation: Disable SELinux when it is Installed and Enabled
- Step 1: Unpack and Install OTOBO
- Step 2: Create the OTOBO User
- Step 3: Install Additional Programs and Perl Modules
- Step 4: Activate the Default Configuration File
- Step 5: Configure systemd Services for OTOBO
- Step 6: Configure the Nginx Web Server
- Step 7: Set File Permissions
- Step 8: Setup the Database
- Step 9: Setup Elasticsearch
- Step 10: Basic System Configuration
- Step 11: First Login
- Step 12: Start the OTOBO Daemon
- Step 13: Setup Bash Auto-Completion (optional)
- Step 14: Further Information
- Migration from OTRS 6 or OTRS 7 / ((OTRS)) Community Edition to OTOBO
- Overview over the Supported Migration Scenarios
- Migration Requirements
- Step 1: Install the new OTOBO System
- Step 2: Deactivate
SecureModeon OTOBO - Step 3: Stop the OTOBO Daemon
- Optional Step: Mount
/opt/otrsfor Convenient Access - Optional Step: Install
sshpassandrsyncwhen/opt/otrsShould be Copied via SSH - Step 4: Preparing the OTRS / ((OTRS)) Community Edition system
- Optional Step for Docker: Make Required Data Available Inside Container
- Step 5: Perform the Migration!
- Step 6: After Successful Migration!
- Known Migration Problems
- Step 7: Manual Migration Tasks and Changes
- Special Topics
- Updating
- Step 1: Stop All Relevant Services and the OTOBO Daemon
- Step 2: Backup Files and Database
- Step 3: Install the New Release
- Step 4: Check for new needed Perl modules
- Step 5: Update Installed Packages and reconfigure config
- Step 6: Only for minor or major release upgrades (for example to upgrade from 10.1 to 11.0)
- Step 7: Start your Services
- Updating a Docker-based Installation of OTOBO
- Backup and Restore
- Kerberos Single Sign On in OTOBO Docker installation
- Kerbeos Single Sign On for OTOBO Native Installation
- Kerberos SSO Setup
- Apache with Kerberos SSO and SSL
- Adapt Customer Interface with Corporate Identity
- Installing Perl Modules from CPAN
- Performance Tuning
- Documentation History
Copyright and Licensing
This work is copyrighted by OTRS AG (https://otrs.com), Zimmersmühlenweg 11, 61440 Oberursel, Germany.
Copyright © for modifications and amendments 2019-2022 ROTHER OSS GmbH (https://otobo.io), Oberwalting 31, 94339 Leiblfing, Germany
Terms and Conditions OTRS: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be found on the GNU website.
Terms and Conditions Rother OSS: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “COPYING”.
Published by: Rother OSS GmbH, (https://otobo.io), Oberwalting 31, 94339 Leiblfing, Germany.
Authors: OTRS AG (original version), Rother OSS GmbH (https://otobo.io).