スタートアップ コンフィギュレーションのキャプチャ
デバイスのスタートアップ コンフィギュレーションをキャプチャします。
ランニング コンフィギュレーションのキャプチャ
デバイスのランニング コンフィギュレーションをキャプチャします。
ランニング コンフィギュレーションのアップロード
指定されたコンテンツをデバイスのランニング コンフィギュレーションにアップロードおよびマージします。
スタートアップ コンフィギュレーションの書き込み
現在のデバイスのランニング コンフィギュレーションを、スタートアップ コンフィギュレーションに書き込みます。
デバイス再ロード
デバイスを再起動します。
再ロード キャンセル
デバイスでスケジュールされた再起動をキャンセルします。
デバイス ファームウェアのロード
デバイス上で、指定されたファームウェア イメージのロードを開始します。

OpenSSH デバイス ファミリを追加するデバイスを選択します。
デバイスを右クリックし、
［追加先］
-
［デバイス ファミリ］
を選択します。 
NCM OpenSSH デバイス ファミリを選択します。

ナビゲーション画面の［エクスプローラ］タブで設定マネージャを展開します。
［デバイス ファミリ］を右クリックし、［デバイス ファミリの作成］を選択します。
以下に示すように、［デバイス ファミリの作成］ダイアログ ボックスが表示されます。

［名前］フィールドに、固有の名前を入力します。
（オプション）説明およびセキュリティ文字列を入力します。
（オプション）［ランドスケープ］ボタンをクリックし、デバイス ファミリを配置するランドスケープを選択します。
特定のデバイスを検索するには、［検索オプション］ボタンを選択します。
［検索オプション］ダイアログ ボックスが表示されます。デバイス ファミリは、グローバル コレクションと同様に、手動でファミリに追加された静的メンバと、指定された検索条件を使用して自動的に追加された動的メンバの両方を所有することができます。詳細については、「OneClick 管理」を参照してください。
注：
1 つのデバイスは、1 つのデバイス ファミリのみに所属できます。同じデバイスに適用される検索条件が複数のデバイス ファミリに含まれている場合、最初にその検索を実行したデバイス ファミリにデバイスが含まれます。
完了したら、［OK］を選択します。
デバイス ファミリが作成され、ナビゲーション画面の［エクスプローラ］タブにある［デバイス ファミリ］に表示されます。これで静的メンバが追加できます。

デバイスを見つけます。
デバイスを右クリックし、［追加先］から［デバイス ファミリ］を選択します。
［デバイス ファミリの選択］ダイアログ ボックスが表示されます。
選択されたデバイスに関連付けるデバイス ファミリを選択します。
適切なデバイス ファミリが表示されない場合、［作成］をクリックしてカスタム デバイス ファミリを作成します。詳細については、「カスタム デバイス ファミリの作成」を参照してください。
これでデバイスは選択されたデバイス ファミリに関連付けられます。

ナビゲーション画面のデバイス ファミリを右クリックします。
［デバイス ファミリを更新］を選択します。
現在、デバイス ファミリに属していない場合、デバイス ファミリは検索条件に一致するすべてのデバイスを検索し追加します。

現在、デバイス ファミリに関連付けられていないデバイスを右クリックします。
［再設定］、［NCM デバイス ファミリの再評価］を選択します。
重要：
Cisco PIX デバイスでは、NCM デバイス ファミリの再評価機能はサポートされていません。
Network Configuration Manager はデバイスを再評価し、すぐに使用できるデバイス ファミリに属する必要があるかを特定します。
配置が適切であることを Network Configuration Manager が特定する場合、デバイスはデバイス ファミリに追加されます。

デバイス IP。
アップロードするコンテンツを含むファイルの絶対ファイル名 （アップロード操作のみ）。
デバイス ユーザ名。
デバイス パスワード。
デバイス有効化パスワード。

スタートアップ コンフィギュレーションのキャプチャ
このスクリプトでは、STDOUT バッファにデバイスのスタートアップ コンフィギュレーションを返す必要があります。バッファに返されるすべてのコンテンツは、デバイスのスタートアップ コンフィギュレーションであると見なされます。
ランニング コンフィギュレーションのキャプチャ
このスクリプトでは、STDOUT バッファにデバイスのランニング コンフィギュレーションを返す必要があります。バッファに返されるすべてのコンテンツは、デバイスのランニング コンフィギュレーションであると見なされます。
ランニング コンフィギュレーションのアップロード
このスクリプトは、絶対ファイル名パラメータによって識別されるファイルを読み取ります（詳細については、「デフォルトのスクリプト コマンド ライン パラメータ」を参照）。その後、ファイルのコンテンツをデバイスのランニング コンフィギュレーションにアップロードおよびマージします。
スタートアップ コンフィギュレーションの書き込み
このスクリプトにより、デバイスのランニング コンフィギュレーションがスタートアップ コンフィギュレーションに書き込まれます。
デバイス再ロード
このスクリプトはデバイスを再起動します。
再ロード キャンセル
このスクリプトは、デバイスで保留中またはスケジュールされた再起動をキャンセルします。
デバイス ファームウェアのロード設定
このスクリプトはデバイス上に新しいファームウェア イメージをアップロードし、このファームウェア イメージを使用して、デバイスを再ロードするために必要なすべての操作を実行します。

［エクスプローラ］タブでデバイス ファミリを選択します。
コンテンツ画面の［情報］タブに、情報および設定が表示されます。
デバイス設定の転送設定サブビューを展開します。
スクリプト操作サブビューが表示されます。
注：
Cisco IOS および Cisco IOS - SSH Capable デバイス ファミリの場合、デバイス ファームウェアのロード スクリプトは、デバイス ファームウェアの転送設定サブビューに存在します。
適切なスクリプト操作サブビューを展開します。
使用可能なスクリプト設定フィールドが表示されます。
スクリプト名の隣の［設定］を選択します。
［スクリプトの選択］ダイアログ ボックスが、以下の例のように表示されます。

以下のいずれかの手順を実行します。
使用するスクリプトが使用可能な場合、スクリプトを選択して［OK］を選択し、手順 10 に移動します。
選択されたデバイス ファミリのスクリプトをまだ作成していない場合、［作成］を選択してアップロードまたは作成します。
［スクリプト名］フィールドに、スクリプトの一意の名前を入力します。スクリプト名の下のフィールドにスクリプトを貼り付けるか、［インポート］を選択してシステムのローカルに保存されている設定ファイルをインポートします。
以下の例のとおり、スクリプト コンテンツが［スクリプト名］フィールドの下のフィールドに表示されます。

（オプション）必要に応じて、スクリプト コンテンツを編集します。または、［検索］フィールドに条件を入力し、スクリプト ファイルで特定の行を見つけます。
スクリプトのインポートおよび設定が完了したら、［OK］を選択します。
［スクリプトの選択］ダイアログ ボックスにスクリプト名が表示されます。
スクリプトを選択し、［OK］を選択します。
スクリプトがロードされ、［スクリプトの内容］フィールドに表示されます。
その他のスクリプト パラメータを追加します。
注：
詳細については、「追加のスクリプト コマンド ライン パラメータ」を参照してください。
［追加のスクリプト パラメータ］フィールドの下にある、［追加］を選択します。
［追加］ダイアログ ボックスが表示されます。
パラメータ名および値を入力します。操作が［アップロード］、またはタスクが［ファームウェアのロード］である場合、パラメータを設定して実行時に値を確認するプロンプトを表示させることができます。
［OK］ボタンをクリックします。
以下の例のとおり、パラメータが［追加のスクリプト パラメータ］フィールドに表示されます。

エラー コードのマッピングを追加します。詳細については、「エラー コードのマッピング」を参照してください。
［エラー コードのマッピング］フィールドの下にある、［追加］を選択します。
［追加］ダイアログ ボックスが表示されます。
［エラー コード］フィールドにエラー コード、および［エラー メッセージ］フィールドに対応するメッセージを入力し、［OK］を選択します。
以下の例のとおり、エラー コードが［エラー コードのマッピング］フィールドに表示されます。

これで設定スクリプトを実行できます。

$SPECROOT\NCM\config.xml に移動します。 
「ssh-library type」値を「jsch」（デフォルト値は「mindterm」）に設定します。
<ssh-library type="java.lang.String">mindterm</ssh-library> 
以下のように変更してください。 
<ssh-library type="java.lang.String">jsch</ssh-library>

$SPECROOT\NCM\config.xml に移動します。
jsch-read-datawait type の値を変更します。
<jsch-read-datawait type="java.lang.Integer">4</jsch-read-datawait> 
以下のように変更してください。 
<jsch-read-datawait type="java.lang.Integer">7</jsch-read-datawait>

Net::Telnet

Net::OpenSSH
Net::SSH
Net::SSH::Expect
Expect
Net::TFTP
Net::SCP
Net::FTP

/opt/SPECTRUM/lib/perl5

Windows
--
CA Spectrum
には完全な Perl インストールおよび Net::SSH::Expect モジュールが含まれています。
Linux
-- システムの個別の場所に Perl をインストールし、Perl を使用するために
CA Spectrum
を設定する必要があります。

Perl をインストールします。
CA Spectrum
 には Cygwin の完全な Perl のバージョンが付属しているため、Net::SSH::Expect モジュールに基づくスクリプトを使用する場合、さらにインストールする必要はありません。
他のモジュールに基づくスクリプトを使用する場合、使用しているモジュールに応じて、以下のいずれかを完了します。
Perl モジュールが Cygwin 以外の Perl のバージョンと互換性のある場合、SpectroSERVER マシン上に特定の Perl をインストールして、特定の Perl モジュールをインストールし、特定の Perl インストールを使用するために
CA Spectrum
 を設定することをお勧めします （「カスタム Perl インストールを使用する CA Spectrum の設定」を参照してください）。
インストールする Perl モジュールが Cygwin の Perl のみと互換性があり、それが変更モジュール（つまり、C ライブラリのコンパイルが不要）である場合、
CA Spectrum
の Perl インストールに追加できます。<Module_Name>.pm ファイルを $SPECROOT/NT-Tools/SRE/lib/perl5/site_perl/5.8 に配置するだけです。
インストールする Perl モジュールが Cygwin の Perl のみと互換性があり、C ライブラリのコンパイルが必要な場合、このモジュールはコンパイルされ、
CA Spectrum
に付属している必要があります。この拡張機能要求については、
CA Spectrum
サポートに連絡してください。
SSH ベースの Perl モジュールおよび SSH プログラムをインストールします。
CA Spectrum
 には、Net::SSH::Expect （およびそれに必要な）モジュールおよび ssh プログラム（Net::SSH::Expect に必要）が付属しています。このモジュールを使用してスクリプトを開発する方法の手順については、www.cpan.org にある Net::SSH::Expect のドキュメントを確認してください。
カスタム Perl インストールを使用するために 
CA Spectrum
を設定します。
CA Spectrum
の Perl はこの目的のためセットアップされているため、カスタム Perl インストールを使用するように
CA Spectrum
を設定する必要はありません。

Perl をインストールします。
OS にはすでに Perl がインストールされています（/usr/bin/ を確認します）。この事前にインストールされた Perl は、Network Configuration Manager のスクリプトに使用できます。
SSH ベースの Perl モジュールおよび SSH プログラムをインストールします。
Net::SSH::Expect モジュール、依存するモジュール、および ssh ユーティリティをダウンロードおよびインストールする必要があります。
Net::SSH::Expect の依存関係ツリーは以下のとおりです。
Net::SSH::Expect -> Expect -> IO::Pty
ここで「->」は「必要とする」関係を表します。
www.cpan.org からこれらのモジュールをすべてダウンロードできます。
必ず上記でインストールしたカスタム Perl の領域にこれらのモジュールをインストールします。
以下のようにモジュールをインストールしている場合、Perl バイナリのフル パスを指定することでこれを実行できます。
<PERL_FULL_PATH>/perl Makefile.pl
注：
一部の Perl モジュールは C/C++ コード ライブラリに依存します。このようなモジュールをインストールするには、ライブラリにリンクできるように gcc コンパイラをインストールする必要があります。最新の gcc パッケージを追加するために RPM を使用して、gcc コンパイラをインストールできます。
SSH ベースの Perl モジュールおよび SSH プログラムをインストールします。
Net::OpenSSH モジュール、依存するモジュール、および ssh ユーティリティをダウンロードおよびインストールする必要があります。
Net::OpenSSH の依存関係ツリーは以下のとおりです。
Net::OpenSSH -> IO::Pty -> File::Path
ここで「->」は「必要とする」関係を表します。
www.cpan.org からこれらのモジュールをすべてダウンロードできます。
必ず上記でインストールしたカスタム Perl の領域にこれらのモジュールをインストールします。
以下のようにモジュールをインストールしている場合、Perl バイナリのフル パスを指定することでこれを実行できます。
<PERL_FULL_PATH>/perl Makefile.pl
注：
一部の Perl モジュールは C/C++ コード ライブラリに依存します。このようなモジュールをインストールするには、ライブラリにリンクできるように gcc コンパイラをインストールする必要があります。最新の gcc パッケージを追加するために RPM を使用して、gcc コンパイラをインストールできます。 
カスタム Perl インストールを使用するために 
CA Spectrum
を設定します。
「カスタム Perl インストールを使用する CA Spectrum の設定」を参照して、上記の手順 1 で Perl をインストールした領域を 
CA Spectrum
で指し示します。
制限事項

Spectrum NCM OpenSSH は Windows プラットフォームをサポートしていません。

指定のランドスケープで、［カスタム Perl を使用］を有効に設定します。
カスタム Perl の領域の使用を有効にすると、カスタム Perl ディレクトリを指定します。
注：
カスタム Perl のディレクトリには、perl.exe （Windows）または Perl プログラム（Linux）が含まれるディレクトリのフル パス名が含まれている必要があります。

Perl モジュールが Cygwin 以外の Perl のバージョンと互換性のある場合、SpectroSERVER マシン上に特定の Perl をインストールして、特定の Perl モジュールをインストールし、特定の Perl インストールを使用するために
CA Spectrum
 を設定することをお勧めします （「カスタム Perl インストールを使用する CA Spectrum の設定」を参照してください）。
インストールする Perl モジュールが Cygwin の Perl のみと互換性があり、それがテキスト ベースのモジュール（つまり、C ライブラリのコンパイルが不要）である場合、
CA Spectrum
の Perl インストールに追加できます。<
Module_Name
>.pm ファイルを
$SPECROOT/NT-Tools/SRE/lib/perl5/site_perl/5.8 に配置するだけです。
インストールする Perl モジュールが Cygwin の Perl のみと互換性があり、C ライブラリのコンパイルが必要な場合、このモジュールはコンパイルされ、
CA Spectrum
に付属している必要があります。この拡張機能要求については、
CA Spectrum
サポートに連絡してください。

ナビゲーション画面で［設定マネージャ］を選択します。
コンテンツ画面で［情報］タブを選択します。
情報および設定が表示されます。
設定スクリプトのインポート/エクスポート サブビューを展開します。
［スクリプトのインポート］ボタンおよび［スクリプトのエクスポート］ボタンが表示されます。

［スクリプトのエクスポート］を選択します。
［エクスポートするスクリプトの選択］ダイアログ ボックスが表示されます。
エクスポートされるスクリプトを選択します。または、複数のスクリプトを選択します。
［名前を付けて保存］ダイアログ ボックスが表示されます。
保存する場所を選択し、エクスポート時に自動的に生成される XML 仕様ファイルの名前を入力します。エクスポート処理では、指定された名前および拡張子 .pl を使用して、選択された各 Perl スクリプトにファイルが生成されます。またエクスポート処理では、エクスポートされたスクリプトのリストおよびそれぞれのエラー マッピング情報を含む XML 仕様ファイルも生成されます。その後、この XML 仕様ファイルは、同じまたは異なる 
CA Spectrum
環境上でスクリプトをインポートするのに使用できます。
選択された Perl スクリプトは、指定した場所にエクスポートされます。

ナビゲーション画面で［設定マネージャ］を選択します。
コンテンツ画面で［情報］タブを選択します。
情報および設定が表示されます。
設定スクリプトのインポート/エクスポート サブビューを展開します。
［スクリプトのインポート］ボタンおよび［スクリプトのエクスポート］ボタンが表示されます。
［スクリプトのインポート］を選択します。
［開く］ダイアログ ボックスが開きます。
Network Configuration Manager にインポートされる Perl スクリプトを記述する XML 仕様ファイルを選択します。事前に 
CA Spectrum
からエクスポートされたスクリプトをインポートしている場合、エクスポート時に生成された XML 仕様ファイルを使用できます。
また XML 仕様ファイルは、以下の例に示されるフォーマットに従って手動で生成することもできます。
<scripts>
  <script>
    <file-name>ABC_Vendor_Capture_Running_Configuration.pl</file-name>
    <display-name>ABC Vendor Capture Running Configuration</display-name>
    <error-message errorCode="255">Usage</error-message>
    <error-message errorCode="99">Invalid Enable Password</error-message>
    <error-message errorCode="98">Unexpected Response</error-message>
    <error-message errorCode="97">Illegal Telnet Timeout Value</error-message>
  </script>
  <script>
    <file-name>XYZ_Vendor_Capture_Running_Configuration.pl</file-name>
    <display-name>XYZ Vendor Capture Running Configuration</display-name>
    <error-message errorCode="255">Usage</error-message>
    <error-message errorCode="99">Response Timed out</error-message>
    <error-message errorCode="50">Connection Error</error-message>
  </script>
  <script>
    <file-name>XYZ_Vendor_Capture_Startup_Configuration.pl</file-name>
    <display-name>XYZ Vendor Capture Startup Configuration</display-name>
  </script>
</scripts>
file-name
インポートされる Perl ファイルの名前。インポート時に、XML 仕様ファイルと同じディレクトリにファイルが置かれている必要があります。
display-name
このスクリプトを識別するために OneClick で使用される名前。
error-message
（オプション）エラーが発生した場合に OneClick に表示されるテキスト形式のエラー メッセージへの、スクリプトによって返されるエラー コードのマッピングを示します。それぞれのスクリプトに複数のエラーメッセージ エレメントを指定することができます。
Perl スクリプト XML がインポートされました。デバイス ファミリで Network Configuration Manager の操作を設定すると、スクリプトが利用可能になります。
注：
インポート処理では、スクリプトとデバイス ファミリの関連付けは行われません。

$SPECROOT>NCM>config.xml

ファイルに移動し、「thread-timeout-value type」を探します。

デフォルトでは、この値は以下のように 300 に設定されています。 

<thread-timeout-value type="java.lang.Integer" ><300>< / thread-timeout-value> 

設定を変更し、以下のように値を増やします。 

<thread-timeout-value type="java.lang.Integer" ><increased value in seconds>< / thread-timeout-value>