WebサーバをApacheにしてPleasanterをインストールしたい

2026-09-172026-09-17

前提条件¶

OSのセットアップ方法については記載しません。予めOSはセットアップされていることとします。
動作環境やスペックについての詳細はこちらを確認してください。

概要¶

本説明は、以下に示す環境にプリザンターの動作環境を構築するための手順を示したものです。

対象	内容
OS	Red Hat Enterprise Linux 9.1
DB	PostgreSQL 14
Webサーバ	Apache
Platform	.NET 6.0
Pleasanter	プリザンター 1.3.37.0

操作手順¶

1. .NET 6.0のインストール¶

ASP.NET Coreランタイムのインストール¶

sudo dnf install aspnetcore-runtime-6.0

GDI+のインストール¶

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

2. PostgreSQLのセットアップ¶

パケージリポジトリの登録¶

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

PostgreSQLのインストール¶

sudo dnf module -y disable postgresql
sudo dnf install -y postgresql14-server postgresql14-contrib

データベースの初期化¶

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

補足：

-A: 認証方式の指定
-W: パスワード入力プロンプトを表示するオプション
このタイミングでDBのpostgresユーザのパスワードを指定する

ログの出力設定¶

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

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

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

サービス有効化¶

sudo systemctl enable postgresql-14

OSのPostgreSQLユーザ設定¶

PostgreSQL管理用のユーザpostgres（OSのユーザ）にパスワードを設定します。

sudo passwd postgres

全⽂検索⽤モジュール（pg_trgm）のインストール¶

テキストの全⽂検索に必要なモジュール（pg_trgm）をインストールします。

ユーザpostgresに切り替え、PostgreSQLへ接続します。
```
su - postgres
psql -U postgres
```
データベースImplem.Pleasanterを作成します。
```
create database "Implem.Pleasanter";
```
データベースImplem.Pleasanterに切り替えます。
```
\c "Implem.Pleasanter";
```
pg_trgmをインストールします。
```
create extension pg_trgm;
```

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

/var/lib/pgsql/14/data/postgresql.confの以下の2行のコメントを解除して下記のように設定します。
/var/lib/pgsql/14/data/postgresql.conf
```
# - Connection Settings -
listen_addresses = '*'  # what IP address(es) to listen on;
port = 5432             # (change requires restart)
```
/var/lib/pgsql/14/data/pg_hba.confに以下の行を追加します。Address欄にはアクセスを許可するIPアドレスの範囲を指定します。

/var/lib/pgsql/14/data/pg_hba.conf

# TYPE  DATABASE        USER            ADDRESS                 METHOD
host    all             all             192.168.1.0/24          scram-sha-256

設定後、PostgreSQLのサービスを再起動します。
```
sudo systemctl restart postgresql-14
```

3. プリザンター 1.3の導入¶

アプリケーションの準備¶

プリザンター 1.3をダウンロードします。

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

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

データベースの構成¶

/web/pleasanter/Implem.Pleasanter/App_Data/Parameters/Rds.jsonを以下のように設定します。

Rds.json
{
    "Dbms": "PostgreSQL",
    "Provider": "Local",
    "TimeZoneInfo": "Asia/Tokyo",
    "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
}

CodeDefinerを実行

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

Pleasanterの起動

cd /web/pleasanter/Implem.Pleasanter
dotnet Implem.Pleasanter.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 で終了します。

Pleasanterサービス用スクリプトの作成¶

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

/etc/systemd/system/pleasanter.service
[Unit]
Description = Pleasanter
Documentation =
Wants=network.target
After=network.target

[Service]
ExecStart = /usr/bin/dotnet Implem.Pleasanter.dll # (1)
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

この例はRed Hat Enterprise Linux 8の場合の例です。その他のバージョンでご利用の場合、dotnetコマンドのPATHを確認してから環境に応じて変更してください。以下のコマンドを実行してdotnetの実行パスを確認できます。
```
whereis -b dotnet
```
例えば上記のコマンドを実行した結果が/usr/local/bin/dotnetである場合は、脚注の行は以下のように設定する必要があります。
```
ExecStart = /usr/local/bin/dotnet Implem.Pleasanter.dll
```

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

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

リバースプロキシ（Apache）の設定¶

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

Apacheのインストール¶

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

dnf install -y httpd
systemctl enable httpd

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

/etc/httpd/conf/httpd.confの最終行に以下の内容を追記します。

/etc/httpd/conf/httpd.conf

ProxyRequests Off
ProxyPass / http://localhost:5000/
ProxyPassReverse / http://localhost:5000/

ファイルを追記後、Apacheを再起動します。

systemctl restart httpd

80番ポートへのアクセス許可¶

クライアントからWebサービスへアクセスさせるため、http（80番ポート）へのアクセス許可の設定を行ってください。
設定は各環境により異なりますので適宜調べてください。

4. その他設定¶

初期アカウント¶

ログインID: Administratorが初期ユーザとして作成されます。
初期ユーザのパスワードは、既定ではpleasanterです。初回ログイン時にパスワード変更ダイアログが表示されますので、任意のパスワードを設定してください。

このパスワードは、/web/pleasanter/Implem.Pleasanter/App_Data/Parameters/Service.jsonのDefaultPasswordで指定可能です。

プリザンターバージョン 1.3.7.0以降でリマインダー機能を有効化する手順¶

BackgroundService.jsonおよびService.jsonのパラメータ設定値を変更してください。なお、パラメータ変更時はマニュアルパラメータ変更時の確認事項を確認してください。

BackgroundService.json¶

マニュアルパラメータ設定：BackgroundService.jsonを参照し、BackgroundService.jsonファイル内の設定を下記の設定値に変更してください。

項目	設定例	説明
Reminder	true	リマインダー機能の有効化

Service.json¶

マニュアルパラメータ設定：Service.jsonを参照し、Service.jsonファイル内の設定を下記の設定値に変更してください。

項目	設定例	説明
AbsoluteUri	"http://pleasanter.example.local"	通知やリマインダーに記載されるURLの先頭部分を記入してください。（nullは使えません。）

データベースの移行¶

SQL ServerからPostgreSQLに移行する場合の手順は以下のマニュアルを参照してください。

プリザンターのDBをSQL ServerからPostgreSQLへ移行する手順