3.8.3 バージョンアップ手順
ナビゲーション プラットフォームをバージョンアップする手順を示します。
- 〈この項の構成〉
-
(1) バージョンアップ対象データのバックアップ手順
バージョンアップ前の環境で次の手順を実施してください。
- 参考
-
手順内のプロパティやディレクトリについては,バージョンアップ対象の製品のマニュアルを参照してください。
-
任意の場所にバックアップ用フォルダを作成します。
-
バックアップ用フォルダ直下にcontentsフォルダを作成します。
-
次のとおりコマンドを実行して,contentsフォルダにすべての業務コンテンツをエクスポートします。
ナビゲーション プラットフォームインストールディレクトリ\bin\npexport バックアップ用フォルダのパス\contents\backupcontents.zip
-
バックアップ用フォルダ直下にhtdocsフォルダを作成します。
-
次のフォルダをバックアップ用フォルダ直下のhtdocsフォルダにコピーします。
ナビゲーション プラットフォーム インストールディレクトリ\PP\uCPSB\httpsd\htdocs\ucnpuserstaticfiles
-
手順5.でコピー元となったhtdocsフォルダにucnpuserstaticfiles以外のフォルダがある場合は,バックアップ用フォルダ直下のhtdocsフォルダにコピーします。
ただし,ucnpフォルダはコピーする必要はありません。
-
次のフォルダをバックアップ用フォルダ直下にコピーします。
ナビゲーション プラットフォームインストールディレクトリ\conf
-
プラグインを利用している場合にプラグインをバックアップします。
次の手順は,開発環境のバージョンアップの場合に実施してください。
次のバックアップ元フォルダを,バックアップ用フォルダにフォルダごとコピーしてください。
-
ナビゲーション プラットフォーム インストールディレクトリ\pluginSDK
-
ナビゲーション プラットフォームインストールディレクトリ\usrlib\sys
-
ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\CC\server\usrconf\ejb\uCNP_J2EE\usrconf.properties
-
ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\CC\server\usrconf\ejb\uCNP_J2EE\usrconf.cfg
-
リソースアダプタの設定ファイル(Connector属性ファイル)
開発環境で,cjsetpropコマンド実行時に指定した場所から取得してください。
実行環境のバージョンアップの場合,次のディレクトリもバックアップ用フォルダにバックアップしてください。
-
ナビゲーション プラットフォーム インストールディレクトリ\plugin_files
プラグインデータを別の場所に格納している場合は,「6.6.1 開発環境から受け取るファイル」を参照して,必要なファイルを取得し,バックアップしてください。
-
-
データベースの拡張回数を確認します。
次のフォルダ内に存在する「usr_contents_」から始まるファイルの数がDBを拡張した回数になるため,数を確認してください。
ナビゲーション プラットフォームインストールディレクトリ\PP\DB\AREA
-
ナビゲーション プラットフォームを停止します。
-
操作ログをバックアップします。
操作ログ機能を有効にしている場合は,この手順を実施してください。
次のバックアップ元フォルダを,バックアップ用フォルダにフォルダごとコピーしてください。
- バックアップ元フォルダ
-
ナビゲーション プラットフォームインストールディレクトリ\operationlogs
操作ログの格納フォルダは,ユーザプロパティファイル(ucnp_user.properties)のucnp.base.server.operationlog.pathプロパティで変更できます。プロパティの値をデフォルト値から変更している場合,プロパティの値で設定しているフォルダを対象にバックアップしてください。
-
ダッシュボードサーバのメモリ容量の設定をバックアップします。
ダッシュボード機能を利用している場合は,この手順を実施してください。
バックアップ用ディレクトリにelasticsearchフォルダを作成し,次のバックアップ元フォルダをフォルダごとコピーしてください。
- バックアップ元フォルダ
-
ナビゲーション プラットフォームインストールディレクトリ\PP\Elastic\elasticsearch\config
-
タスクをバックアップします。
ナビゲーション プラットフォームのコマンドを実行するタスクを作成している場合は,この手順を実施してください。
バックアップ用ディレクトリにtaskフォルダを作成し,ナビゲーションプラットフォームのコマンドを実行するタスクの設定をバックアップしてください。
(2) バージョンアップ前の環境のアンセットアップ手順
バージョンアップ対象の製品のマニュアルを参照して,アンセットアップします。
(3) バージョンアップ前の環境のアンインストール
アンセットアップが完了した環境で次の手順を実施してください。
-
バージョンアップ対象の製品のマニュアルを参照して,アンインストールします。
-
OSを再起動します。
-
ナビゲーション プラットフォーム インストールディレクトリに必要なログファイルなどが残っている場合は,削除する前にバックアップを取得します。
-
次のフォルダを削除します。
ナビゲーション プラットフォーム インストールディレクトリ
(4) JP1/Baseのバージョンアップ
JP1/Baseがセットアップされている環境の場合,次の手順を実施してください。
- 参考
-
手順内のJP1/Baseの操作については,マニュアル「JP1/Base運用ガイド」を参照してください。また,手順内のプロパティについては,バージョンアップ対象の製品のマニュアルを参照してください。
-
JP1/Baseをバージョンアップします。
JP1/Baseのバージョンアップ後は,必要に応じてJP1/Base関連のサービスの起動または再起動を実施してください。
-
バージョンアップ前のJP1/BaseがJP1/Base 11-00より前のバージョンの場合,JP1/Baseで設定しているJP1権限レベルを次のように変更します。
変更前
変更後
JP1_IMNP_Admin
HNP_Admin
JP1_IMNP_Editor
HNP_Editor
JP1_IMNP_User
HNP_User
(5) JP1/AOのバージョンアップ
JP1/AOと連携している環境の場合,次の手順を実施してください。
-
JP1/AOをバージョンアップします。
JP1/AOのバージョンアップ手順については,JP1/AOのマニュアルを参照してください。JP1/AOのバージョンアップ後は,必要に応じてJP1/AO関連のサービスを起動または再起動してください。
-
JP1/AOのサービス実行プラグインを使用している,かつ「表3-9 バージョンアップの対象となる製品」の項番1〜項番3のバージョンからバージョンアップする場合,ucnp.base.client.jp1ao.submittask.passwordfile.pathプロパティで指定したディレクトリを削除します。
(6) Eclipseのバージョンアップ
次の手順は,開発環境のバージョンアップの場合に実施してください。
-
バージョンアップ前にインストールしていたEclipseの設定をバックアップします。
-
バージョンアップ前にインストールしていたEclipseをアンインストールします。
-
新しいEclipseをセットアップします。
Eclipseのセットアップについては,マニュアル「ナビゲーション プラットフォーム 開発ガイド」を参照してください。
(7) ナビゲーション プラットフォームのインストール
インストール手順については,「3.5.2 新規インストール手順」を参照してください。
(8) ユーザセットアッププロパティファイルの見直し
バージョンアップ後のユーザセットアッププロパティファイル(ucnp_setup_user.properties)のサンプルファイルをコピーして,必要に応じて設定内容を変更します。サンプルファイルの格納場所とコピー先については,「8.3.2 ユーザセットアッププロパティファイルの格納先」を参照してください。
バージョンアップ前とバージョンアップ後では,利用できるプロパティに違いがあり,デフォルト値が変更になっているプロパティもあります。そのため,バックアップしたユーザセットアッププロパティファイルは使用しないでください。バージョンアップ前とバージョンアップ後のプロパティの違いの詳細については,「付録D バージョンアップ時に確認が必要なプロパティ一覧」を参照してください。
(9) ナビゲーション プラットフォームのセットアップ
セットアップ手順については,「4. ナビゲーション プラットフォームのセットアップ」を参照してください。
(10) データベースの拡張
バックアップの手順の際に確認したデータベースの拡張回数分だけ,npextendrdarea コマンド(データベースの拡張)を使ってデータベースを拡張します。
(11) バージョンアップ対象データのリストア
「(1) バージョンアップ対象データのバックアップ手順」でバックアップしたデータを,バージョンアップ後のナビゲーション プラットフォームにコピーすることで,バージョンアップ前の環境をリストアします。
-
バックアップしたユーザプロパティファイル(ucnp_user.properties)およびサービスプロパティファイル(ucnp_service.ini)を編集します。
バージョンアップ前に利用していたプロパティのうち,バージョンアップ後には利用できないものもあります。バージョンアップ前とバージョンアップ後のプロパティの違いを確認し,プロパティファイルを編集してください。バージョンアップ前とバージョンアップ後のプロパティの違いの詳細については,「付録D バージョンアップ時に確認が必要なプロパティ一覧」を参照してください。
-
ダッシュボード機能を利用している場合,バックアップしたダッシュボード機能のアクセスユーザ管理ファイルを次のファイルにコピーしてください。
- コピー元ファイル
-
バックアップディレクトリ\conf\kibana.htpasswd
- コピー先ディレクトリ
-
ナビゲーション プラットフォームインストールディレクトリ\conf
-
メッセージの内容をカスタマイズしている場合,ユーザメッセージプロパティファイルに,表示するメッセージを再設定します。
- 【「表3-9 バージョンアップの対象となる製品」の項番1〜項番3のバージョンからバージョンアップする場合】
-
バックアップしたユーザメッセージプロパティファイル(ucnp_message_user.properties)でカスタマイズしているメッセージを,移行後のユーザメッセージプロパティファイル(ナビゲーション プラットフォームインストールディレクトリ\conf\ucnp_message_user.properties)に設定してください。なお,日本語ロケールの場合,日本語版のユーザメッセージプロパティファイル(ucnp_message_user_ja.properties)に設定してください。
- 【上記以外の場合】
-
バックアップしたユーザメッセージプロパティファイルでカスタマイズしているメッセージを,バージョンアップ後のユーザメッセージプロパティファイルに設定してください。
バックアップしたユーザメッセージプロパティファイル
バージョンアップ後のユーザメッセージプロパティファイル
バックアップディレクトリ\conf\ucnp_message_user.properties
ナビゲーション プラットフォームインストールディレクトリ\conf\ucnp_message_user.properties
バックアップディレクトリ\conf\ucnp_message_user_ja.properties
ナビゲーション プラットフォームインストールディレクトリ\conf\ucnp_message_user_ja.properties
-
旧製品でJP1イベントと業務コンテンツを関連づけている場合,バックアップしたJP1イベント関連づけファイルを次のフォルダにコピーしてください。
- コピー元ファイル
-
バックアップディレクトリ\conf\ucnp_jp1event_mapping.txt
- コピー先ディレクトリ
-
ナビゲーション プラットフォームインストールディレクトリ\conf
-
ナビゲーション プラットフォームを再起動します。
-
バックアップしたユーザプラグインをコピーします。
実行環境の場合の手順は,「6.6 開発環境で作成したファイルの適用」を参照してください。ただし,「開発環境から受け取るファイル」については,「(1) バージョンアップ対象データのバックアップ手順」でバックアップしたデータに読み替えてください。
開発環境の場合は,次の表を基に環境を構築し直してください。
取得したファイル
リストア方法
ナビゲーション プラットフォーム インストールディレクトリ\pluginSDK
バックアップしたプラグインを次のディレクトリに上書きコピーしてください。
- コピー元ディレクトリ
-
バックアップディレクトリ\pluginSDK\plugin
- コピー先ディレクトリ
-
ナビゲーション プラットフォームインストールディレクトリ\pluginSDK\plugin
コピーしたあとに,マニュアル「ナビゲーション プラットフォーム 開発ガイド」にある,プラグインのビルドの説明を参照してください。
インストールディレクトリが変わっている場合,次のクラスパスを必要に応じて変更してください。
-
ナビゲーション プラットフォームインストールディレクトリ\lib\ucnppluginif.jar
-
ナビゲーション プラットフォームインストールディレクトリ\syslib\ucnpsys.jar
-
ナビゲーション プラットフォームインストールディレクトリ\lib\ucnpclasses.jar
-
ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\CC\client\lib\j2ee-javax.jar
ナビゲーション プラットフォームインストールディレクトリ\usrlib\sys
マニュアル「ナビゲーション プラットフォーム 開発ガイド」にある,ライブラリの追加の説明を参照してください。
ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\CC\server\usrconf\ejb\uCNP_J2EE\usrconf.properties
マニュアル「ナビゲーション プラットフォーム 開発ガイド」にある,J2EEサーバの設定項目の変更についての説明を参照してください。
ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\CC¥server\usrconf\ejb\uCNP_J2EE\usrconf.cfg
リソースアダプタの設定ファイル(Connector属性ファイル)
マニュアル「ナビゲーション プラットフォーム 開発ガイド」にある,データベースとの接続処理の追加の説明を参照してください。
-
バックアップした静的ファイルを次のフォルダにコピーします。
ナビゲーション プラットフォーム インストールディレクトリ\PP\uCPSB\httpsd\htdocs
コピー先のhtdocsフォルダ直下にあるucnpフォルダは,上書きしないでください。
-
次のとおりコマンドを実行して,業務コンテンツをインポートします。
ナビゲーション プラットフォームインストールディレクトリ\bin\npimport -d バックアップ用フォルダ\contents\backupcontents.zip
なお,npimportコマンド(業務コンテンツのインポート)がエラー終了し,KDCZ10382-Eメッセージが出力され,かつメッセージ内のアクセス権グループの名称が「Standard access permissions」と一致する場合は,「(15) npimportコマンド(業務コンテンツのインポート)でエラー終了した場合」の手順を実施してください。
(12) 操作ログのリストア
この手順は,操作ログ機能を有効にしている場合に実施してください。手順内の操作ログの格納フォルダは,ユーザプロパティファイル(ucnp_user.properties)のucnp.base.server.operationlog.pathプロパティで変更できます。適宜読み替えてください。
-
「表3-9 バージョンアップの対象となる製品」の項番1〜項番3のバージョンからバージョンアップする場合,操作ログのファイル名を変更します。
npconvertoplog(操作ログファイル名変更)コマンドを実行して操作ログのファイル名を変更してください。なお,コマンド実行の際の操作ログ格納ディレクトリには,操作ログのバックアップ用フォルダを指定してください。
-
ナビゲーション プラットフォームを停止します。
-
操作ログの格納フォルダ内のファイルをすべて削除します。
-
操作ログをコピーします。
操作ログの名称を変更したあと,次のとおりコピーしてください。
- コピー元
-
バックアップ用フォルダ以下の操作ログ
- コピー先
-
ナビゲーション プラットフォームインストールディレクトリ\operationlogs
操作ログをコピーしたあと,サービスプロパティファイル(ucnp_service.ini)に設定した時刻を過ぎるまで,レポーティング画面に解析結果は表示されません。
-
ナビゲーション プラットフォームを起動します。
(13) 検索用データの更新
検索用データを更新します。検索機能を有効にしていて,サービスプロパティファイルで検索用データの更新間隔を設定していない場合は,npupdatesearchdataコマンド(検索用データの更新)を実行して検索用データを更新してください。
(14) ダッシュボードサーバのメモリ容量の再設定
ダッシュボード機能を利用している場合は,この手順を実施してください。
-
次のファイルをテキストエディタで開く。
バックアップディレクトリ\elasticsearch\config\jvm.options.npsettings.txt
-
メモリサイズを確認する。
-XmsNNNNm(「NNNN」の部分は数値):最小サイズ(単位:MB)
-XmxNNNNm(「NNNN」の部分は数値):最大サイズ(単位:MB)
-
手順2.で確認したメモリサイズを指定して,次のコマンドを実行する。
ナビゲーション プラットフォームインストールディレクトリ\bin\npdashboardsetstoragememory 最小サイズ 最大サイズ
-
ダッシュボードサーバを起動する。
(15) タスクのリストア
ナビゲーション プラットフォームのコマンドを実行するタスクを作成している場合は,この手順を実施してください。
次のフォルダからナビゲーションプラットフォームのコマンドを実行するタスクの設定をリストアしてください。
バックアップディレクトリ\task
(16) npimportコマンド(業務コンテンツのインポート)でエラー終了した場合
npimportコマンド(業務コンテンツのインポート)がエラー終了し,KDCZ10382-Eメッセージが出力され,かつメッセージ内のアクセス権グループの名称が「Standard access permissions」と一致する場合は,次の手順を実施してください。
-
ユーザプロパティファイル(ucnp_user.properties)のucnp.base.server.acl.defaultacl.name.japaneseonlyにtrueを指定します。
-
ナビゲーション プラットフォームを再起動します。
-
次のとおりコマンドを実行して,業務コンテンツを再度インポートします。
ナビゲーション プラットフォームインストールディレクトリ\bin\npimport -d バックアップ用フォルダ\contents\backupcontents.zip
-
アクセス権グループの名称を変更します。
システム管理者権限でナビゲーション プラットフォームにログインし,アクセス権グループ「Standard access permissions」の名称を,「標準アクセス権限」および「Standard access permissions」以外の名称に変更します。アクセス権グループの名称を変更する方法については,「6.2 業務コンテンツへのアクセス権の設定(ディレクトリサーバによるユーザ認証を利用している場合)」を参照してください。
-
ユーザプロパティファイル(ucnp_user.properties)のucnp.base.server.acl.defaultacl.name.japaneseonlyにfalseを指定します。
-
ナビゲーション プラットフォームを再起動します。