Introdução
Este documento descreve o uso do recurso switchDeviceType da BroadWorks.
Pré-requisitos
Requisitos
Não existem requisitos específicos para este documento.
Componentes Utilizados
Este documento não se restringe a versões de software e hardware específicas.
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Informações de Apoio
A partir do BroadWorks, versão 23.0 e posterior, um mecanismo foi introduzido para comutar um tipo de perfil de dispositivo de um para outro.
Opções de uso
O switchDeviceType
pode ser executado a partir do BWCLI ou do comando 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}
Comando 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>
Esquema 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>
Exemplo de laboratório
Exemplo de BWCLI
Para este exemplo, alterne um groupDeviceProfile do tipo de dispositivo Poly_VX_D230 para o tipo de dispositivo Cisco-CP-78xx-88xx-68xx-3PCC.
- Adicione um perfil de dispositivo de grupo Poly_VX_D230_Switch e atribua o dispositivo Poly_VX_D230:
AS_CLI/System/Device/IpDeviceMgmt> add pws_ent pws_grp Poly_VVX_D230_Switch Poly_VVX_D230 macAddress 678678678678
- Efetue a alternância do perfil Poly_VX_D230_Switch para 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.]
Exemplo de registro
Este é um exemplo de log para esse tipo de solicitação visto no 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>
Informações Relacionadas