Pleasanter with PostgreSQLをCentOS7にインストールする

Created on

遠藤誠也

2020/05/28 Thu 13:38:00

8 months ago

Updated on

遠藤誠也

2021/01/05 Tue 09:36:43

19 days ago

General

1381104

Version

カテゴリ

セットアップ

Title

Pleasanter with PostgreSQLをCentOS7にインストールする

概要

CentOS7 に「Pleasanter with PostgreSQL」をインストールする手順です

手順 / 詳細説明

[md]

本手順は、下記環境にて実施・検証した内容を基に記述しています。
- CentOS Linux 7.7.1908 64bit [CentOS7のダウンロードはこちら](http://isoredirect.centos.org/centos/7/isos/x86_64/)
- PostgreSQL 12.2
- .NetCore SDK 3.1-3.1.201
  
**※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 rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm
sudo yum -y update
sudo yum -y install dotnet-sdk-3.1
```

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

```
sudo yum install -y epel-release
sudo yum install -y libgdiplus
```

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

### 2.1 PostgreSQLリポジトリをダウンロード

```
sudo yum -y localinstall https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
```

※ 上記コマンドに改行は不要です。1行で入力してください。

### 2.2 PostgreSQL 12 をインストール
server モジュールと拡張モジュール contrib をインストールします。

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

### 2.3 DBを初期化

```
sudo /usr/pgsql-12/bin/postgresql-12-setup initdb
```

### 2.4 認証方式の設定

/var/lib/pgsql/12/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/12/data/postgresql.confを開き、以下を設定します。

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

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

### 2.6 PostgreSQLをサービス化

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

```
sudo systemctl start postgresql-12
sudo systemctl stop postgresql-12
sudo systemctl restart postgresql-12
```

### 2.7 PostgreSQLユーザー設定

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

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

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

```
[root@server-name ~]# su - postgres
-bash-4.2$ psql
psql (12.2)
"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-12/share/extension/pg_trgm.control"をオープンできませんでし
た: そのようなファイルやディレクトリはありません」  
postgreSQLの拡張モジュールをインストール後、上記コマンドを再度実⾏してください。

```
sudo yum -y install postgresql12-contrib
```

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

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

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

- /var/lib/pgsql/12/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-12
```

## 3. Pleasanterの導入

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

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/centos/7/$basearch/
gpgcheck=0
enabled=1
```
- 次のコマンドで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
```

#### 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
```

## プリザンターの画面が開かない場合
上記までの手順において特にエラーも出ずに完了したにも関わらず、ブラウザでアクセスすると「Welcome to nginx!」といったページ(エラー表示ではない)が表示される場合、ブラウザのセキュリティ設定により、プリザンターのログイン画面に遷移できていない可能性がございます。  
お使いのブラウザのセキュリティ設定をご確認ください。

## 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.1.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