# ワークフローシステム(Windows)

# モジュール構成

アップデート製品のモジュール構成は以下の通りです。

[DVD(WEBFLOW_UPDATE)]
  ├─ formmanager … フォームマネージャー
  ├─ manual … ワークフローシステム マニュアル一式
  └─ server
      ├─ cwf-update-v5.3.0.exe … アップデーター
      ├─ postgresql
      │    └─ postgresql-14.1-1-windows-x64.exe … PostgreSQL 14.1
      └─ sql … SQLファイル

# フォルダー構成の表記について

以降の手順で記載しているフォルダー構成は、すべて標準インストール時(C:\CREATE_HOME)のものです。 インストール時にインストールフォルダーを変更している場合はフォルダー構成を読み替えてください。

# アップデート手順

ワークフローシステムのアップデートは以下の手順で行います。

1. ワークフローシステムの停止
2. レジストリのバックアップ
3. データベースのバージョンアップ
4. ワークフローシステムのアップデート
5. Tomcatの設定変更
6. データベースのメンテナンス
7. OSの再起動

# ワークフローシステムの停止

サービスCreate!WebFlow(Tomcat)を停止します。

# レジストリのバックアップ

1. レジストリのバックアップフォルダーを作成するため、コマンドプロンプトで以下のコマンドを実行します。

mkdir C:\cwf-backup

2. レジストリをバックアップするため、コマンドプロンプトで以下のコマンドを実行します。

REG EXPORT "HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation" C:\cwf-backup\cwf_tomcat.reg
REG EXPORT "HKLM\SYSTEM\CurrentControlSet\Services\TomcatCwf" C:\cwf-backup\cwf_service_TomcatCwf.reg
REG EXPORT "HKLM\SYSTEM\CurrentControlSet\Services\TomcatXf" C:\cwf-backup\cwf_service_TomcatXf.reg
REG EXPORT "HKLM\SYSTEM\CurrentControlSet\Services\CreateWebFlow" C:\cwf-backup\cwf_service_CreateWebFlow.reg

# データベースのバージョンアップ

ワークフローシステムが利用するデータベースごとに手順が異なります。
以下のリンクより、データベースごとの手順をご参照ください。

• PostgreSQL
• SQL Server
• Oracle

# PostgreSQL

1. データベースをバックアップするため、コマンドプロンプトで以下のコマンドを実行します。

cd C:\CREATE_HOME\PostgreSQL\bin

REM <バックアップファイル>の部分には、任意のファイルパスを指定します。
pg_dumpall.exe -h localhost -p 5432 -U xfadmin -v > <バックアップファイル>

パスワードを要求されますので、xfadmin のパスワードを入力します。

xfadmin の初期パスワード：y3dTaaHIAH

2. サービスCreate!WebFlow Databaseを停止します。

3. サービスの設定を変更するため、以下のコマンドを実行します。

PostgreSQL8.3利用時

sc config pgsql-8.3 start= demand
sc config pgsql-8.3 DisplayName= "Create!WebFlow Database-8.3 (backup)"
sc description pgsql-8.3 "Create!WebFlow データベース-8.3 (backup)"

PostgreSQL9.2利用時

sc config postgresql-9.2 start= demand
sc config postgresql-9.2 DisplayName= "Create!WebFlow Database-9.2 (backup)"
sc description postgresql-9.2 "Create!WebFlow データベース-9.2 (backup)"

4. PostgreSQLのモジュールをバックアップするため、エクスプローラーでフォルダーの名前を変更します。

5. PostgreSQLのインストーラー((WEBFLOW_UPDATE)\server\postgresql\postgresql-14.1-1-windows-x64.exe)を実行します。

6. PostgreSQLのセットアップウィザードが起動したらNext >ボタンをクリックします。

7. Installation Directoryでは、PostgreSQLのインストールフォルダーを設定します。 C:\CREATE_HOME\PostgreSQLを設定してNext >ボタンをクリックします。

8. Select Componentsでは、PostgreSQLのコンポーネントを設定します。Stack Builder以外が選択されていることを確認してNext >ボタンをクリックします。

9. Data Directoryでは、PostgreSQLのデータフォルダーを設定します。C:\CREATE_HOME\PostgreSQL\dataが設定されていることを確認してNext >ボタンをクリックします。

10. Passwordでは、PostgreSQLに初期設定されるDB管理ユーザー(postgres)のパスワードを設定します。DB管理ユーザーのパスワードを設定してNext >ボタンをクリックします。

※ここで設定したパスワードは手順16のデータベースのリストアで使用します。

11. Portでは、PostgreSQLのポート番号を設定します。5432を設定してNext >ボタンをクリックします。

12. Advanced Optionsでは、PostgreSQLのロケールを設定します。LocaleからCを選択してNext >ボタンをクリックします。

13. Pre Installation Summaryでは、設定内容の確認を行いNext >ボタンをクリックします。

14. Ready to Installでは、Next >ボタンをクリックします。PostgreSQLのインストールが開始されます。

15. Completing the PostgreSQL Setup Wizardでは、FinishボタンをクリックしてPostgreSQLのインストールを完了します。

16. 手順1でバックアップしたデータベースのファイルをリストアするため、以下のコマンドを実行します。

cd C:\CREATE_HOME\PostgreSQL\bin

REM <バックアップファイル>は手順1のバックアップファイルを指定します
psql.exe -h localhost -p 5432 -U postgres -d postgres -f <バックアップファイル>

パスワードを要求されますので、手順10で設定したパスワードを入力します。

17. サービスの設定を変更するため、以下のコマンドを実行します。

net stop postgresql-x64-14
sc config postgresql-x64-14 DisplayName= "Create!WebFlow Database"
sc config postgresql-x64-14 obj= .\xfadmin password= y3dTaaHIAH
sc description postgresql-x64-14 "Create!WebFlow データベース"

18. クライアント認証の設定を変更するため、C:\CREATE_HOME\PostgreSQL\data\pg_hba.confファイルを開き、IPv4 local connectionsおよびIPv6 local connectionsの末尾にあるscram-sha-256を以下の通りmd5に変更します。

# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

19. アクセス権限を設定するため、以下のコマンドを実行します。

cacls C:\CREATE_HOME\PostgreSQL\data /T /E /C /G xfadmin:F

20. サービスを開始するため、以下のコマンドを実行します。

net start postgresql-x64-14

これでPostgreSQLのバージョンアップは完了です。

PostgreSQLのバージョンアップ後、以下のDB管理ユーザーが登録された状態となります。

ワークフローシステムのデータベースをメンテナンスする際は、xfadminユーザーを使用してください。

PostgreSQLのアップデートが終わったら、ワークフローシステムのアップデートの手順に進んでください。

# SQL Server

1. JDBCドライバをダウンロードします。SQL Server用のJDBCドライバをダウンロードし、任意のフォルダーへ配置します。

2. データベースのバックアップを行います。

3. SQL Server Management Studioを起動し、SAユーザーでログインします。

4. SQL Server Management Studio上でワークフローシステムのデータベースxfに以下のSQLファイルを実行します。

アップデート前の製品バージョンに合わせて、該当するSQLファイルを順に実行します。

Ver3.0からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v30tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver3.1からのバージョアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v31tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver3.2からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v32tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver3.3からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v33tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver4.0からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v40tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver4.1からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v41tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver4.2からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v42tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

Ver4.3からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_mssql_v43tov50.sql
2. (WEBFLOW_UPDATE)\server\sql\update_mssql_v50tov53.sql

SQLの実行が終わったら、ワークフローシステムのアップデートの手順に進んでください。

# Oracle

1. Oracle用のJDBCドライバをあらかじめダウンロードし、任意のフォルダーへ配置します。

2. データベースのバックアップを行います。

3. SQLPlusを起動し、更新するデータベースにSYSユーザー、SYSDBAとしてログインします。

4. update_oracle_v43tov50.sqlの157-158行目の<任意の表領域名>を利用環境に合わせて変更します。

【変更前】

CREATE USER XUDB2 IDENTIFIED BY xudb2 DEFAULT TABLESPACE "<任意の表領域名>" TEMPORARY TABLESPACE "TEMP;"`
ALTER USER "XUDB2" QUOTA UNLIMITED ON <任意の表領域名>;

【変更例】

CREATE USER XUDB2 IDENTIFIED BY xudb2 DEFAULT TABLESPACE "USERS" TEMPORARY TABLESPACE "TEMP";
ALTER USER "XUDB2" QUOTA UNLIMITED ON USERS;

5. SQLPlus上で、ワークフローシステムのデータベースに以下のSQLファイルを実行します。

アップデート前の製品バージョンに合わせて、該当するSQLファイルを順に実行します。

Ver3.0からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v30tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver3.1からのバージョアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v31tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver3.2からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v32tov33.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v33tov43.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
4. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver3.3からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v33tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver4.0からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v40tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver4.1からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v41tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver4.2からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v42tov43.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
3. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

Ver4.3からのバージョンアップ

1. (WEBFLOW_UPDATE)\server\sql\update_oracle_v43tov50.sql
2. (WEBFLOW_UPDATE)\server\sql\update_oracle_v50tov53.sql

SQLの実行が終わったら、ワークフローシステムのアップデートの手順に進んでください。

# ワークフローシステムのアップデート

1. コマンドプロンプトを起動し、アップデーターが配置されているフォルダーへカレントフォルダーを移動します。

REM (WEBFLOW_UPDATE)はアップデートする環境に合わせて変更してください
cd (WEBFLOW_UPDATE)\server

2. アップデーターを実行します。

cwf-update-v5.3.0.exe

3. アップデーターの指示に従ってアップデートを行います。

4. サービス Create!WebFlowのプロパティを表示し、スタートアップの種類を 自動(遅延開始) に変更します。

# Tomcatの設定変更

# アップデート前の設定を適用

Tomcatの設定変更についてを参照し、引き継がれない設定を再度設定しなおしてください。

# ポートレット表示オプションをご利用の場合

ポートレット表示オプションをご利用の場合、 [インストールフォルダー]/Tomcat/conf/context.xmlを以下の通り変更します。

【変更前】

<!-- <CookieProcessor className="org.apache.tomcat.util.http.Rfc6265CookieProcessor" sameSiteCookies="none" /> -->

【変更後】

<CookieProcessor className="org.apache.tomcat.util.http.Rfc6265CookieProcessor" sameSiteCookies="none" />

# データベースのメンテナンス

データベースのメンテナンスを行います。手順についてはワークフローシステム 逆引きガイド-サーバーのメンテナンス-データベースをメンテナンスするの以下を参照ください。

# PostgreSQL

不要領域の回収／統計情報の集計

# SQL Server

インデックスの再構成／再構築

# OSの再起動

1. Windows Server OSを再起動します。

2. ワークフローシステムにWebブラウザーでアクセスし、正しくログインできることを確認してください。

以上で、ワークフローシステムのアップデートは完了です。 フォームマネージャーのアップデートへ進んでください。

# リストア手順

アップデートの実施中に予期せぬ問題が発生した場合は、以下の手順により実施前の状態に戻すことができます。

1. ワークフローシステムの停止
2. 環境変数のリストア
3. サービスのリストア
4. インストールフォルダーのリストア
5. データベースのリストア
6. 組織情報のリストア
7. OSの再起動

# ワークフローシステムの停止

サービスCreate!WebFlow(Tomcat)を停止します。

# 環境変数のリストア

環境変数を元に戻すため、コマンドプロンプトで以下のコマンドを実行します。

REG DELETE "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v CWFSERVER_V5

レジストリ値 CWFSERVER_V5 を削除しますか? (Yes/No)のメッセージが表示されるので、yキーを入力して実行します。

# サービスのリストア

# ワークフローシステム

レジストリのバックアップでバックアップしたレジストリを元に戻すため、コマンドプロンプトで以下のコマンドを実行します。

REG IMPORT C:\cwf-backup\cwf_tomcat.reg
REG IMPORT C:\cwf-backup\cwf_service_TomcatCwf.reg
REG IMPORT C:\cwf-backup\cwf_service_TomcatXf.reg
REG IMPORT C:\cwf-backup\cwf_service_CreateWebFlow.reg

※バックアップ時に存在しなかったレジストリは実行不要です。

# データベース

1. サービスCreate!WebFlow Databaseを停止します。

2. サービスCreate!WebFlow Databaseを削除するため、以下のコマンドを実行します。

sc delete postgresql-x64-14

3. 旧バージョンのサービスCreate!WebFlow Databaseを元に戻すため、以下のコマンドを実行します。

旧バージョンがPostgreSQL8.3の場合

sc config pgsql-8.3 start= auto
sc config pgsql-8.3 DisplayName= "Create!WebFlow Database"
sc description pgsql-8.3 "Create!WebFlow データベース"

旧バージョンがPostgreSQL9.2の場合

sc config postgresql-9.2 start= auto
sc config postgresql-9.2 DisplayName= "Create!WebFlow Database"
sc description postgresql-9.2 "Create!WebFlow データベース"

# インストールフォルダーのリストア

1. エクスプローラーで、以下のバックアップフォルダーが存在することを確認します。 C:\CREATE_HOME\backup-cwf-update-v5.3.0

2. バックアップフォルダーとインストールフォルダーに、それぞれ以下のフォルダーが存在することを確認します。

3. 両方に存在するフォルダーのみ、インストールフォルダーから削除します。誤ってバックアップフォルダーを削除しないようにご注意ください。

4. 手順3で削除したフォルダーをバックアップフォルダーから移動し、置き換えます。

5. ドキュメントホームフォルダーをバックアップディレクトリから移動します。ファイルが存在するものは上書きしてください。

6. バックアップフォルダーが空になっていることを確認し、削除します。

# データベースのリストア

1. エクスプローラーで、データベースのバージョンアップ の手順4で作成した旧バージョンのPostgreSQLフォルダーが存在することを確認します。
   C:\CREATE_HOME\PostgreSQL_bak

2. PostgreSQLフォルダーC:\CREATE_HOME\PostgreSQLを削除します。

3. 旧バージョンのPostgreSQLフォルダーの名前を変更します。

# 組織情報のリストア

組織情報のバックアップファイルを移動します。

# OSの再起動

1. Windows Server OSを再起動します。

2. ワークフローシステムにWebブラウザーでアクセスし、ログイン画面に表示されるバージョン番号が旧バージョンであることを確認します。

3. ログインできることを確認します。