運用時のトラブル対処方法

IMAPSサーバ機能が使用できない。

原因1: IMAPSサーバ機能が停止している可能性があります。

対処1: imstartapplicationコマンドでIMAPSサーバ機能を起動させてください。

原因2: Webサーバが停止している可能性があります。

対処2: imstartserviceコマンドでIMAPSの各サービスを起動させてください。

アプリ一覧にアプリケーションが表示されない。

原因: セットアップ後はデフォルトでロール管理モードが有効になっているため、ロールが設定されていないアプリケーションはどのユーザーからも見えませんし、ロールが設定されていないユーザーはアプリケーションを見ることができません。

対処1: アプリケーションとユーザーに同じロールを付与してください。

対処2: imadmin aclmode disableコマンドでロール管理モードを無効にしてください。; 無効にすることにより、すべてのユーザーからアプリケーションが見えるようになります。

アプリケーションを登録／変更しようとすると「ERROR: FSP_INTS-MAPS_SVAPP: 10024: im-appdef.xmlが存在しません。」というエラーが出る

原因

アプリケーションを圧縮する際にフォルダごと圧縮したため、zipフォルダ内にフォルダができる形になっています。

IMAPSApp1.zip
└ IMAPSApp1
　　├ icon.png
　　├ im-appdef.xml
　　└ ...

対処

フォルダ内の全ファイルを選択して圧縮してください。

IMAPSApp1.zip
├ icon.png
├ im-appdef.xml
└ ...

エージェントログイン後、プッシュの初期化に失敗しましたと表示される。

原因: サーバ側でアプリ情報の登録ができていません。

対処

以下のコマンドでアプリ情報が登録できているか確認してください。

imadmin pushfjp list

アプリ情報が存在しない場合は、以下のコマンドでアプリ情報を作成してください。

imadmin pushfjp create -name com.fujitsu.imaps.agent

Windows版においてimadminコマンド実行時、パラメーターが「,」（カンマ）を含む場合、「ERROR: FSP_INTS-MAPS_SVCMD: 13003: パラメーターの指定に誤りがあります。」と出力されてエラーになる。

原因: Windowsのコマンドプロンプトでは、「,」（カンマ）はパラメーターの区切り文字として認識されるため適切に処理されません。

対処: 該当するパラメーターを「"」（ダブルクオーテーション）で囲んでください。; 例）; > imadmin user create -userid user1 -password pass1 -roles "role1,role2"

ネイティブアプリケーションやハイブリッドアプリケーションからのオンライン認証やパスワード変更時に、サーバのエラーで認証に失敗する。

原因

IMAPSサーバからエラーが通知されています。

アプリケーションでは以下の例外やエラーが発生します。

ネイティブアプリケーション
- Android：IMAPSAuthServerException
- iOS：IMAPSAuthServerError
ハイブリッドアプリケーション
- IMAPSAuthServerError

対処

以下の対処を行ってください。

IMAPS運用基盤サーバの状態を確認してください。
認証サーバとリポジトリサーバの状態を確認してください。

imstartapplicationコマンドまたはimstopapplicationコマンドが、「Cannot execute more than one instance of the same command at the same time.」と表示されて実行できない。

原因1: imstartapplicationコマンドまたは、imstopapplicationコマンドを同時に実行しています。

対処1: しばらくたってから、再度実行してください。

原因2: lockファイルが残っています。

対処2

以下のファイルを削除して再度実行してください。

/opt/FJSVimaps/bin/logs/LOCK

PCMI Error Code=1,101が発生する、またはimstartserviceでPCMIの起動時にタイムアウトが発生してしまう。

原因: 起動待ち時間を超過しています。

対処

プロファイルのパラメータを変更して起動待ち時間を増やしてください。

プロファイルは、IMAPSサーバに対して作成し、プロセスを管理するための定義情報をXML形式で記述します。

文字コード

UTF-8形式

格納先ディレクトリ

<製品データインストールフォルダー>\domainroot\pcmi\isje6\profile\profile.xml

/var/opt/FJSVimaps/domainroot/pcmi/isje6/profile/profile.xml

パラメーター

プロセス起動待ち時間

タグ: MaximumStartupTime
説明: 監視対象のプロセスの起動が完了するまでの待ち時間を指定します。起動が完了するまで処理を中断しない場合は、「0」を指定します。
範囲: 0～65535(秒)
省略値: 600

注意

このプロファイルはすべてのIMAPSサーバ機能に対して有効となるため、影響を考慮した上で編集してください。
登録したプロファイルの定義に誤りがあると、サービスが起動できません。
プロファイルの定義に誤りがある場合は、プロファイルの定義を修正し、サービスが起動可能な状態にしてください。
プロファイルを変更した場合は、次回の起動時から設定が有効となります。

PCMI: ERROR: PCMI1035が発生し、imstatusserviceコマンドで停止中にもかかわらずPCMIが起動できない。

原因: マシンの負荷が高くなり、IMAPSサーバが異常停止しています。

対処1: imstopserviceコマンドでIMAPSサーバサービスを停止してから、再度imstartserviceコマンドを実行してください。

対処2

プロファイルのパラメータを変更して生存通知監視時間を増やしてください。

プロファイルは、IMAPSサーバに対して作成し、プロセスを管理するための定義情報をXML形式で記述します。

文字コード

UTF-8形式

格納先ディレクトリ

<製品データインストールフォルダー>\domainroot\pcmi\isje6\profile\profile.xml

/var/opt/FJSVimaps/domainroot/pcmi/isje6/profile/profile.xml

パラメーター

生存通知監視時間

タグ: MonitoringTime
説明: IMAPSサーバの生存通知の監視時間を指定します。
範囲: 0～65535(秒)
省略値: 30

注意

このプロファイルはすべてのIMAPSサーバ機能に対して有効となるため、影響を考慮した上で編集してください。
登録したプロファイルの定義に誤りがあると、サービスが起動できません。
プロファイルの定義に誤りがある場合は、プロファイルの定義を修正し、サービスが起動可能な状態にしてください。
プロファイルを変更した場合は、次回の起動時から設定が有効となります。

ahsxxxxx: Address already in use・・・のメッセージが出力される

原因1: Webサーバの停止が完了する前に起動が開始されました。

対処1: Webサーバが停止していることを確認後、再度Webサーバを起動させてください。

原因2: Webサーバの起動時に既にポート番号が使用されています。

対処2: Webサーバに指定されているポート番号を使用しているプログラムを特定して停止してください。

ahsxxxxx: SSL: xxx revoked. のメッセージが出力される。

原因: 証明書が取り消されている可能性があります。

対処: メッセージに従い、新しい証明書を取得してください。; 証明書の更新方法は「運用ガイド」の「SSL環境の移行と証明書の更新」を参照してください。

ahsxxxxx: SSL: xxx expired. のメッセージが出力される

原因: 証明書の期限が切れている可能性があります。

対処: メッセージに従い、証明書を更新してください。; 証明書の更新方法は「運用ガイド」の「SSL環境の移行と証明書の更新」を参照してください。

WARNING: PCMI1304が発生する

原因: IMAPSサーバの停止時に表示されます。

対処: 特に必要ありません。

第3章 運用時のトラブル対処方法

第3章運用時のトラブル対処方法