内容

はじめに

前提条件

要　件

BroadWorksの設定

OCI-Pコマンド

使用オプション

ラボの例

ASでのプロビジョニング

XSP/ADPでのプロビジョニング

ログの例

関連情報

ドキュメンテーション

[ソフトウェア（Software）]

はじめに

このドキュメントでは、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