はじめに
このドキュメントでは、OCI-Pコマンドと接続のテストに使用できる、シスコが提供するデモンストレーションクライアントの使用方法について説明します。
前提条件
要 件
- AsociclientはPCまたはサーバにインストールできます。
- 着信要求送信元のIPアドレスをBroadWorks Network Access Listに追加する必要があります。
- 有効なOCI-Pコマンドが必要です。
BroadWorksの設定
この例では、OCIenderToolはサーバ172.16.30.3でホストされています。
このIPがOCI-PネットワークアクセスリストAS_CLI/System/NetworkAccessLists/OCI/Provisioning>に追加されていることを確認します。
AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
============================
...
172.16.30.3 OCISenderTool
OCI-Pコマンド
この例では、エンタープライズpws_entとグループpws_grpに対してコマンド「GroupAccessDeviceGetListRequest」を使用します。
このファイルの名前は「pws_GroupAccessDeviceGetListRequest.xml」です。
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">%%%OCI_SESSION_ID%%%</sessionId>
<command xsi:type="GroupAccessDeviceGetListRequest" xmlns="">
<serviceProviderId>pws_ent</serviceProviderId>
<groupId>pws_grp</groupId>
</command>
</BroadsoftDocument>
使用オプション
このコマンドを実行するには、関連するパラメータを選択する必要があります。
[bwadmin@bwtaclab ASOCICLIENT]$ ./startASOCIClient.sh
**** OCI Client Build Version: 1.1.2
**** Usage:
startOCIClient configFile
startOCIClient loginId password [-i inputXMLFile] [-o outputXMLFile] [-h host] [-p port]
[-m {un}secure/{s}ecure] [-c BCCT/OCS] [-t timeOut] [-s sessionID] [-l loginRequestName] [-f tabSize]
loginId LoginId of the user (mandatory)
password Password of the user (mandatory)
-i inputXMLFile File containing the XML Request
-o outputXMLFile File to write the XML Response. File is over-written.
If not provided will default to: inputXMLFile.response.xml)
-h host HostName to connect to. Default is localhost
-p port Port to connect to. Default is 31000
-m mode Unsecure/Secure mode for login
-c connection BCCT or OCS
-t timeOut Timeout in seconds to pause for a response from the server.
(Default is 30 seconds, if set to -1 will never timeout)
-s sessionID session ID
-l loginRequest name of the login request, i.e. LoginRequest or LoginRequest22
-f tab size formats the response XML to make it pretty (off by default)
ラボの例
ASでのプロビジョニング
- AS(172.16.30.127)経由で要求をプッシュし、BCCT（ポート2220）を使用する場合のセットアップ例。
loginId - admin
password - admin
inputXMLFile - /Commands/pws_GroupAccessDeviceGetListRequest.xml
host - 172.16.30.127
port - 2220
connection - BCCT
bwadmin@bwtaclab ASOCICLIENT]$ ./startASOCIClient.sh admin admin -i
./Commands/pws_GroupAccessDeviceGetListRequest.xml -h 172.16.30.127 -p 2220 -c BCCT
**** OCI Client Build Version: 1.1.2
**** Start OCIClient initialization --> 2022.05.12 04:06:14:540 EDT
**** Sending request at: 2022.05.12 04:06:14:566 EDT
==========>
<?xml version="1.0" encoding="UTF-8"?>
<BroadsoftDocument protocol = "OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command xsi:type="LoginRequest22V3" xmlns="">
<userId>admin</userId>
<password>admin</password>
</command>
</BroadsoftDocument>
<==========================
**** Received response (Request process time: 176 ms)
==========>
<?xml version="1.0" encoding="UTF-8"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command echo="" xsi:type="LoginResponse22V3" xmlns="">
<loginType>System</loginType>
<locale>en_US</locale>
<encoding>ISO-8859-1</encoding>
<isEnterprise>false</isEnterprise>
<passwordExpiresDays>2147483647</passwordExpiresDays>
<userDomain>calo.cisco.com</userDomain>
<tokenRevocationTime>1616017564343</tokenRevocationTime>
</command>
</BroadsoftDocument>
<==========================
LoginRequest command successful
**** Reading request(s) from file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml
**** Writing response to file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml.response.xml
**** Sending request from file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml
at: 2022.05.12 04:06:14:745 EDT
==========>
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command xsi:type="GroupAccessDeviceGetListRequest" xmlns="">
<serviceProviderId>pws_ent</serviceProviderId>
<groupId>pws_grp</groupId>
</command>
</BroadsoftDocument>
<==========================
**** Received response (Request process time: 1304 ms)
==========>
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command echo="" xsi:type="GroupAccessDeviceGetListResponse"
....<snipped_response>...
XSP/ADPでのプロビジョニング
XSP/ADP(172.16.30.71)経由で要求をプッシュし、OCS（ポート2208）を使用する場合のセットアップ例。
loginId - admin
password - admin
inputXMLFile - /Commands/pws_GroupAccessDeviceGetListRequest.xml
host - 172.16.30.71
port - 2208
connection - OCS
./startASOCIClient.sh admin admin -i ./Commands/pws_GroupAccessDeviceGetListRequest.xml -h 172.16.30.71
-p 2208 -c OCS
ログの例
PSLogから見た、この要求タイプのログの例。
2022.05.12 03:43:05:463 EDT | FieldDebug | Generic | BCCT Worker #1
OCI Transaction com.broadsoft.oci.transactions.group.GroupAccessDeviceGetListTransaction read38257
executed.
User: Default Administrator (admin) Authorization Level: System
Start Time: 2022.05.12 03:43:03:616 EDT
End Time: 2022.05.12 03:43:05:463 EDT
Duration: 1847 ms
関連情報
ドキュメンテーション
BW-ASProvisioningInterfaceSpec
[ソフトウェア（Software）]
独立したリリース – Rel_2022_08_asociclient
リリース24:Rel_24_0_asociclient
リリース23:Rel_23_asociclient
リリース22:Rel_22_asociclient
フィードバック