Pleasanter with PostgreSQLをRHEL8/CentOS8にインストールする

Created on

肥田野雄大

2020/07/08 Wed 14:58:31

6 months ago

Updated on

遠藤誠也

2020/09/29 Tue 15:58:03

4 months ago

General

1490231

Version

カテゴリ

セットアップ

Title

Pleasanter with PostgreSQLをRHEL8/CentOS8にインストールする

概要

RHEL8 に「Pleasanter(.NET Core版)」をインストールする手順です。

手順 / 詳細説明

[md]

本手順は、下記環境にて実施・検証した内容を基に記述しています。
- Red Hat Enterprise Linux 8.2 64bit / CentOS-8.2.2004 64bit
- PostgreSQL 12.1
- .Net Core SDK 3.1.105

**※SQL ServerからPostgreSQLに移行する場合の手順は以下のマニュアルをご参照ください。**  
[プリザンターのDBをSQL ServerからPostgreSQLへ移行する手順について](https://pleasanter.net/fs/publishes/1382763/edit)

**※.NET Core版1.0.9から1.1.0移行へのバージョンアップはこちら**  
[プリザンター(.NET Core版)1.0.9から1.1.0以降へのバージョンアップ](https://pleasanter.net/fs/publishes/1383602/edit)  
  
**※動作環境やスペックについての詳細はこちらをご確認ください。**  
[FAQ:プリザンターの動作環境や推奨スペックが知りたい](https://pleasanter.net/fs/publishes/253028/edit)

## 1. .NetCore のインストール
.Net Core 3.1 と .NetCore用GDIモジュールをインストールします。

### 1.1 Git clientのインストール

```
sudo yum -y install git
```

### 1.2 .NetCore 3.1 のインストール

```
sudo yum -y update
sudo yum -y install dotnet-sdk-3.1
```

### 1.3 GDI+のインストール

```
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo yum install -y libgdiplus
```

## 2. PostgreSQL12 のセットアップ
PostgreSQL12のインストールとセットアップを行います。

### 2.1 PostgreSQL12をインストール

```
sudo yum module enable postgresql:12
```

### 2.1 パッケージをインストール
server モジュールと拡張モジュール contrib をインストールします。

```
sudo yum -y install postgresql-server postgresql-contrib
```

### 2.3 DBを初期化

```
postgresql-setup --initdb
```

### 2.4 認証方式の設定

/var/lib/pgsql/data/pg_hba.conf を開き、METHODの"ident"を"md5"に変更します。

```
# TYPE  DATABASE        USER            ADDRESS                 METHOD
# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5
# Allow replication connections from localhost, by a user with the
# replication privilege.
local   replication     all                                     peer
host    replication     all             127.0.0.1/32            md5
host    replication     all             ::1/128                 md5
```

### 2.5 ログの出力設定

/var/lib/pgsql/data/postgresql.confを開き、以下を設定します。

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

※ ログファイルは "/var/lib/pgsql/data/log" に保存されます。

### 2.6 PostgreSQLをサービス化

```
sudo systemctl enable postgresql
```
- PostgeSQLのサービスは以下のコマンドで起動・停止・再起動を行います。

```
sudo systemctl start postgresql
sudo systemctl stop postgresql
sudo systemctl restart postgresql
```

### 2.7 PostgreSQLユーザー設定

- PostgreSQL管理用のユーザー"postgres"(OSのユーザー)にパスワードを設定します。

```
[root@server-name ~]# passwd postgres
ユーザー postgres のパスワードを変更。  
新しいパスワード:新しいパスワードを再入力してください:  
passwd: すべての認証トークンが正しく更新できました。
```

- ユーザー"postgres"に切り替え、PostgreSQLへ接続します。

```
[root@server-name ~]# su - postgres
psql -U postgres
psql (12.1)
"help" でヘルプを表示します。

postgres=#
```

- PostgreSQLの管理ユーザー "postgres" のパスワードを設定

```
postgres=# alter role postgres with password '<new password>';
```

### 2.8 DBの作成
- データベース "Implem.Pleasanter" を作成します。

```
postgres=# create database "Implem.Pleasanter";
```
- 以下のコマンドで作成したDBの確認を行います。

```
postgres=# \l
```

### 2.9 全⽂検索⽤モジュール（pg_trgm）のインストール
テキストの全⽂検索に必要なモジュール（pg_trgm）をインストールします。  
データベース"Implem.Pleasanter"に接続し、pg_trgm をインストール

```
postgres=# \c "Implem.Pleasanter";
Implem.Preasanter=# CREATE EXTENSION pg_trgm;
```

※ここで以下のようなエラーが出⼒される場合  
「機能拡張の制御ファイル"/usr/pgsql/share/extension/pg_trgm.control"をオープンできませんでした: そのようなファイルやディレクトリはありません」  
postgreSQLの拡張モジュールをインストール後、下記コマンドを再度実⾏してください。

```
sudo yum -y install postgresql-contrib
```

### 2.10 外部からDBへのアクセスを許可する場合の設定

- /var/lib/pgsql/data/postgresql.conf の以下の2行のコメントを解除して下記のように設定します。

```
# - Connection Settings -
listen_addresses = '*'  # what IP address(es) to listen on;
port = 5432             # (change requires restart)
```

- /var/lib/pgsql/data/pg_hba.conf に以下の行を追加します。

```
# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             192.168.1.0/24          md5
```

※Address欄にはアクセスを許可するIPアドレスの範囲を指定します。

- 設定後、PostgreSQLのサービスを再起動します。

```
sudo systemctl restart postgresql
```

## 3. Pleasanterの導入

### 3.1 アプリケーションの準備
下記URLから .NetCore版のPleasanterをダウンロードしてサーバー(RHEL)上に配置します。

https://pleasanter.org/dlcenter

**クライアントがWindowsPCの場合、WinSCPをお使いになるとファイルの配置が簡単です**

今回は、ルートディレクトリ（"/"）に"/web"フォルダーを作成し、そこに"pleasanter" フォルダーを配置するものとして記述します。

- /web/pleasanter/Implem.Pleasanter  
- /web/pleasanter/Implem.CodeDefiner  
- /web/pleasanter/Tools

### 3.2 DBの構成

**※SQL ServerからPostgreSQLに移行する場合の手順は以下のマニュアルをご参照ください。**  
[プリザンターのDBをSQL ServerからPostgreSQLへ移行する手順について](https://pleasanter.net/fs/publishes/1382763/edit)  
  
/web/pleasanter/Implem.Pleasanter/App_Data/Parameters/Rds.json を以下のように設定します。

```json
{
       "Dbms": "PostgreSQL",
       "Provider": "Local",
       "TimeZoneInfo": "Tokyo Standard Time",
       "SaConnectionString":"Server=localhost;Port=5432;Database=postgres;UID=postgres;PWD=<設定したパスワード>",
       "OwnerConnectionString":"Server=localhost;Port=5432;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=SetAdminsPWD",
       "UserConnectionString":"Server=localhost;Port=5432;Database=#ServiceName#;UID=#ServiceName#_User;PWD=SetUsersPWD",
       "SqlCommandTimeOut": 600,
       "MinimumTime": 3,
       "DeadlockRetryCount": 4,
       "DeadlockRetryInterval": 1000
}
```

- Implem.CodeDefinerフォルダーに移動し、CodeDefinerを実行します。

```
cd /web/pleasanter/Implem.CodeDefiner
dotnet Implem.CodeDefiner.NetCore.dll _rds
```

- 以下のコマンドでPleasnterを実行し、起動確認を行います。

```
cd ../Implem.Pleasanter
dotnet Implem.Pleasanter.NetCore.dll
```

- 別のターミナルで "http://localhost:5000/" にアクセスし、正常なレスポンスが帰ってくることを確認します。

```
curl -v http://localhost:5000/
```

```
* About to connect() to localhost port 5000 (#0)
*   Trying ::1...
* Connected to localhost (::1) port 5000 (#0)
> GET / HTTP/1.1
> User-Agent: curl/7.29.0
> Host: localhost:5000
> Accept: */*
>
< HTTP/1.1 302 Found
< Date: Mon, 25 May 2020 15:13:08 GMT
< Server: Kestrel
< Content-Length: 0
< Location: http://localhost:5000/users/login?ReturnUrl=%2F
```

- 確認できたらCtrl+Cで終了します。  
  
### 3.3 Pleasanterサービス用スクリプトの作成

/etc/systemd/system/pleasanter.service を以下の内容で作成します。

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

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

[Install]
WantedBy = multi-user.target
```

### 3.4 サービスとして登録・サービスの起動

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

### 3.5 リバースプロキシ（NginX）の設定

通常のwebサーバと同じ Port80 でアクセスできるようにリバースプロキシの設定を行います。

#### NginXのインストール

- /etc/yum.repos.d/nginx.repo を以下の内容で作成します。

```
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/rhel/8/$basearch/
gpgcheck=0
enabled=1
```
※CentOS8の場合は上記の"rhel"を"centos"に置換して下さい。

- 次のコマンドでNginXをインストールします。

```
yum install nginx
```
- NginXをサービスとして登録します。

```
systemctl enable nginx
```

#### リバースプロキシの設定

/etc/nginx/conf.d/pleasanter.conf を以下の内容で作成します。

```
server {
    listen  80;
    server_name   192.168.1.100;
    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;
    }
}
```
※server_name 行には実際アクセスする際のホスト名を指定します。  
  
- ファイルを作成後、NginXを再起動します。

```
systemctl restart nginx
```

#### 3.6 Http へのアクセス許可
クライアントからWebサービスへアクセスさせるため、 Http（port:80）へのアクセス許可設定を行います。  
  
- ファイアウォールでPort 80を許可します。  
```
$ sudo firewall-cmd --permanent --zone=public --add-port=80/tcp
success
$ sudo firewall-cmd --reload
$ sudo firewall-cmd --list-all
```

- SELinux のhttpアクセス許可をONにします。

```
sudo setsebool httpd_can_network_connect on -P
```

## 4. その他設定

### 4.1 初期アカウント
ログインID "Administrator" が初期ユーザーとして作成されます。  
初期ユーザーのパスワードは、既定では"pleasanter"（※）です。初回ログイン時にパスワード変更ダイアログが表示されますので、任意のパスワードを設定してください。  
※ このパスワードは、"/web/pleasanter/Implem.Pleasanter/App_Data/Parameters/Service.json" の "DefaultPassword" で指定可能です。

### 4.2 リマインダーの設定
- /web/pleasanter/Tools/Reminder.py を開き、"localhost/pleasanter" 部分を書き換え、クライアントからアクセス可能なURLに変更します。

```
urllib.request.Request("http://192.168.11.100/reminderschedules/remind?NoLog=1")
```

- リマインダーを動作させるために必要な「Python3.6」をインストールします。

```
sudo yum -y install python36
```

- Reminder.py を cron に登録します。

```
sudo crontab -e
@reboot python3 /web/pleasanter/Tools/Reminder.py
```

Move to