Install OpenProject Management Software on RHEL 8 - CentLinux

Latest

Sunday, 25 April 2021

Install OpenProject Management Software on RHEL 8

Install OpenProject Management Software on RHEL 8

OpenProject is a free, open-source web based project management software. In this guide, you will learn how to install it on Red Hat Linux 8.

 

Table of Contents:

     

    What is OpenProject? :

    OpenProject is a web-based project management system for location-independent team collaboration. This free open-source application is released under the GNU General Public License Version 3 (GPLv3) and is available as a community edition, Enterprise on-premises edition and Enterprise Cloud edition. Development is mostly done by a company called OpenProject GmbH.

    Complete details of OpenProject Pricing is available on there official website.

    In addition to numerous smaller OpenProject installations, there are some very large installations in global organizations with more than 2,500 projects.

     

    OpenProject Features:

    Some of the core features of OpenProject Management Software are:

    • Bug tracking
    • Document management
    • Forum
    • Project news
    • Project timelines
    • Issue tracking or issue management
    • Project management and milestones
    • Time tracking
    • Wiki

     

    Environment Specification:

    We are using a minimal RHEL 8 virtual machine with following specifications.

    • CPU - 3.4 Ghz (2 cores)
    • Memory - 4 GB
    • Storage - 40 GB
    • Operating System - Red Hat Enterprise Linux 8.3
    • Hostname – openproject-01.centlinux.com
    • IP Address - 192.168.116.239 /24

     

    Update Red Hat Linux Software Packages:

    Connect with openproject-01.centlinux.com as root user by using a ssh client.

    Build cache for installed repositories.

    # dnf makecache

     

    21-dnf-makecache-linux-command

    Execute dnf command to update software packages on your Red Hat Linux server.

    # dnf update -y

     

    22-dnf-update-output

    The above command has also installed a new version of Linux Kernel.

    Therefore, you should reboot your RHEL server with new Linux Kernel before installing OpenProject.

    # systemctl reboot

     

    Install EPEL Repository on RHEL 8:

    OpenProject software needs some software packages that are not available in Red Hat subscription repositories.

    Therefore, you have to install third party EPEL (Extra Packages for Enterprise Linux) yum repository on your Linux server.

    Execute following dnf command to download and install EPEL repository.

    # dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -y

     

    Install OpenProject Official Repository in RHEL 8:

    OpenProject software is available to install via it's official yum repository.

    Therefore, you have to install the official yum repository as follows.

    # wget -O /etc/yum.repos.d/openproject.repo https://dl.packager.io/srv/opf/openproject/stable/11/installer/el/8.repo

    Build cache for newly installed yum repositories.

    # dnf makecache

     

    23-dnf-makecache-command-output

     

    Installing OpenProject on RHEL 8:

    You can now easily install OpenProject management software by using dnf command.

    # dnf install -y openproject

     

    24-dnf-install-openproject-command-output

     

    Generate SSL Certificate for your Linux Server:

    If you wish to configure SSL for your OpenProject application, then you have to provide paths to SSL certificate and Private Key.

    Therefore, generate Private Key and SSL certificate for your Red Hat Linux server as follows.

    # mkdir /etc/ssl/private # openssl req -x509 -nodes -days 1095 -newkey rsa:2048 -out /etc/ssl/certs/example.com.crt -keyout /etc/ssl/private/example.com.key

     

    25-openssl-command-output

     

    Configuration of OpenProject Management Software:

    Execute the following command at Linux bash prompt to start OpenProject configurations.

    # openproject configure

     

    01-install-openproject-rhel-8-editions

    OpenProject is available in two editions.

    OpenProject is the default editions, whereas OpenProject BIM is specifically designed for Construction industry.

    Select Default edition of OpenProject and push 'Ok'.

    02-install-openproject-rhel-8-postgresql-install

    The setup is now asking to auto-install and configure PostgreSQL database for OpenProject software.

    Select the 'Install' option and press 'Ok' button.

    03-install-openproject-rhel-8-apache-install

    Now, OpenProject setup is asking to install Apache Web Server on your Red Hat Linux server.

    Allow installation of Apache, by selecting 'Install' option and push 'Ok' button.

    04-install-openproject-rhel-8-fqdn

    Set the FQDN (Fully Qualified Domain Name) of your Red Hat Linux server.

    Make sure the FQDN is resolvable by means of a DNS Server or Local DNS resolver.

    Press 'Ok' to move forward.

    05-install-openproject-rhel-8-server-path-prefix

    You may provide a server path prefix here.

    If you does then the OpenProject software is installed in that sub-directory within the root directory of your server domain.

    If you left the field blank, then it will install OpenProject software in root directory of your server domain.

    Enter '/openproject' as server path prefix and push 'Ok' button.

    06-install-openproject-rhel-8-ssl

    You can configure SSL for your Apache Web Server from this screen.

    Enable SSL by selecting 'yes' option and push 'Ok' button.

    07-install-openproject-rhel-8-ssl-certificate

    Provide the path to your SSL certificate and press 'Ok'.

    08-install-openproject-rhel-8-ssl-private-key

    Provide the path to your Private Key and press 'Ok'.

    09-install-openproject-rhel-8-ssl-ca-bundle

    If you are using a signed SSL certificate then you have to provide path to CA bundle file.

    Otherwise leave it blank.

    Press 'Ok' to continue.

    10-install-openproject-rhel-8-api-key

    Enter a custom API Key or press 'Ok' button to use the auto-generated API key.

    11-install-openproject-rhel-8-svn-install

    Setup is now asking to install Apache Subversion on your Red Hat Linux operating system.

    Select the option to install Subversion and push 'Ok' button.

    12-install-openproject-rhel-8-svn-path

    Enter a Path to create SVN repositories therein or use the default path.

    Push 'Ok' button to move forward.

    13-install-openproject-rhel-8-apache-access-key

    Press 'Ok' and use the auto-generated Apache Wrapper Key.

    14-install-openproject-rhel-8-git-install

    You may choose to install Git Repository Support on your Red Hat Linux server.

    Select the 'Install Git Repository Support' option and push 'Ok' button.

    15-install-openproject-rhel-8-git-path

    Provide a path to host Git repositories Or use the default path.

    Press 'Ok' to continue setup.

    16-install-openproject-rhel-8-git-http-backend

    Press 'Ok' button to continue with the default path for Git HTTP Backend CGI directory.

    17-install-openproject-rhel-8-smtp

    Choose an option to send emails from OpenProject application.

    You can choose SMTP option, if you are using a Mail Server for your domain.

    Select 'Sendmail' option and push 'Ok' to continue.

    18-install-openproject-rhel-8-admin-email

    Provide an Admin email address and press 'Ok' button.

    19-install-openproject-rhel-8-memcached-install

    Choose 'Install new memcached server' option and press 'Ok' button.

    PostgreSQL 9.4 is obsolete and now it causes the dnf command to fail while cache pgdg94 repository.

    Therefore, you need to disable the pgdg94 repository if OpenProject setup raises an error and exit.

    # dnf config-manager --set-disable 'pgdg94' Updating Subscription Management repositories.

    Continue the configuration process by executing following command.

    # openproject configure

     

    26-openproject-configure-command-output

     

    Configure Linux Firewall:

    To allow access to your OpenProject application, you have to allow Apache services in Linux firewall.

    # firewall-cmd --permanent --add-service={http,https} success # firewall-cmd --reload success

    Open URL https://openproject-01.centlinux.com/openproject/login in a web browser.

    20-install-openproject-rhel-8-sign-in

    Login by using OpenProject default username/password i.e. admin/admin.

    21-install-openproject-rhel-8-change-password

    The OpenProject application will ask you to immediately change your password for better security.

    22-install-openproject-rhel-8-language

    Choose your preferred language for OpenProject application.

    23-install-openproject-rhel-8-welcome-page

    You will reach at the Welcome Page. Here you will found two demo projects.

    Click on 'Scrum Project'.

    24-install-openproject-rhel-8-scrum-project

    You will reach at the Overview page of the Scrum Project.

     

    Conclusion:

    In this guide, you have successfully installed OpenProject Management Software on RHEL 8. To build your knowledge in this area, you may buy OpenProject: A Concise and Practical Guide by Gerard Blokdyk It will help you in understanding the Software and its usage.

    No comments:

    Post a comment