Introducción
Este documento describe el uso de la función switchDeviceType de BroadWorks.
Prerequisites
Requirements
No hay requisitos específicos para este documento.
Componentes Utilizados
Este documento no tiene restricciones específicas en cuanto a versiones de software y de hardware.
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
Antecedentes
Desde BroadWorks, versión 23.0 y posteriores, se introdujo un mecanismo para cambiar un tipo de perfil de dispositivo de uno a otro.
Opciones de uso
switchDeviceType
puede realizarse desde el BWCLI o el 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>
Ejemplo de laboratorio
Ejemplo de BWCLI
En este ejemplo, se cambia un groupDeviceProfile del tipo de dispositivo Poly_VVX_D230 al tipo de dispositivo Cisco-CP-78xx-88xx-68xx-3PCC.
- Agregue un perfil de dispositivo de grupo Poly_VVX_D230_Switch y asigne el dispositivo Poly_VVX_D230:
AS_CLI/System/Device/IpDeviceMgmt> add pws_ent pws_grp Poly_VVX_D230_Switch Poly_VVX_D230 macAddress 678678678678
- Realice el cambio del perfil Poly_VVX_D230_Switch a 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.]
Ejemplo de registro
Este es un ejemplo de registro para este tipo de solicitud visto desde 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>
Información Relacionada