((OTRS)) Community Edition Documentation

Updating

Choosing the Method of Updating

There are several ways to update OTRS CE to a more recent version, depending on which version you are currently using and how it was originally installed.

If you are using OTRS CE version 6.0.37 or later:

If you are using OTRS CE prior to version 6.0.37, you need to follow the original update procedure described in the legacy documentationopen in new window.

Updating Using the OTRS CE Console

Starting with OTRS CE version 6.0.37, you can update the system by running the system update command of the OTRS CE console.

WARNING

At the moment this method of updating OTRS CE is not yet mature and should be used with caution. If you use it, please make sure that you backup your system first.

Do NOT use this method if you have packages in your system that modify the core features of OTRS CE (such as OTRS::ITSM).

NOTE

While the update is in progress, the system will be put in maintenance mode and users will not be able to access it. Any active user sessions will be stopped.

1

Download the distribution package (the .tar.gz, .tar.bz2, or .zip file) and put it on the OTRS CE machine in a directory where the otrs system user has access.

2

As the otrs system user, go to the /opt/otrs/bin directory and run the console script with the command Maint::System::Update, providing the location of the downloaded distribution package using the --file option:

su - otrs
cd /opt/otrs/bin
./otrs.Console.pl Maint::System::Update --file /path/otrs-community-edition-6.0.38.zip

3

The update program may ask you to confirm that you want to proceed. Type "Y" and press Enter.

Do you want to start the update? [Y]es/[N]o:

The update process will then begin.

4

When the update is completed, restart the HTTP server.

On Red Hat-based Linux distributions, it's usually running as the httpd service:

sudo systemctl restart httpd

On Debian-based distributions, it's usually apache2:

sudo systemctl restart apache2

Updating Using the Shell Installer

The Shell Installer of OTRS CE version 6.0.40 and later can be used to automatically update an older installation. To use this method, you need to launch the installer with an additional command line option.

WARNING

At the moment this method of updating OTRS CE is not yet mature and should be used with caution. If you use it, please make sure that you backup your system first.

Do NOT use this method if you have packages in your system that modify the core features of OTRS CE (such as OTRS::ITSM).

NOTE

While the update is in progress, the system will be put in maintenance mode and users will not be able to access it. Any active user sessions will be stopped.

1

Download the Shell Installer package for the most recent version of OTRS CE (replace 6.0.40 in the example below with the appropriate version):

curl -O https://otrscommunityedition.com/download/otrs-community-edition-6.0.40.sh

2

As the root user, execute the downloaded file with the --update option:

sudo bash otrs-community-edition-6.0.40.sh --update

Updating Using System Packages

If you installed OTRS CE with the standard package manager of your Linux distribution (e.g., apt or yum), you can update it the same way. Follow the instructions in the appropriate section for the type of packages that is used in your distribution.

Deb Packages

TBA

RPM Packages

The steps below are for Red Hat-based distributions using RPM packages (e.g., Red Hat Enterprise Linux, Fedora, CentOS Stream).

1

Download the package with the new version of OTRS CE (RPM file). Make sure to select the right file for the major version of your system (i.e., el8, el9, etc.).

2

As the root user, run the system package manager's install command with the location of the downloaded RPM file.

On systems using dnf as the standard package manager, do:

sudo dnf install otrs-ce-6.0.38-1.el8.rpm

On systems using yum as the standard package manager, do:

sudo yum install otrs-ce-6.0.38-1.el8.rpm

3

Restart the HTTP server.

sudo systemctl restart httpd
Last Updated: