## 概要 本説明は、以下に示す環境にプリザンターの動作環境を構築するための手順を示したものです。 |対象|環境・バージョン| |------|:--------------| |OS|Windows Server| |DB|SQL Server、PostgreSQL、MySQLのいずれか| |Webサーバ|IIS| |Platform|.NET 8| |Pleasanter|プリザンター 1.4| ## 注意事項 1. ver1.4.6以降でのインストール時に、CodeDefinerに引数を指定しないで実行した場合、言語：英語、タイムゾーン：UTCでセットアップされますので、必要に応じて言語とタイムゾーンをご指定ください。 1. MySQLはver1.4.9.0以降で使用できます。ver1.4.9.0より前のプリザンターはMySQLに対応していません。 ## 手順 構築手順は以下の通りです。 1. 事前準備 1. プリザンターのセットアップ 1. CodeDefinerの実行 1. IISのセットアップ 1. プリザンターの起動確認 ## 1. 事前準備 1. プリザンターをインストールする環境に合わせて、事前の準備を行います。 [プリザンターをWindows Server 2022にインストールする](getting-started-pleasanter-windows-server2022) [プリザンターをWindows Server 2019にインストールする](getting-started-pleasanter-windows-server2019) [プリザンターをWindows Server 2016にインストールする](getting-started-pleasanter-windows-server2016) [プリザンターをWindows 10 / 11 にインストールする](getting-started-pleasanter-windows10) ## 2. プリザンターのセットアップ 1. [ダウンロードセンター](https://pleasanter.org/dlcenter)から、プリザンター最新バージョンをダウンロードします。 1. ダウンロードしたzipファイルを解凍し、サーバに配置します。 Cドライブに「web」フォルダーを作成し、そこに「pleasanter」 フォルダーを配置するものとして記述します。 C:\web\pleasanter\Implem.Pleasanter C:\web\pleasanter\Implem.CodeDefiner C:\web\pleasanter\Tools  1. C:\web\pleasanter\Implem.Pleasanter\App_Data\Parameters\Rds.jsonにデータベースへの接続情報を設定します。設定例を以下に示します。必要に応じてRds.jsonのマニュアルも参照してください。 [パラメータ設定：Rds.json](rds-json) ### SQL Server使用時のRds.jsonの設定例 SQL Server使用時のRds.jsonの設定例は以下の通りです。 <details> <summary>（こちらをクリックすると詳細が開閉します） </summary> |No|プロパティ名|値| |:----|:----|:----| |1|Dbms|"SQLServer"| |2|SaConnectionString|"Server=(local);Database=master;UID=sa;PWD=<font color="Red">XXX</font>;Connection Timeout=30;"<br>※PWDの値はSQL Serverのsaアカウントのパスワードを入力してください。| |3|OwnerConnectionString|"Server=(local);Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<font color="Red">XXX</font>;Connection Timeout=30;"<br>※PWDの値は任意のパスワードを入力してください。| |4|UserConnectionString|"Server=(local);Database=#ServiceName#;UID=#ServiceName#_User;PWD=<font color="Red">XXX</font>;Connection Timeout=30;"<br>※PWDの値は任意のパスワードを入力してください。| ```json { "Dbms": "SQLServer", "Provider": "Local", "SaConnectionString": "Server=(local);Database=master;UID=sa;PWD=<SQL Serverのsaアカウントのパスワード>;Connection Timeout=30;", "OwnerConnectionString": "Server=(local);Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=SetAdminsPWD;Connection Timeout=30;", "UserConnectionString": "Server=(local);Database=#ServiceName#;UID=#ServiceName#_User;PWD=SetUsersPWD;Connection Timeout=30;", "SqlCommandTimeOut": 0, "MinimumTime": 3, "DeadlockRetryCount": 4, "DeadlockRetryInterval": 1000, "DisableIndexChangeDetection": true, "SysLogsSchemaVersion": 1 } ``` </details> ### PostgreSQL使用時のRds.jsonの設定例 PostgreSQL使用時のRds.jsonの設定例は以下の通りです。 <details> <summary>（こちらをクリックすると詳細が開閉します） </summary> |No|プロパティ名|値| |:----|:----|:----| |1|Dbms|"PostgreSQL"| |2|SaConnectionString|"Server=localhost;Port=5432;Database=postgres;UID=postgres;PWD=<font color="Red">XXX</font>"<br>※PWDの値はPostgreSQLのpostgresアカウントのパスワードを入力してください。| |3|OwnerConnectionString|"Server=localhost;Port=5432;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<font color="Red">XXX</font>"<br>※PWDの値は任意のパスワードを入力してください。| |4|UserConnectionString|"Server=localhost;Port=5432;Database=#ServiceName#;UID=#ServiceName#_User;PWD=<font color="Red">XXX</font>"<br>※PWDの値は任意のパスワードを入力してください。| ```json { "Dbms": "PostgreSQL", "Provider": "Local", "SaConnectionString": "Server=localhost;Port=5432;Database=postgres;UID=postgres;PWD=<PostgreSQLのpostgresアカウントのパスワード>", "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": 0, "MinimumTime": 3, "DeadlockRetryCount": 4, "DeadlockRetryInterval": 1000, "DisableIndexChangeDetection": true, "SysLogsSchemaVersion": 1 } ``` </details> ### MySQL使用時のRds.jsonの設定例 MySQL使用時のRds.jsonの設定例は以下の通りです。 <details> <summary>（こちらをクリックすると詳細が開閉します） </summary> |No|プロパティ名|値| |:----|:----|:----| |1|Dbms|"MySQL"| |2|SaConnectionString|"Server=localhost;Port=3306;Database=mysql;UID=root;PWD=<font color="Red">XXX</font>"<br>※PWDの値はMySQLのrootアカウントのパスワードを入力してください。| |3|OwnerConnectionString|"Server=localhost;Port=3306;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<font color="Red">XXX</font>"<br>※PWDの値は任意のパスワードを入力してください。| |4|UserConnectionString|"Server=localhost;Port=3306;Database=#ServiceName#;UID=#ServiceName#_User;PWD=<font color="Red">XXX</font>"<br>※PWDの値は任意のパスワードを入力してください。| ```json { "Dbms": "MySQL", "Provider": "Local", "SaConnectionString": "Server=localhost;Port=3306;Database=mysql;UID=root;PWD=<MySQLのrootアカウントのパスワード>", "OwnerConnectionString": "Server=localhost;Port=3306;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=SetAdminsPWD", "UserConnectionString": "Server=localhost;Port=3306;Database=#ServiceName#;UID=#ServiceName#_User;PWD=SetUsersPWD", "SqlCommandTimeOut": 0, "MinimumTime": 3, "DeadlockRetryCount": 4, "DeadlockRetryInterval": 1000, "DisableIndexChangeDetection": true, "SysLogsSchemaVersion": 1 } ``` </details> ## 3. CodeDefinerの実行 コマンドプロンプトまたはPowerShellを起動し、以下コマンドを実行します。ご利用バージョンに応じて実行するコマンドが異なります。 ### ver.1.4.5まで ``` cd C:\web\pleasanter\Implem.CodeDefiner dotnet Implem.CodeDefiner.dll _rds ``` ### ver.1.4.6以降 ※下記コマンドは初回インストール時にのみ実行します。 ``` cd C:\web\pleasanter\Implem.CodeDefiner dotnet Implem.CodeDefiner.dll _rds /l "<言語>" /z "<タイムゾーン>" ``` |引数|設定例|説明| |:--|:--|:--| |/l|ja|Service.jsonのDefaultLanguageの値を書き換えます(※1)| |/z|Tokyo Standard Time|Service.jsonのTimeZoneDefaultの値を書き換えます(※1)| (※1) 言語、タイムゾーンは以下マニュアルページを参照ください。 [FAQ：プリザンターでサポートしている言語とタイムゾーンのパラメータの設定値を知りたい](https://pleasanter.org/manual/faq-supported-language) 日本語環境でご利用する場合は以下コマンドとなります。 ``` cd C:\web\pleasanter\Implem.CodeDefiner dotnet Implem.CodeDefiner.dll _rds /l "ja" /z "Tokyo Standard Time" ``` 途中で 「Type "y" (yes) if the license is correct, otherwise type "n" (no).」 と表示されたら **y** を入力してください。 ## 4. IISのセットアップ 1. 「サーバマネージャー」の「ツール(T)」メニューを開き「インターネット インフォメーション サービス（IIS)マネージャー」を起動します。 1. 「アプリケーションプール」の「DefaultAppPool」を選択し、「基本設定」をクリックします。  1. Net CLR バージョンを、「マネージコードなし」に変更します。  1. 左ペインより、[サイト](/ja/manual/site)-「Default Web Site」を選択して、右ペインの詳細設定をクリックします。  1. 物理パスを、「C:\web\pleasanter\Implem.Pleasanter」と入力します。  1. 左ペインより、[サイト](/ja/manual/site)-「Default Web Site」を選択して、右ペインの「再起動」をクリックして、IISを再起動します。  1. 再起動後、右ペインの「*.80(http)参照」をクリックし、プリザンターを起動します。  ## 5. プリザンターの動作確認 1. プリザンターのログイン画面にて「ログインID: Administrator」、「初期パスワード: pleasanter」を入力し、「ログイン」ボタンをクリックします。  1. ログイン後に「Administrator」ユーザーのパスワード変更を求められるので、任意のパスワードを入力し、「変更」ボタンをクリックします。  ## 対応バージョン |対応バージョン|内容| |:--|:--| |1.4.9.0 以降|MySQLに対応|