Understøttede telefoner oprettes automatisk og tildeles til brugere i Webex Calling af klargøringsværktøjet. Telefoner, der er markeret "Ja" i kolonnen "Understøttet i værktøjet til flytning af enhed", flyttes også automatisk fra Cisco BroadWorks eller BroadCloud til Webex Calling, når værktøjet til flytning af enhed kører. Telefoner, der er markeret "Nej" i den pågældende kolonne, skal have en manuel indgriben for at ændre DMS-URL-adressen i Cisco BroadWorks-enhedsskabelonen eller i selve telefonen.

Den sidste kolonne angiver tilknytningen af telefonmodeller til kolonnen "Enhedstype" i filen transform-tool/input/newphones.csv. (Se afsnittet Transformationsværktøj i denne artikel for yderligere oplysninger om newphones.csv).

Partneradministratorer kører dette værktøj til tokengenerator mindst én gang, før de begynder at køre migreringsværktøjer. Kørsel af dette værktøj er en engangsaktivitet, når partnerkontoen er onboardet i RTM-løsningen til engroshandel. Dette værktøj giver partneradministratorer mulighed for at logge på via webbrowser for at få den entydige TOKEN, der er nødvendig for at opdatere til partnerkonfigurationsfilerne for migreringsværktøjerne.

Forudsætninger

Installer Java 8, 11, 17 eller 21 på computeren. Java er tilgængelig fra mange kilder, herunder:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

Når du har downloadet, skal du udtrække binærerne til migrationsværktøjet.

Vejledning til at køre

Kør følgende kommando i terminalen inde i tokengeneratorens mappe:

Windows:

token_generator.bat

MacOS:

./token_generator.sh

Visning:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

Åbn URL-adressen i webbrowseren på terminalen, log ind med legitimationsoplysningerne for partneradministratoren for at få TOKENET, og kopiér det samme til yderligere brug.

Illustrationerne i brugergrænsefladen er angivet nedenfor som reference:

Figur 3: Log ind med Cisco Webex

Figur 4: Vinduet med legitimationsoplysninger

Figur 5: Generering af token

Konfigurer følgende trin, før du kører værktøjerne til udtræk og flytning af enheder på den sekundære BroadWorks-server.

Aktivér OCI-P-forbindelse

Værktøjet til flytning af enheden kommunikerer med BroadWorks via OCI-P-kommandoer. For at aktivere OCI-P-forbindelse skal du bruge nedenstående trin:

Trin 1: Brug CLI til at konfigurere generelle indstillinger.

Kør følgende kommando i CLI for at skifte til mappen GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Kør følgende kommando i CLI for at få de aktuelle GeneralSettings:

AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen indstil til at omkonfigurere dine indstillinger.

Trin 2: Brug CLI til at konfigurere OCI-proxyen.

Skift telefonbogen til OCI-proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Kør følgende CLI for at få aktuelle indstillinger. Du bør se følgende:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

Hvis dine indstillinger ikke stemmer overens med ovenstående, skal du bruge kommandoen indstil til at omkonfigurere dine indstillinger.

Trin 3: Brug CLI til at konfigurere OCI-klargøring.

Skift til klargøringskatalog:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Kør følgende kommando for at få de aktuelle OCI-klargøringsindstillinger:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Trin 4: Kør kommandoen nedenfor i CLI for at bekræfte, at din konfiguration er korrekt.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Bekræft, at den åbne klientserver er installeret og aktiv

Brug kommandoerne nedenfor til at installere og starte Open Client-serveren på den sekundære applikationsserver, hvis den ikke er installeret eller ikke allerede er startet.

Trin 1: Installer serveren med følgende CLI-kommando:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Trin 2: Start serveren med denne kommando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Aktivér aktivering af numre

Udfør følgende kommandoer i CLI for at aktivere aktivering af numrene:

Trin 1: Kør kommandoen for nummeraktivitet:

AS_CLI> cd SubscriberMgmt/NumberActivation

Trin 2: Kør kommandoen til aktivering:

AS_CLI> set dnMode groupAndUserActivationEnabled

Trin 3: I bekræftelsesanmodningen skal du angive Y.

Til BroadCloud

Udtrækningsværktøjet er integreret i BroadCloud-tjenesteudbyderportalen. En tjenesteudbyders administrator kan:

1. Indsend anmodninger om udtræk for op til 50 kunder pr. anmodning.
   Anmodning om udtræk kan ikke sendes for den samme kunde mere end 10 gange om dagen.
2. Download den udpakkede datafil i ZIP-format i op til 28 dage fra datoen for indsendelse af anmodning.

Nedenstående tal viser tjenesteudbyderportalen.

Figur 6: Tjenesteudbyderportal

Figur 7: Tjenesteudbyderportal

Til Cisco BroadWorks og Webex til BroadWorks

1. Ekstraktionsværktøjet kører på den sekundære Cisco BroadWorks-programserver i partnernetværket og opretter forbindelse via OCI-P.
2. Værktøjet trækker rå virksomheds-, gruppe-, numre-, brugere-, tjenester-, enheds- og softwareklientdata fra Cisco BroadWorks- eller BroadCloud-platformen og udsender disse data til XML-filer, der leverer input til transformationsværktøjet.

De næste afsnit forklarer, hvordan du installerer og konfigurerer ekstraktionsværktøjet.

Forudsætninger

1. SCP udtrækker værktøjsbinære filer til sekundær Cisco BroadWorks-applikationsserver.
2. SSH til den sekundære Cisco BroadWorks-programserver for at konfigurere forudsætningerne og køre ekstraktionsværktøjet.
3. Konfigurer tjenesteudbyderen og gruppe-id'et til at udtrække fra Cisco BroadWorks i conf/exportTool.yml. Se nedenstående eksempel på YAML-snippet:

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. Sørg for, at det sekundære bruger-id, adgangskode og værtsnavn til Cisco BroadWorks-applikationsserver er korrekte i filen conf/partner.cfg:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   Egenskaben REFRESH_TOKEN er obligatorisk for en Webex til BroadWorks-migrering.

5. Rediger JDK/JRE-miljøstien i export.sh-filen, hvis den sekundære JDK/JRE-miljøsti til Cisco BroadWorks-applikationsserver er en anden end filen:

   JAVA_HOME=/usr/local/java/java_base

Vejledning til at køre

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserver fra mappen udtræk værktøj:

./export.sh

Terminallogfiler

Følgende logfiler er tilgængelige i terminalen ved vellykket eksport: Kører BroadSoft-dataeksportværktøj:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

Output

En output-ZIP (.zip)-fil vil være tilgængelig i den samme udtrækningsværktøjsmappe.extracted_data_<timestamp> Brug kommandoen nedenfor til at se og bruge ZIP-filen til input af transformationsværktøj:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

Dette transformationsværktøj køres for alle migreringer. Transformationsværktøjet kører på enhver computer, herunder en partneradministrators bærbare computer, og bruger Webex Public API'er. Den læser ZIP-filen (extracted_data_<timestamp>.zip), som et input og omdanner den rå XML til et JSON-format, der bruges af klargøringsværktøjet.

Forudsætninger

Når du har downloadet og udpakket binærerne til migreringsværktøjer, skal du konfigurere følgende forudsætninger:

1. Indstil opdateringstokenet_ (TOKEN kopieret fra værktøjet Token Generator) og NAVNET_PÅ_HOVEDPLACERINGEN_ i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Du kan vælge at indstille KLARGØRINGEN_ID (kopieret fra skabelonen i Partner Hub) i filen conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   For at få mere komplet bekræftelse af kundens e-mailadresse kan du vælge at angive KLARGØRINGS_-id'et.
3. Konfigurer manglende oplysninger i input/customers.csv-filen (se næste afsnit), hvis de mangler.
4. Tilføj slutbrugerens e-mailadresse i input/users.csv-filen.
5. Hvis nye telefoner skal klargøres, skal du føje MAC-adressen og e-mailadressen på brugerens nye telefon til input/newphones.csv-filen. Dette er kun påkrævet, hvis partneradministratorerne ønsker at klargøre nye telefoner i engrosopkald.
6. Konverter BroadWorks-opkaldscentre til CxEssentials ved hjælp af filen input/cxessentials.csv.
7. Du kan også aktivere egenskaben OPGRADER_ALLE_OPKALDSCENTRE__TIL_CX_ESSENTIALS for at konvertere alle opkaldscentre til CxEssentials.
8. Brug input/locations.csv-filen til at understøtte den store virksomhedsmigrering, der giver administratorer mulighed for at overføre deres kundes placeringer efter placering
9. Du kan vælge at aktivere brug af MAC-adresser fra brugeragentheaderen i SIP REGISTER-meddelelsen, når MAC-adressen ikke er tilgængelig i Cisco BroadWorks-enhedsprofilen. Fjern kommentar til linjen "BRUG_MAC_ADRESSE_FRA_SIP_REGISTER=ja" i filen conf/partner.cfg
10. Synkroniseringsfunktionen til netværksserver giver administratorer mulighed for at klargøre telefonnumre, MAC-adresser og brugernes e-mailadresser under klargøringen i den samme områdemigration. For at aktivere den skal du indstille USE_NS_SYNC=yes i conf/partner.cfg.

    Hvis NS-synkronisering er deaktiveret, springes klargøring af telefonnummer og enhed over, og brugerne får midlertidige e-mailadresser.

Udfyldning af input/customers.csv

Filindtastningen/customers.csv indeholder data, der muligvis mangler i Cisco BroadWorks eller BroadCloud. Denne fil kan efterlades tom, hvis alle obligatoriske oplysninger allerede er tilgængelige. Du behøver ikke at udfylde alle kolonner. Det er kun de manglende oplysninger, der er obligatoriske.

Tabellen nedenfor beskriver de vigtigste kolonner i input/customers.csv.

Vejledning til at køre

Kør transformationsværktøjet i et hvilket som helst operativsystem. Brug nedenstående trin til at køre værktøjet i Windows og macOS:

Windows

Udfør kommandoen nedenfor for at køre transformationsværktøjet i Windows:

transform.bat -extract= -customers= -users= -newphones=

macOS

Udfør følgende trin for at køre transformationsværktøjet på macOS:

1. Opret et virtuelt miljø, og installer afhængigheder for at køre transformationsværktøjet ved hjælp af Python:

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. Kør transformationsværktøjet:

   ./transform.sh -extract= -customers= -users= -newphones=

Forhåndskontrol af kunde/bruger

Transformationsværktøjet foretager API-opkald til Webex for at indhente potentielle klargøringsproblemer. Som standard validerer den kundens adresse og primære e-mail. Hvis klargørings_ID-værdien er angivet i filen conf/partner.cfg, validerer den også oplysninger om placering. Resultaterne af forhåndskontrollen er inkluderet i undtagelsesrapporten.

Derudover kan følgende valgfrie parametre tilføjes, når transformationsværktøjet køres:

forhåndskontrol

Ud over at køre forhåndskontrol-API for kundeoplysninger kører transformationsværktøjet også forhåndskontrol-API for abonnent-e-mails.

oplysninger om forhåndskontrol

Som standard er det kun fejl i forhåndskontrol (dvs. problemer, der blokerer klargøring), der medtages i undtagelsesrapporten. Tilføjelse af dette flag omfatter også vellykkede forhåndskontrolresultater (hvis der f.eks. allerede findes en Webex-organisation, der kan vedhæftes automatisk).

Terminallogfiler

Følgende logfiler i terminalen, når transformationen er gennemført:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

Undtagelsesrapport

Transformationsværktøj genererer undtagelsesrapporten i output/<timestamp>/exception_report.txt -mappen. Du kan bruge denne rapport til at identificere de problemer, der vil påvirke migreringen, og løse dem i Cisco BroadWorks-systemet.

Når du har ændret brugerdataene for at løse undtagelsen, skal du køre udtræk- og omdannelsesværktøjerne igen med de nye data. Eksempelundtagelsesrapportfilen er som følger:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

Output

En output-JSON-fil (customer.json) vil være tilgængelig i output/<timestamp>/<groupid> -mappen. Eksemplet på customer.json -filen er som følger:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

Klargøringsværktøjet kan køre på enhver maskine, som normalt (partnerens administratorbærbare computer) og bruger Webex Public API'er. Den læser JSON-filen (customer.json) til transformationsværktøj som input og klargør kunder, placeringer, numre, brugere, tjenester og enheder i Webex Wholesale RTM-løsningen.

Forudsætninger

Konfigurer følgende forudsætninger i mappen med klargøringsværktøjer:

1. Installer Java 8, 11, 17 eller 21 på computeren. Java er tilgængelig fra mange kilder, herunder:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Når du har downloadet og udvundet binærerne til migrationsværktøjer, skal du indstille variablen JAVA_HOME-miljø i provisioning_tool.sh til MAC og provisioning_tool.bat til Windows.
3. Filen partner.cfg:
   • Indstil engrosforhandlerklargørings-id'et og opdater token (token kopieret fra værktøjet Token Generator).___ Partneradministratorerne skal kontakte deres kontoteam for at få KLARGØRINGS-ID'et_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Indstil TILLAD_ADMIN_INVITER_E-MAILS til falsk, hvis partneren ikke ønsker at sende en velkomst-e-mail til brugerne. Standardværdien er sand.

4. Brug emneegenskaben WEBEX4BWKS_E-MAIL_TIL Webex for BroadWorks-migreringer til at sende e-mailemnet for anmodning om ændring af adgangskode for Webex for BroadWorks-abonnenter.
5. Brug WEBEX4BWKS_E-MAIL_BODY PROPERTY for Webex for BroadWorks-migreringer til at sende e-mailbody for anmodning om ændring af adgangskode for Webex for BroadWorks-abonnenter.
6. Synkroniseringsfunktionen til netværksserver giver administratorer mulighed for at klargøre telefonnumre, MAC-adresser og brugernes e-mailadresser under klargøringen i den samme områdemigration. For at aktivere den skal du indstille USE_NS_SYNC=yes i conf/partner.cfg.

   Hvis NS-synkronisering er deaktiveret, springes klargøring af telefonnummer og enhed over, og brugerne får midlertidige e-mailadresser.

For BroadCloud-migreringer samme område:

1. Værktøjet springer over klargøring af numre, enheder og delte opkaldsvisninger over.
2. Værktøjet opretter brugere og virtuelle brugere med lokalnummer og midlertidigt lokalnummer.

For BroadCloud-migreringer gælder et andet område:

1. Værktøjet klargør numre, enheder og visninger af delte opkald.
2. Værktøjet opretter brugere og virtuelle brugere med faktiske telefonnumre og lokalnumre.
   Alle BroadCloud-migreringer i Europa er til en anden region.

Vejledning til at køre

Benyt følgende fremgangsmåde til at køre værktøjet i Windows og macOS:

Windows

Udfør følgende trin for at køre værktøjet på Windows OS:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

Udfør følgende trin for at køre værktøjet på macOS:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Forudsætninger for Webex til BroadWorks-migrering

Partneradministratorer skal opdatere deres BroadWorks-onboarding-skabelon til Webex for BroadWorks-sameksistensfunktioner. Se følgende billede:

Når Webex til BroadWorks-onboarding-skabelonen er opdateret for at understøtte migrering, skal du anmode Cisco-kontoteamet om at aktivere funktionen "wholesale-partner-blending-enabled" på partnerniveau. Dette gør det muligt at føje engrospakker til eksisterende Webex til BroadWorks-kundeorganisationer under klargøring.

Kør klargøringsværktøjet med et yderligere argument.

Forberedelsesfase: er standardfasen, hvor administratorer kan klargøre BroadWorks-brugere som engrosabonnementer og fortsætte med Webex for BroadWorks-brugere.

Vedligeholdelsesfase: er den anden fase, hvor administratorer kan tildele engroslicensen til de eksisterende Webex for BroadWorks-brugere. Du skal køre klargøringsværktøjet med et argument vedligeholdelse.

Fase efter migrering: Er den sidste fase, hvor administratorer helt kan konvertere BroadWorks til engroshandel. Du skal køre klargøringsværktøjet med et argument efter migration.

Terminallogfiler

Følgende er logfilerne i terminalen ved vellykket klargøring:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

En tabel udskrives med antallet af oprettede placeringer for hver kørsel:

Output

Klargøringsværktøjet genererer succesrapporter og fejlrapporter i output/<external_id>/*.success/error -filerne. Gennemgå vellykket output og fejllogfiler for at bekræfte vellykket klargøring.

Partneradministratorer kan bekræfte kundeklargøringen i Partner Hub- og Control Hub-portalen. Se følgende illustrationer fra Partner Hub- og Control Hub-portalen:

Figur 8: Partner Hub

Figur 9: Control Hub

Figur 10: Enheder

Figur 11: Calling

Til BroadCloud

For BroadCloud-partnere skal du bruge tjenesteudbyderportalen til at indsende en migreringsanmodning for numre, enheder og SCA-migreringer.

Inden for serviceudbyderportalen kan en migreringsanmodning omfatte op til 50 kunder. Der kan maksimalt indsendes 10 anmodninger inden for en dag.

Funktionen til synkronisering af netværksserver giver administratorer mulighed for at deaktivere broadCloud-placeringen og aktivere Webex Calling-placeringen ved indstilling af USE_NS_SYNC=yes i conf/partner.cfg. Efter migrering aktiveres enheder og telefonnumre på Webex Calling-placeringen.

Administratorer kan aktivere automatisk tilbagerulning ved at indstille ROLLBACK_TO_BROADCLOUD=true i conf/partner.cfg filen, som flytter enheder tilbage til BroadCloud efter migrering. Den understøtter både migreringer af samme og forskellige områder med NS-synkronisering, men kun for vellykkede migreringer. For mislykkede brugere skal administratorer hæve en Cisco TAC, før der anmodes om rollback.

Nedenstående tal viser tjenesteudbyderportalen.

Figur 12: Tjenesteudbyderportal

Figur 13: Tjenesteudbyderportal

Til Cisco BroadWorks og Webex til BroadWorks

For Cisco BroadWorks- og Webex til BroadWorks-migreringer kører værktøjet på den sekundære Cisco BroadWorks-programserver i partnernetværket og opretter forbindelse til AS via OCI-P. Den bruger JSON-filen (customer.json) til transformationsværktøj som input og kører OCI-P-kommandoerne til at migrere enheder og softwareklienter.

Når handlingen er fuldført, vil værktøjet til flytning af enhed:

1. Fjern registreringen af enheder fra Cisco BroadWorks, og registrer dem i engroshandel.
2. Brugere, der bruger UC-One-klienten, omdirigeres til Webex-appen ved første login.
3. Deaktiver telefonnumre fra Cisco BroadWorks, eller fjern telefonnumrene fra BroadCloud.
4. Aktivér numre i engrossalg.
5. Opret delte opkaldsforekomster i engroshandel med henblik på BroadCloud-migreringer. [Dette trin gælder kun for BroadCloud-migreringer].

SCP og SSH

1. SCP-værktøjet til flytning af enheden til den sekundære Cisco BroadWorks-programserver.
2. SSH til den sekundære Cisco BroadWorks-programserver for at konfigurere forudsætningerne og køre værktøjet til flytning af enheden.

Forudsætninger

1. Indstil OPDATERINGSTOKEN_ (token kopieret fra værktøjet Token Generator) i filen conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Sørg for, at det sekundære bruger-id, adgangskode og værtsnavn til Cisco BroadWorks-applikationsserver er korrekte i filen conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Hvis du vil sende aktiverings-e-mails igen, skal du indstille SEND_INVITATION_E-MAILS=true i filen conf/partner.cfg.

   Hvis administratorer ønsker at sende e-mailinvitationer til deres brugere under migreringen, skal de fjerne kommentarer til egenskaben "SEND_INVITATION_E-MAILS=true" i filen conf/partner.cfg. Ellers skal ejendommen forblive uændret.

4. Bekræft, at JDK/JRE-miljøstien er korrekt i devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Administratorer kan bruge filen locations.csv fra inputmappen til at migrere de specifikke grupper i stedet for alle grupper under en virksomhed.

Polycom-telefoner

For at flytte Polycom-telefoner fra Cisco BroadWorks til engrosopkald skal en partneradministrator oprette en ny identitets-/enhedsprofiltypefil på systemniveau i hver Polycom-enhedsskabelon i Cisco BroadWorks. Se figur 14, og overfør den brugerdefinerede fil device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Når du har overført den nye enhedsfil, skal du sørge for, at den nyoprettede fil findes på gruppeniveau. Sørg også for, at filen migration_%BWMAC ADDRESS%.cfg ikke er i konflikt med en eksisterende fil i dit system).

Den bruges internt af værktøjet til flytning af enheden.

Migrationsprocessen for Polycom-telefoner:

1. Værktøjet til flytning af enhed erstatter filen %BWMACADDRESS%.cfg på enhedsniveau med polycom_vvx2.cfg. Denne fil henviser til migration_%BWMACADDRESS%.cfg.
2. Genopbyg enhedsprofilerne på gruppeniveau eller enhedsniveau.
   Handling på gruppeniveau eller enhedsniveau afhænger af konfigurationen af parameteren deviceLevelRebuild i filen device-move-tool/conf/partner.cfg.
3. Værktøjet til flytning af enheder beder Cisco BroadWorks-programserveren om at genstarte telefoner på gruppeniveau eller enhedsniveau.
4. Efter genstartsanmodningen downloader og process% BWMACADDRESS%.cfg, hvilket beder Polycom-telefonerne om at downloade og process migration_%BWMACADDRESS%.cfg, hvilket indstiller device.prov.serverName til https://plcm.sipflash.com.
   https://plcm.sipflash.com for den amerikanske region har andre regioner forskellige URL-adresser.
5. Polycom-telefonen downloader %BWMACADDRESS%.cfg fra https://plcm.sipflash.com og vil blive administreret af Webex Calling DMS.

Figur 14: Tilføj profiltypefil for identitet/enhed

Vejledning til at køre

Der er to metoder til at aktivere DMT, den første er at aktivere gennem en enkelt kunde ad gangen, og den anden er at køre gennem flere kunder samtidigt.

Enhedsflytningsværktøjet køres fra den sekundære Cisco BroadWorks-programserver i mappen med enhedsflytningsværktøjer:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

Terminallogfiler

Følgende logfiler i terminalen om enhedsflytningsværktøjet til enhedsmigrering blev kørt:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

Output

Efter enhedsoverførslen er enheder online og klar til at foretage/modtage opkald. Se figur 15 for at se et eksempel på enhedens status:

Figur 15: Enhedsstatus

Efter enhedsoverførslen er numre blevet aktive. Se figur 16 for at se et eksempel på, hvilke numre der er aktive:

Figur 16: Numrene er aktive

Gendannelseshandlingen skal udføres for én virksomhed ad gangen.

For BroadCloud-udbyder

Gendannelsesprocessen for BroadCloud-partnere er som følger:

1. Åbn en supportanmodning hos Cisco TAC for at anmode om genoprettelse af en enhed.
2. Kør værktøjet til flytning af enheden i gendannelsestilstand:
   • Tildelingen af telefonnumre vil blive fjernet fra Webex Calling, så brugere og tjenester kun får lokalnumre.
   • E-mailadresser i Webex Calling vil blive gendannet til midlertidige e-mailadresser.
   • Telefoner slettes fra Webex Calling.
   • Telefonnumre, e-mailadresser, der bruges som alternative id'er, og telefoner vil blive genoprettet i BroadCloud.
   • Telefoner genstartes.
3. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til BroadCloud Carrier.

Til Cisco BroadWorks og Webex til BroadWorks

Gendannelsesprocessen for Cisco BroadWorks og Webex for BroadWorks er som følger:

1. Åbn en supportanmodning hos Cisco TAC for at anmode om genoprettelse af en enhed.
2. Kør værktøjet til flytning af enheden i gendannelsestilstand på den sekundære BroadWorks-applikationsserver for at gendanne enhedsoverførsler. Dette vil nulstille DMS-URL-adressen til tjenesteudbyderens DMS-URL-adresse for enhedsprofiler i Cisco BroadWorks og genaktivere telefonnumre.
3. Webex Calling-teamet indstiller DMS URL-adressen tilbage til tjenesteudbyderens DMS URL-adresse i enhedsprofiler i Webex Calling.
4. Partneradministratorer skal deaktivere eller slette telefonnumrene i Webex Calling via Control Hub-portalen.
5. Partneradministratorer skal flytte PSTN-telefonnumre tilbage til Cisco BroadWorks.

Vejledninger til at køre værktøjet til flytning af enhed i gendannelsestilstand

Følg nedenstående trin for at køre værktøjet til flytning af enheden i gendannelsestilstand:

Kør kommandoen nedenfor i den sekundære Cisco BroadWorks-programserver i mappen med enhedsflytningsværktøj:

Returnér profiler

./devicemove.sh -input=  -revertProfiles

Returner numre

./devicemove.sh -input=  -revertNumbers

Terminallogfiler

Vi får følgende logfiler i terminalen, når værktøjet til flytning af enheden er blevet kørt med henblik på genoprettelse:

Returnér profiler

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

Returner numre

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully