BroadWorks switchDeviceType機能の使用

概要

このドキュメントでは、BroadWorks switchDeviceType機能の使用方法について説明します。

前提条件

要件

このドキュメントに関する固有の要件はありません。

使用するコンポーネント

このドキュメントの内容は、特定のソフトウェアやハードウェアのバージョンに限定されるものではありません。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

BroadWorksリリース23.0以降では、デバイスプロファイルタイプを別のタイプに切り替えるメカニズムが導入されました。

使用オプション

「 switchDeviceType   BWCLIまたはoci-pコマンドから実行できます。 SystemDeviceManagementSwitchDeviceTypeDeviceRequest.

BWCLI

AS_CLI/System/Device/IpDeviceMgmt> help switchDeviceType

This command is used to switch device profiles from one device type to another.

Parameters description:
attribute : The name of the attribute that scopes the command.
system : This parameter specifies the switch command is issued at the system level.
fromDeviceType : This parameter specifies the original device type.
toDeviceType : This parameter specifies the destination device type.
serviceProvider : This parameter specifies the switch command is issued at the service provider level.
svcProviderId : This parameter specifies the ID of the service provider.
group : This parameter specifies the switch command is issued at the group level.
groupId : This parameter specifies the valid group within the service provider.
systemDeviceProfile : This parameter specifies the switch command is issued for a single device profile at the system level.
deviceName : This parameter specifies the name of the device profile.
svcProvDeviceProfile: This parameter specifies the switch command is issued for a single device profile at the service provider level.
groupDeviceProfile : This parameter specifies the switch command is issued for a single device profile at the group level.

======================================================================
switchDeviceType
<attribute>, Choice = {system, serviceProvider, group, systemDeviceProfile, svcProvDeviceProfile, groupDeviceProfile}
system:
<fromDeviceType>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}
serviceProvider:
<svcProviderId>, String {1 to 30 characters}
<fromDeviceType>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}
group:
<svcProviderId>, String {1 to 30 characters}
<groupId>, String {1 to 30 characters}
<fromDeviceType>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}
systemDeviceProfile:
<deviceName>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}
svcProvDeviceProfile:
<svcProviderId>, String {1 to 30 characters}
<deviceName>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}
groupDeviceProfile:
<svcProviderId>, String {1 to 30 characters}
<groupId>, String {1 to 30 characters}
<deviceName>, String {1 to 40 characters}
<toDeviceType>, String {1 to 40 characters}

OCI-Pコマンド

<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">SESSIONID</sessionId>
<command xsi:type="SystemDeviceManagementSwitchDeviceTypeDeviceRequest" xmlns="">
<svcProviderId>YOUR ENT/SP</svcProviderId>
<groupId>YOUR GROUP</groupId>
<deviceName>ORIGINAL DEVICE TYPE</deviceName>
<toDeviceType>NEW DEVICE TYPE</toDeviceType>
</command>
</BroadsoftDocument>

XMLスキーマ

<xs:complexType name="SystemDeviceManagementSwitchDeviceTypeDeviceRequest">
<xs:annotation>
<xs:appinfo>
<bwAppInfo bwtag="_1843b06e76464254bf146a91622df7b4"/>
<asDataModeSupported>true</asDataModeSupported>
<amplifyDataModeSupported>true</amplifyDataModeSupported>
<xsDataModeSupported>true</xsDataModeSupported>
</xs:appinfo>
<xs:documentation>
Switch the device type for a specified device.
To switch a system level device profile, serviceProviderId and groupId should not be present.
To switch a service provider level device profile, only serviceProviderId should be specified.
To switch a group level device profile, serviceProviderId and groupId should specified.
The response is either a SuccessResponse or an ErrorResponse.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="core:OCIRequest">
<xs:sequence>
<xs:choice minOccurs="0">
<xs:element name="serviceProviderId" type="ServiceProviderId"/>
<xs:sequence>
<xs:element name="svcProviderId" type="ServiceProviderId"/>
<xs:element name="groupId" type="GroupId"/>
</xs:sequence>
</xs:choice>
<xs:element name="deviceName" type="AccessDeviceName"/>
<xs:element name="toDeviceType" type="AccessDeviceType"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>

ラボの例

BWCLIの例

この例では、groupDeviceProfileをPoly_VVX_D230デバイスタイプからCisco-CP-78xx-88xx-68xx-3PCCデバイスタイプに切り替えます。

• グループデバイスプロファイルPoly_VVX_D230_Switchを追加し、デバイスPoly_VVX_D230を割り当てます。

AS_CLI/System/Device/IpDeviceMgmt> add pws_ent pws_grp Poly_VVX_D230_Switch Poly_VVX_D230 macAddress 678678678678

• プロファイルPoly_VVX_D230_SwitchからCisco-CP-78xx-88xx-68xx-3PCCへの切り替えを実行します。

AS_CLI/System/Device/IpDeviceMgmt> switchDeviceType groupDeviceProfile pws_ent pws_grp 
Poly_VVX_D230_Switch Cisco-CP-78xx-88xx-68xx-3PCC
...Done
[Request for switch is being processed; Rebuild triggered for device type: Cisco-CP-78xx-88xx-68xx-3PCC, 
 please refer to DMEventQueues for completion status.]

ログの例

これは、PSLogから見た、この要求タイプのログ例です。

2022.05.26 09:34:57:686 EDT | Info | OCI-P | BCCT Worker #0

Received the following request from: 127.0.0.1:56212
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">16535720065220.14787900206648874</sessionId>
<command xsi:type="SystemDeviceManagementSwitchDeviceTypeDeviceRequest" xmlns="">
<svcProviderId>pws_ent</svcProviderId>
<groupId>pws_grp</groupId>
<deviceName>Poly_VVX_D230_Switch</deviceName>
<toDeviceType>Cisco-CP-78xx-88xx-68xx-3PCC</toDeviceType>
</command>
</BroadsoftDocument>

2022.05.26 09:34:57:711 EDT | FieldDebug | Generic | BCCT Worker #0

OCI Transaction com.broadsoft.oci.transactions.system.SystemDeviceManagementSwitchDeviceTypeDeviceTransaction write5193 executed.
User: Default Administrator (admin) Authorization Level: System
Start Time: 2022.05.26 09:34:57:687 EDT
End Time: 2022.05.26 09:34:57:711 EDT
Duration: 24 ms

2022.05.26 09:34:57:711 EDT | Info | OCI-P | BCCT Worker #0 | admin

TO 127.0.0.1:56212
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">16535720065220.14787900206648874</sessionId>
<command echo="" xsi:type="c:SuccessResponse" xmlns:c="C" xmlns=""/>
</BroadsoftDocument>

関連情報

• DeviceProfileTypeCustomizationEnhancements-AS-FD
• シスコテクニカルサポートおよびダウンロード