IRISアップグレードやインストールが失敗する場合の調査方法について
IRISアップグレードやインストールがうまくいかない場合、初めに以下の4点をご確認ください。
- インストーラーに問題はないか?
- 対象バージョンの最新インストーラー(キット)を使用しているか?
- サポート対象プラットフォームへのインストールを行っているか?
- インストールディレクトリパスに日本語を含んでいないか?
★1について
インストーラーのダウンロードに問題があったなどで、インストーラー自体に問題があり、インストールできないというケースがあります。
その場合は、インストーラーのハッシュ値(md5 checksum)を比較してファイルの同一性を確認するか、再ダウンロードしてインストールをお試しください。
インストーラーのハッシュ値は、WRCDirectのダウンロードページ にて対象の製品を選択してご確認いただけます。
例:
お持ちのインストーラーのハッシュ値は、以下のように確認します(Windowsの場合)。
c:\downloads\kits>CertUtil -hashfile IRIS-2023.1.1.380.0-win_x64.exe MD5
MD5 ハッシュ (対象 IRIS-2023.1.1.380.0-win_x64.exe):
a4a0ab3ee0adc0b7640c50dcab20fe5f
CertUtil: -hashfile コマンドは正常に完了しました。
★2について
WRCDirectのダウンロードページをご確認いただき、対象バージョンの最新インストーラーを使用しているかご確認ください。
特に、ビルド番号があっているか(古いものになっていないか)ご確認ください。
★3について
ご使用のOSが、InterSystems製品対象バージョンのサポート対象プラットフォームであるかをご確認ください。
IRIS 2023.1.x:
https://docs.intersystems.com/iris20231/csp/docbook/DocBook.UI.Page.cls?KEY=ISP_technologies#ISP_platforms
Caché 2018.1.x:
https://docs.intersystems.com/ens20181/csp/docbook/DocBook.UI.Page.cls?KEY=ISP_technologies#ISP_platforms
上記と異なるバージョンの場合は、URLの iris20231(Cachéの場合は ens20181) の個所を対象バージョンに変えてください。
IRIS2022.1.xの場合は、iris20221 になります。
★4について
インストール先のディレクトリ(フォルダ)パスに日本語を含んでいる場合、インストールに失敗します。
キットからインストールする場合は、「ディレクトリ名にUnicode文字を含めることはできません」のエラー、
サイレントインストール(自動インストール)の場合は、IRISInstall_<timestamp>.log(後述) に、「Transforming table Error.」のようなログが出力されて、インストールに失敗します。
IRISのインストール先ディレクトリ(+インスタンス名)には、日本語(Unicode文字)を含まないようお願いします。
上記3点、問題がない場合は各種ログを確認します。
・インストールログ
・messages.log(Cachéの場合は cconsole.log)
インストールログは、Windowsであれば、Windowsのシステムフォルダ(%WinDir%)内に、IRISInstall_<timestamp>.log が出力されますので、どのようなエラーによりインストールが失敗しているかをご確認ください。
※Linuxの場合:/var/log/isc/IRISInstall_<timestamp>.log
正常にインストールされている場合は、以下のようなログで終わります。
: ...: 製品 : IRIS -- インストールは正常に終了しました。 ...: Windows インストーラーにより製品がインストールされました。製品名: IRIS、製品バージョン: xxx、製品の言語: xxx、製造元: InterSystems Corporation、インストールの成功またはエラーの状態: 0 Exiting setup bootstrapper.
messages.log(Cachéの場合は cconsole.log)には、アップグレードを行った場合やインストール後のInterSystems製品の起動処理に問題があった場合に、何らかのエラーが記録されている場合があります。
messages.logは、<IRISのインストールディレクトリ>\mgr 下にあります。
ログを見ても原因がわからない場合は、バージョン情報とログを添付の上、InterSystemsカスタマーサポートセンターまでお問い合わせください。