Install Pleasanter on Red Hat Enterprise Linux 8 using the installer

Overview¶

This procedure is for building a Pleasanter operating environment using the "Installer". You can still install it using the previous procedure of manually placing modules and setting parameters. Please refer to the following for manual installation procedures.
Install Pleasanter on Red Hat Enterprise Linux 8

Cautions¶

1. MySQL can be used with ver1.4.9.0 and later. Pleasanter earlier than ver1.4.9.0 does not support MySQL.
2. To use MySQL in a configuration where the web server and the DB server are separated, refer to "Configure MySQL to be used in a configuration where the web server and DB server are separated (Ver.1.4.18.0 and later)" or "Configure the Web Server and DB Server to Use MySQL Separately (Ver.1.4.17.1 and earlier)".

Limitations¶

Installation using the "Installer" is for versions 1.4.0.0 onward. Please refer to the manual installation procedures when installing versions 1.3.50.2 and earlier.
Install Pleasanter on Red Hat Enterprise Linux 8

Prerequisites¶

1. We will not cover how to set up the OS. We assume that the OS has already been set up.
2. Please check here for details on the operating environment and specifications.
   FAQ: I want to know the operating environment and recommended specifications
3. Decide in advance which user will launch Pleasanter. The ＜User who will launch Pleasanter＞ mentioned in the procedure refers to this user.

Procedure¶

The construction procedure is as follows.
1. .NET setup
1. Set up the database:
Set up either PostgreSQL or MySQL as follows.
* The following may not match the order in which the settings are made.
1. Install the database
1. Set up the database administrator user
1. Set up the database log output
1. Register the database as a service and enable automatic startup
1. Setup for allowing external access to the database
1. Install the installer
1. Set up Pleasanter
1. Run the installer
1. Check that Pleasanter is running
1. Create a script for the Pleasanter service
1. Register as a service and starting the service
1. Set up Reverse proxy (nginx)
1. Change SELinux settings
1. Install nginx
1. Set reverse proxy
1. Allow access to Http(80)
1. Check that Pleasanter is running

1. Set up .NET¶

Run the following command to install .NET.

sudo wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
sudo chmod +x ./dotnet-install.sh
sudo ./dotnet-install.sh -c 8.0 -i /usr/local/bin
dotnet --version

For details, please refer to the official page below, Scripted Install.
https://learn.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#scripted-install

Also, there are cases where an error occurs regarding a specific file when executing the dotnet command. In that case, please refer to the following page.
https://learn.microsoft.com/en-us/dotnet/core/install/linux-package-mixup?pivots=os-linux-redhat

2. Set up the Database¶

Refer to either "Setting Up PostgreSQL" or "Setting Up MySQL" below and set up the database.

sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo dnf install -y postgresql17-server postgresql17-contrib

sudo su - postgres -c '/usr/pgsql-17/bin/initdb -E UTF8 -A scram-sha-256 -W'

log_destination = 'stderr'
logging_collector = on
log_line_prefix = '[%t]%u %d %p[%l]'

sudo systemctl restart postgresql-17.service
sudo systemctl enable postgresql-17.service

3. Install the Installer¶

Execute the following command to install the installer.

dotnet tool install -g Implem.PleasanterSetup
echo 'export PATH="$PATH:~/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc

If you are not connected to a network environment, please install using the following procedure.¶

4. Set up Pleasanter¶

1. Run the installer¶

Using the installer will automatically download the latest version resources and automatically set the values ​​in Service.json and Rds.json based on the values ​​you enter.

1. Run the installer by executing the following command.

   pleasanter-setup
   

   
   If you are not connected to a network environment, please follow the steps below

1. Enter the directory where you want to install Pleasanter.
   If you want to install it in "/web/pleasanter", leave it blank and press the Enter key.
   

2. Enter ＜User who will launch Pleasanter＞.
   

3. Enter the service name.
   If you want to install it in "Implem.Pleasanter", leave it blank and press the Enter key.
   

4. Enter the number corresponding to the DBMS you want to use.
   Here, enter "2" and press the Enter key.
   

5. Enter the port number to be used.
   If it is the default port number for the DBMS, leave it blank and press the Enter key.
   

6. Enter the value to be set in Server in the connection string.
   If it is "localhost", leave it blank and press the Enter key.
   

7. Enter the value to be set in UID of SaConnectionString.
   If it is "postgres", leave it blank and press the Enter key.
   

8. Enter the value to be set in PWD of SaConnectionString.
   ＊The password will be displayed in a masked state.
   

9. Enter the value to be set in PWD of OwnerConnectionString.
   ＊The password will be displayed in a masked state.
   

10. Enter the value to be set in PWD of UserConnectionString.
    ＊The password will be displayed in a masked state.
    

11. Enter the "Default language".
    Enter the number of the corresponding language.
    

12. Enter the time zone for "Default time zone".
    Enter the number of the corresponding time zone.
    ＊If you entered "3", enter the time zone available on the OS you are using.
    

13. The summary screen will be displayed.
    If the entered values ​​are correct, enter y after "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)'. :" and press Enter to execute.
    ＊The password is masked.
    

14. When "Type "y" (yes) if the license is correct, otherwise type "n" (no)" is displayed, enter y and execute.
    When the following log is displayed, the setup is complete.
    

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    Setup is complete.
    

15. When setup is complete, a web browser will launch and display the Enterprise Edition trial information page.

    

2. Check that Pleasanter is running¶

1. Run the following command to start Pleasanter with a predefined user.

   cd /web/pleasanter/Implem.Pleasanter
   sudo -u ＜User who will launch Pleasanter＞ /usr/local/bin/dotnet Implem.Pleasanter.dll
   

2. While Pleasanter is running, run the following command in another terminal to check that Pleasanter is running. Exit with "Ctrl+C".

＊ Execution command

curl -v http://localhost:5000/

＊ Execution result

*   Trying ::1:5000...
* Connected to localhost (::1) port 5000 (#0)
> GET / HTTP/1.1
> Host: localhost:5000
> User-Agent: curl/7.76.1
> Accept: */*
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 302 Found
< Content-Length: 0
< Date: Tue, 25 Jul 2023 02:42:19 GMT
< Server: Kestrel
< Location: http://localhost:5000/users/login?ReturnUrl=%2F
< X-Frame-Options: SAMEORIGIN
< X-XSS-Protection: 1; mode=block
< X-Content-Type-Options: nosniff
<
* Connection #0 to host localhost left intact

3. Create a script for the Pleasanter service¶

Create /etc/systemd/system/pleasanter.service with the following content. For User below, specify the user who will launch Pleasanter.

[Unit]
Description = Pleasanter
Documentation =
Wants=network.target
After=network.target

[Service]
ExecStart = /usr/local/bin/dotnet Implem.Pleasanter.dll
WorkingDirectory = /web/pleasanter/Implem.Pleasanter
Restart = always
RestartSec = 10
KillSignal=SIGINT
SyslogIdentifier=dotnet-pleasanter
User = <User who launches Pleasanter>
Group = root
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy = multi-user.target

4. Register as a service and start the service¶

Execute the following command to start the Pleasanter service and enable automatic service startup.

sudo systemctl daemon-reload
sudo systemctl enable pleasanter
sudo systemctl start pleasanter

5. Set up Reverse Proxy (nginx)¶

Configure the reverse proxy so that it can be accessed via Port 80, the same as a normal web server.

1. Change SELinux Settings¶

Execute the following command.

getenforce

a. If "Command 'getenforce' not found," "Permissive," or "Disabled" is displayed¶

Proceed to "2. Install nginx."

b. If "Enforcing" is displayed¶

Execute the following command.

sudo setsebool -P httpd_can_network_connect on

＊By changing the above Boolean values ​​of SELinux, all network connections via scripts and modules will be allowed on the corresponding server.

2. Install nginx¶

Run the following command to install nginx.

sudo dnf install -y nginx
sudo systemctl enable nginx

3. Set reverse proxy¶

1. Create /etc/nginx/conf.d/pleasanter.conf with the following contents. In the server_name line, specify the host name or IP address of the server you want to access.

   server {
       listen  80;
       server_name   192.168.1.100;
       client_max_body_size 100M;
       location / {
          proxy_pass         http://localhost:5000;
          proxy_http_version 1.1;
          proxy_set_header   Upgrade $http_upgrade;
          proxy_set_header   Connection keep-alive;
          proxy_set_header   Host $host;
          proxy_cache_bypass $http_upgrade;
          proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header   X-Forwarded-Proto $scheme;
       }
   }
   

2. After creating the file, run the following command to restart the service.

   sudo systemctl restart nginx
   

4. Permission To Access Http(80)¶

Execute the following command to set permission to access Http (port:80) to allow clients to access the web service.

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --reload

6. Check the Operation of Pleasanter¶

1. After starting Pleasanter, enter "Login ID: Administrator" and "Initial password: pleasanter" on the Pleasanter login screen and click the "Login" button.
   

2. After logging in, you will be asked to change the password for the "Administrator" user, so enter a password of your choice and click the "Change" button.
   

If redirection is not correct¶

Please check that the nginx settings are correct. Operation may change depending on small differences such as the presence or absence of/in the description.

If the Pleasanter screen does not open¶

If the above steps have been completed without any errors, but a page such as "Welcome to nginx!" (not an error message) appears when you access it in a browser, the security settings of the browser may be preventing you from transitioning to the Pleasanter login screen.
Please check the security settings of your browser.

Supported Versions¶

Related Information¶

FAQ: I want to install Pleasanter 1.3.43.0 or earlier in a Linux environment