インストール・アップグレード・ロールバックの確認
まず、問題がダウンロード、インストール、起動、接続のどの段階で発生したかを特定します。前の段階が完了しているなら、次の段階を調べてください。すべての問題をインストーラーのせいにしないようにしましょう。
01 · インストール前
システム情報と旧版の入手元を記録する
自分や同僚の端末にインストールする場合は、対象デバイスのOSバージョン、アーキテクチャ、選んだファイル名を先に記録してください。同じPCで複数の端末用にインストーラーを準備すると、ダウンロード履歴から似た名前の別アーキテクチャのファイルを選び間違えやすくなります。ファイル名と対象端末を対応づけ、デスクトップ版と従来版、チップのアーキテクチャ、同じクライアントの2種類のモバイル用パッケージを区別してください。
新規インストールでは、インストーラーと自分の設定の入手元を用意します。アップグレードの場合は、旧クライアントを開き、バージョン、画面の種類、インストール元、カスタムデータの保存場所を記録してください。サブスクリプション、手動追加したノード、ルーティング、ローカルポートを分けて記録します。サブスクリプションのURLだけでは、通常すべての設定を復元できません。設定やエクスポートファイルには機密情報が含まれる場合があるため、自分で管理できる場所に保管し、公開するトラブル報告のスクリーンショットには添付しないでください。
組織がPCを一元管理している場合は、アカウントにインストール権限があるか、アプリをどのフォルダーにインストールするか、プロキシ設定が組織から一括配布されているかを確認してください。権限がない場合、何度も展開したり同じアーキテクチャの別パッケージに替えたりしても、インストール制限は解除できません。別のフォルダーで試行を繰り返すより、エラー全文を端末管理者に伝えるほうが問題を特定しやすくなります。
02 · インストール中
エラー内容からアーキテクチャ、依存関係、上書き時の競合を切り分ける
インストーラーに「デバイスと互換性がありません」と表示された場合は、システム情報に戻ってアーキテクチャを確認してください。アーキテクチャが合っているのに対応していないと表示される場合は、OSのバージョンやパッケージに必要なランタイムを調べます。パッケージ管理ツールに依存関係と必要なバージョン範囲が表示されている場合は、その情報を手がかりにしてください。漠然と「OSが古い」と決めつけないようにしましょう。
ダウンロード後に圧縮ツールで開けない場合は、ブラウザーのダウンロードが完了していること、今回ダウンロードしたファイルを開いていることを確認してください。同名の古いファイルや、未完了の一時ファイルを開いている可能性もあります。外側のアーカイブはすべて展開し、ディスクイメージは開いてからアプリをコピーし、パッケージはシステムのインストーラーで処理してください。拡張子を手動で変更しても、ファイル形式は変換されません。
同じアプリの上書きインストールに失敗した場合は、新旧の配布元とバージョンを比較してください。署名の競合がエラーに示されている場合、ユニバーサル版に替えても解決しません。バージョンのロールバックが原因なら、誤って古いパッケージを選んでいないか確認してください。アンインストールが必要な場合は、データをエクスポート済みで復元できることを先に確認します。アプリを削除するとローカルデータも消えることがあるため、最初の検証手段としてアンインストールを選ぶのは避けてください。
03 · 初回起動
まず画面が起動することを確認してから設定をテストする
インストール後は今回のインストール先からクライアントを起動し、メイン画面が表示され、バージョン情報を確認できることを確かめます。デスクトップのウィンドウを閉じても、プログラムがタスクトレイやメニューバーに残る場合があります。再度起動する前に、すでにプロセスが動いていないか確認してください。起動直後に終了する場合は、エラーと終了前に行った操作を記録し、問題を調べる前に古い設定をすべてインポートしないでください。
画面が使えることを確認したら、サブスクリプションのインポート手順に沿って設定を追加します。動作確認済みの設定を1つ選び、クライアントから接続できることを確認してください。設定一覧が表示されても、インポートに成功したことしか分かりません。ネットワーク通信が想定どおりプロキシ経由になっているとは限りません。接続を開始できない場合はクライアントのログを確認し、接続できるのにWebページを開けない場合はインターネットに接続できない場合の対処を確認してください。
一部のアプリだけ挙動が異なる場合は、影響を受けるアプリと、システムプロキシが有効かどうかを記録してください。アプリによっては独自のプロキシ設定を使い、システムの設定を参照しないことがあります。他の条件は変えずに同じアプリで接続前後を比較し、ルーティングと通信の振り分けを確認してください。接続設定とルーティング設定を同時に変えると、結果を判断しにくくなります。
04 · アップグレード
復元できるデータを確保してから旧版を置き換える
バックアップ機能がある場合は、クライアントのバックアップまたはエクスポート機能を優先して使います。生成したファイルはプログラムのフォルダー以外に保存し、作成時のバージョン、含まれる設定、手動で再設定する項目を記録してください。別のクライアントに移行する際、アプリデータ一式を新しいクライアントのフォルダーにそのまま上書きしないでください。バックアップの構造や項目はクライアントごとに異なる場合があります。
切り替える前に旧プログラムを終了し、旧プログラムが設定したシステムプロキシを無効にしてから新版を起動します。復元後は、設定がすべて揃っているか、カスタムポートが維持されているか、OS起動時の実行設定が旧版の場所を参照していないかを確認してください。動作テストが終わるまで、旧フォルダーをすぐに削除しないでください。2つのプログラムを一時的に残す必要がある場合も、同時に起動したり、同じ設定ファイルに書き込ませたりしないでください。
ロールバックする場合は、旧バージョンに対応したバックアップを優先して使ってください。新版で保存したデータは、旧版では読み込めない場合があります。ロールバック後は、まず設定を1つ復元してテストし、その後グループやカスタムルートを戻してください。同じネットワークで旧版と新版のどちらでも同じ症状が出る場合、パッケージを何度も替えても効果は期待できません。接続、サブスクリプション、システムプロキシの該当項目を確認してください。