1 System Requirements

See System Requirements in Backlog Enterprise Installation Guide.

If you are giving a host name to the server, please set its host name to /etc/hosts.
Example setting when host name is <host name>: 127.0.0.1 <host name> localhost.localdomain localhost

2 Java font settings

See Java font settings in Backlog Enterprise Installation Guide.
(In the case of updating, it is normally set up already)

3 Installing additional packages

See Installing additional packages inBacklog Enterprise Installation Guide.

4 Updating

To update Backlog, follow the steps below.

  • Download the Backlog package (RPM file).
  • Download the database driver. (Only when using MySQL)
  • Stop the current Backlog.
  • Update and install Backlog with RPM command.
  • Launch the updater and answer questions to proceed.
  • Start Backlog.

4.1 Downloading Backlog Enterprise

Access the download link on the Backlog website below.
https://backlog.com/enterprise/download

There are four RPM files to download.

  • backlog-app-1.11.10-01.el7.noarch.rpm
  • backlog-www-1.11.10-01.el7.x86_64.rpm
  • backlog-git-1.11.6-01.el7.x86_64.rpm
  • backlog-api-1.11.10-01.el7.noarch.rpm

4.2 Downloading the database driver (for MySQL only)

If you are using MySQL as the database, you need to download the database driver. Download the latest version of "Platform Independent (Architecture Independent), Compressed TAR Archive" from the download site (below) and decompress it.

Please make sure you are using version 5.1, as Backlog is not compatible with version 8.

http://dev.mysql.com/downloads/connector/j/

Please extract the file, then copy "mysql-connector-java-5.1.X-bin.jar" to the directory where you downloaded the Backlog package.

  • Example (when updating with /tmp/backlog)
# tar zxfv mysql-connector-java-5.1.42.tar.gz # cp mysql-connector-java-5.1.42/mysql-connector-java-5.1.42-bin.jar /tmp/backlog/

4.3 Stopping Backlog

Execute the following command to stop Backlog.

# systemctl stop backlog.target

4.4 Update installation of Backlog

Execute the following command to update and install.

# rpm -Uvh backlog-app-1.11.10-01.el7.noarch.rpm # rpm -Uvh backlog-www-1.11.10-01.el7.x86_64.rpm # rpm -Uvh backlog-git-1.11.6-01.el7.x86_64.rpm # rpm -Uvh backlog-api-1.11.10-01.el7.noarch.rpm

NOTE: If you have modified files that are managed by Backlog, rpmnew files may be created as follows when updating installation. /opt/backlog/scripts/env files are updated automatically at the subsequent updater startup, so please do not manually correct them. As for the other files, while assuming the rpmnew file, please manually reflect the contents corrected in the existing file after updater execution.

# 2:backlog-www Warning: /opt/backlog/httpd/conf/ssl.conf was created as /opt/backlog/httpd/conf/ssl.conf.rpmnew 

4.5 Starting up updater

Update the Backlog application using the updater enclosed in the Backlog package (RPM file). Execute the following command to start the updater.

* Be sure to back up data areas and databases beforehand *

# /opt/backlog/bin/update.sh
Running the update will change the web application and database. Please check if Backlog is stopped and the database is backed up. Are you ready to update? ( y<Yes> / n<No> )

If there is no problem, please enter "y" and press the Enter key to start the update process.

====================================================================== Backlog Enterprise updater ____ _ _ | _ \ | | | | | |_) | __ _ ___| | _| | ___ __ _ | _ < / _` |/ __| |/ / |/ _ \ / _` | | |_) | (_| | (__| <| | (_) | (_| | |____/ \__,_|\___|_|\_\_|\___/ \__, | __/ | |___/ [https://backlog.com/] ====================================================================== Starting to update Backlog. Updating with the following settings. Backlog URL [http://192.168.0.87:8969] SMTP server host [localhost] Database [PostgreSQL] Server host [localhost] Port number [5432] User [backlog] Password [backlog] Is this OK? ( y<Continue> / n<Quit> )
  • Backlog's settings have been confirmed; the update will begin when you select "y<Continue>".
  • If you select "n<Quit>", the update will be aborted.

4.5.1 Altering table

If needed, you can alter the database in this update.

If you are using MySQL on the database, select JDBC driver.

Please select JDBC driver to use. 1:mysql-connector-java-5.1.42.jar

Display mysql-connector-java-XXX.jar placed in the current directory as the selection target.

After database connection verification is done, alter table.

Start altering table End Altering table has been completed. End The update was successfully completed. Continue to use Backlog.

A completion message is displayed, and Backlog update is completed.

5 Starting Backlog

Backlog will start with the following command.

# systemctl start backlog.target

When you start Backlog for the first time, depending on the environment it may take time to access while the search index is rebuilt.

6 After completing update

Please check the operation guide for more information.

  • Linux is a registered trademark or trademark of Mr. Linus Torvalds in Japan and other countries.
  • Red Hat is a registered trademark or trademark of Red Hat, Inc. in the United States and other countries.
  • MySQL and Java are registered trademarks of Oracle Corporation and its subsidiaries and affiliates in the United States and other countries. Company names, product names, etc. in the text may be trademarks or registered trademarks of each company.
  • Other company names and product names mentioned are registered trademarks or trademarks of each company.

Author: Backlog Support <support@backlog.com>

Revision History

2022-07-13

  • The names of RPM files have been changed to backlog-app-1.11.10-01.el7.noarch.rpm for releasing version 1.11.10.
  • The names of RPM files have been changed to backlog-api-1.11.10-01.el7.noarch.rpm for releasing version 1.11.10.
  • The names of RPM files have been changed to backlog-www-1.11.10-01.el7.x86_64.rpm for releasing version 1.11.10.

2022-04-15

  • The names of RPM files have been changed to backlog-app-1.11.9-01.el7.noarch.rpm for releasing version 1.11.9.
  • The names of RPM files have been changed to backlog-www-1.11.9-01.el7.x86_64.rpm for releasing version 1.11.9.

2022-02-24

  • The names of RPM files have been changed to backlog-app-1.11.8-01.el7.noarch.rpm for releasing version 1.11.8.
  • The names of RPM files have been changed to backlog-api-1.11.8-01.el7.noarch.rpm for releasing version 1.11.8.

2021-12-21

  • The names of RPM files have been changed to backlog-app-1.11.7-01.el7.noarch.rpm for releasing version 1.11.7.
  • The names of RPM files have been changed to backlog-api-1.11.7-01.el7.noarch.rpm for releasing version 1.11.7.

2021-12-14

  • The names of RPM files have been changed to backlog-app-1.11.6-01.el7.noarch.rpm for releasing version 1.11.6.
  • The names of RPM files have been changed to backlog-git-1.11.6-01.el7.x86_64.rpm for releasing version 1.11.6.
  • The names of RPM files have been changed to backlog-api-1.11.6-01.el7.noarch.rpm for releasing version 1.11.6.

2021-10-12

  • The names of RPM files have been changed to backlog-app-1.11.5-01.el7.noarch.rpm for releasing version 1.11.5.
  • The names of RPM files have been changed to backlog-www-1.11.5-01.el7.x86_64.rpm for releasing version 1.11.5.

2021-09-30

  • The names of RPM files have been changed to backlog-app-1.11.4-01.el7.noarch.rpm for releasing version 1.11.4.
  • The names of RPM files have been changed to backlog-www-1.11.4-01.el7.x86_64.rpm for releasing version 1.11.4.

2021-07-29

  • The names of RPM files have been changed to backlog-app-1.11.3-01.el7.noarch.rpm for releasing version 1.11.3.
  • The names of RPM files have been changed to backlog-api-1.11.3-01.el7.noarch.rpm for releasing version 1.11.3.

2021-03-05

  • The names of RPM files have been changed to backlog-app-1.11.2-01.el7.noarch.rpm for releasing version 1.11.2.

2021-01-29

  • Removed descriptions about Red Hat Enterprise Linux (RHEL) 6 and CentOS 6 for end of support. If your Backlog is running on RHEL 6 or CentOS 6, .
  • The names of RPM files have been changed to backlog-app-1.11.1-01.el7.noarch.rpm for releasing version 1.11.1.
  • The names of RPM files have been changed to backlog-api-1.11.1-01.el7.noarch.rpm for releasing version 1.11.1.
  • The names of RPM files have been changed to backlog-www-1.11.1-01.el7.x86_64.rpm for releasing version 1.11.1.
  • The names of RPM files have been changed to backlog-git-1.11.1-01.el7.x86_64.rpm for releasing version 1.11.1.

2020-10-09

  • The names of RPM files have been changed to backlog-app-1.11.0-01.el6.noarch.rpm and backlog-app-1.11.0-01.el7.noarch.rpm for releasing version 1.11.0.
  • The names of RPM files have been changed to backlog-api-1.11.0-01.el6.noarch.rpm and backlog-api-1.11.0-01.el7.noarch.rpm for releasing version 1.11.0.
  • The names of RPM files have been changed to backlog-www-1.11.0-01.el6.i386.rpm, backlog-www-1.11.0-01.el6.x86_64.rpm and backlog-www-1.11.0-01.el7.x86_64.rpm for releasing version 1.11.0.
  • The names of RPM files have been changed to backlog-git-1.11.0-01.el6.i386.rpm, backlog-git-1.11.0-01.el6.x86_64.rpm and backlog-git-1.11.0-01.el7.x86_64.rpm for releasing version 1.11.0.

2020-06-22

  • The names of RPM files have been changed to backlog-app-1.10.14-01.el6.noarch.rpm and backlog-app-1.10.14-01.el7.noarch.rpm for releasing version 1.10.14.
  • The names of RPM files have been changed to backlog-api-1.10.14-01.el6.noarch.rpm and backlog-api-1.10.14-01.el7.noarch.rpm for releasing version 1.10.14.
  • The names of RPM files have been changed to backlog-www-1.10.14-01.el6.i386.rpm, backlog-www-1.10.14-01.el6.x86_64.rpm and backlog-www-1.10.14-01.el7.x86_64.rpm for releasing version 1.10.14.
  • The names of RPM files have been changed to backlog-git-1.10.14-01.el6.i386.rpm, backlog-git-1.10.14-01.el6.x86_64.rpm and backlog-git-1.10.14-01.el7.x86_64.rpm for releasing version 1.10.14.