Parent page: Altium Infrastructure Server のインストール
Altium Infrastructure Server には、定義済みのユーザー、ロール、LDAP Sync タスク、PLS および NIS サービスの構成(通常は、取得済み製品や拡張機能の一式、さらに後者のために定義されたデプロイメントパッケージの範囲も含む)など、重要なデータを保持できます。これらのデータの長期的な完全性を確保するための重要な要件は、バックアップを取得することです。標準の Altium Infrastructure Server インストールには、コマンドプロンプトからアクセスするバックアップ/復元ツールが含まれています。
バックアップツールの既定の場所は、フォルダー \Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\ 内です。
バックアップツールの名前は avbackup.exe です。
バックアップツールへのアクセス
ツールを使用するには:
-
Windows のコマンドプロンプトを起動します。
バックアップ/復元ツールを使用するには、Command Prompt を管理者モードで実行する必要があります。Windows 管理者として CMD プロンプトを実行していない場合、Infrastructure Server のバックアップまたは復元に関するコマンドを実行しようとすると、明確なメッセージ Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks が表示されます。
-
正しいフォルダーへ移動します。ホストコンピューターの C ドライブに既定のインストールを行っている場合、次の場所になります:
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\
-
ツールを実行して利用可能なオプションを一覧表示するには、プロンプトで次を入力します:
avbackup ?
Ctrl+V を使用してコマンドプロンプトへ貼り付けることはできませんが、右クリックメニューから貼り付けることは可能です。必要な文字列を先にコピーし、この方法で貼り付けることで、時間を節約しミスを防げます。
コマンドプロンプト(管理者として実行)からバックアップツールにアクセスしているところ。
? に注意してください。これを含めると、バックアップツールで利用可能な機能のヘルプが表示されます:
-
backup - データを ZIP アーカイブにバックアップします。
-
restore - ZIP アーカイブからデータを復元します。復元ポイントは自動的に作成されます。
-
help - ヘルプ画面を表示します(文字列 help の代わりに ? を使用できます)。
Zip アーカイブの内容
このツールは、Infrastructure Server 全体とユーザーデータをバックアップします。内容は次のとおりです:
-
Network Installation Service 経由で取得したインストールや LDAP Synch 設定を含む、データベースの完全バックアップ。
-
すべてのリビジョン。
-
検索インデックス。
-
ユーザー定義(カスタム)設定。
バックアップの構文とスイッチ
ツールのバックアップ機能を使用する際に利用できるスイッチは次のとおりです:
avbackup backup -z [-i] [-m]
-
-z - 作成する対象 zip ファイルのパスとファイル名。文字列にスペースが含まれる場合は引用符で囲みます。このスイッチは必須です。
-
-i - バックアップ対象の Altium Infrastructure Server の現在の場所を示す LocalVault.ini ファイルのパスと場所。このファイルの既定の場所は C:\Program Files (x86)\Altium\Altium Infrastructure Server\ です。このスイッチを指定しない場合、ツールはこの既定のインストール場所に基づいてファイルを自動的に見つけようとします。文字列にスペースが含まれる場合は引用符で囲みます。
-
-m - バックアップ処理をサイレント(-m silent))で実行するか、失敗時に再試行を促すダイアログ(-m dialog)を表示するかを指定できます。このスイッチを指定しない場合、サイレントモードが使用されます。
avbackup backup のみを入力すると、これらのスイッチが補助情報として一覧表示されます。
ツールをバックアップモードで使用する際に利用可能なスイッチ。
Backup Example
次の入力は、Altium Infrastructure Server をサイレントで 201704_Backup.zip という名前のファイルにバックアップし、そのファイルをフォルダー C:\Backups\Altium Infrastructure Server\ に書き込みます:
avbackup backup -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\LocalVault.ini"
指定するフォルダーは、あらかじめ存在している必要があります。また、新しいファイル名が既存ファイルと同じ場合、既存ファイルは上書きされます。
例のバックアップコマンドを実行した結果。
復元の構文とスイッチ
ツールの復元機能を使用する際に利用できるスイッチは次のとおりです:
avbackup restore -z [-i] [-m]
-
-z - 復元元となるバックアップ zip ファイルのパスとファイル名。文字列にスペースが含まれる場合は引用符で囲みます。このスイッチは必須です。
-
-i - Altium Infrastructure Server を復元する場所を示す LocalVault.ini ファイルのパスと場所。このファイルの既定の場所は C:\Program Files (x86)\Altium\Altium Infrastructure Server\ です。このスイッチを指定しない場合、ツールはこの既定のインストール場所に基づいてファイルを自動的に見つけようとします。文字列にスペースが含まれる場合は引用符で囲みます。
-
-m - 復元処理をサイレント(-m silent。既定モード)で実行するか、失敗時に再試行を促すダイアログ(-m dialog)を表示するかを指定できます。このスイッチを指定しない場合、サイレントモードが使用されます。
avbackup restore のみを入力すると、これらのスイッチが補助情報として一覧表示されます。
ツールを復元モードで使用する際に利用可能なスイッチ。
Restore Example
次の入力は、201704_Backup.zip という名前のバックアップ zip ファイルを使用して Altium Infrastructure Server をサイレントで復元し、そのファイルをフォルダー C:\Backups\Altium Infrastructure Server\ に書き込みます:
avbackup restore -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\LocalVault.ini"
例の復元コマンドを実行した結果。復元を実行する前に、ツールが最初に復元ポイント(現在の Altium Infrastructure Server インストールのバックアップ)を作成することに注意してください。
復元ポイント
バックアップツールは、Infrastructure Server の復元を開始する前に自動的に復元ポイントを作成します。これを行うために、バックアップツールは既存の Infrastructure Server をバックアップし、復元用 ZIP を次の場所にコピーします:
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\Backups\
ZIP は次の形式で命名されます: Backup_<Date>_<Time>.zip。
バックアップまたは復元中のエラー
バックアップまたは復元中に発生したエラーは、CMD ウィンドウ内に直接表示され、エラーログへのフルパス情報も併せて示されます:
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\errors.log
Infrastructure Server のバックアップまたは復元を行う際、エラーの詳細と errors.log ファイルへのフルパスは、CMD ウィンドウに直接表示されます。