BroadWorks, BroadWorks için Webex ve BroadCloud'dan Toptan Satış RTM çözümlerine geçiş araçları

Desteklenen telefonlar, hazırlama aracı tarafından otomatik olarak oluşturulur ve Webex Calling'deki kullanıcılara atanır. “Cihaz taşıma aracında desteklenir” sütununda “evet” işaretli telefonlar da, cihaz taşıma aracı çalıştırıldığında otomatik olarak Cisco BroadWorks veya BroadCloud’dan Webex Calling’e taşınacaktır. Bu sütundaki "Hayır" işaretli telefonların, Cisco BroadWorks cihaz şablonundaki veya telefonun kendisindeki DMS URL'sini değiştirmek için manuel bir müdahaleye ihtiyacı vardır.

Son sütun, telefon modellerinin dosya transform-tool/input/newphones.csv dosyasının “Cihaz türü” sütununa eşlenmesini sağlar. (Newphones.csv hakkında daha fazla bilgi için bu makalenin Dönüştürme aracı bölümüne bakın).

Iş ortağı yöneticileri geçiş araçlarını çalıştırmaya başlamadan önce bu belirteç oluşturucu yardımcı araç aracını en az bir kez çalıştırırlar. Bu aracı çalıştırmak, iş ortağı hesabı Toptan Satış RTM çözümüne dahil edildikten sonra tek seferlik bir etkinliktir. Bu araç, iş ortağı yöneticilerinin, geçiş araçları için iş ortağı yapılandırma dosyalarına güncellemek üzere gereken benzersiz BELIRTECI almak için web tarayıcısı aracılığıyla oturum açmasına olanak tanır.

Ön koşullar

Indirme işleminden sonra, geçiş aracı ikili dosyalarını çıkarın.

MAC için token_generator.sh ve Windows için token_generator.bat’ta JRE/JDK ortam yolunu ayarlayın. JAVA_HOME yolu zaten varsa araç tarafından yeniden kullanılır.

• MAC: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Çalıştırma talimatları

Belirteç jeneratörü dizinindeki terminalde aşağıdaki komutu çalıştırın:

Windows:

token_generatorBat

MacOS:

./token_generator.sh

Çıkış:

Araç Adı: Token Jeneratör Aracı Sürümü: 1.13.0 URL'yi web tarayıcınıza yükleyin: http://localhost:8080 

Terminalde web tarayıcısında URL'yi açın, BELIRTECI almak ve daha fazla kullanım için aynısını kopyalamak için iş ortağı yönetici kimlik bilgileriyle oturum açın.

Kullanıcı arayüzü görselleri referans olarak aşağıda verilmiştir:

Şekil 3: Cisco Webex ile oturum aç

Şekil 4: Kimlik bilgileri penceresi

Şekil 5: Belirteç oluşturma

Ikincil BroadWorks sunucusunda ayıklamayı ve cihaz taşıma araçlarını çalıştırmadan önce aşağıdaki adımları yapılandırın.

OCI-P bağlantısını etkinleştir

Cihaz taşıma aracı, OCI-P komutları aracılığıyla BroadWorks ile iletişim kurarak OCI-P bağlantısını etkinleştirmek için aşağıdaki adımları kullanın:

1. Adım: Genel Ayarları yapılandırmak için CLI'yı kullanın.

GeneralSettings dizinine geçmek için CLI'da aşağıdaki komutu çalıştırın:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Geçerli GeneralSettings'i almak için CLI'da aşağıdaki komutu çalıştırın:

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

Ayarlarınız yukarıdakilerle eşleşmiyorsa ayarlarınızı yeniden yapılandırmak için ayarla komutunu kullanın.

2. Adım: OCI Proxy'sini yapılandırmak için CLI'yi kullanın.

Dizini OCI Proxy olarak değiştirme:

AS_CLI> cd /Uygulamalar/OpenClientServer/OCIProxy

Geçerli ayarları almak için aşağıdaki CLI’yı çalıştırın. Şunları görmelisiniz:

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

Ayarlarınız yukarıdakilerle eşleşmiyorsa ayarlarınızı yeniden yapılandırmak için ayarla komutunu kullanın.

3. Adım: OCI Sağlamayı yapılandırmak için CLI'yi kullanın.

Sağlama dizinine geçin:

AS_CLI> cd /System/NetworkAccessLists/OCI/Hazırlama

Geçerli OCI Sağlama ayarlarını almak için aşağıdaki komutu çalıştırın:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> Adres Açıklaması ======================== 127.0.0.1 yerel 

4. Adım: Yapılandırmanızın doğru olduğunu doğrulamak için aşağıdaki komutu CLI'da çalıştırın.

_CLI/Maintenance/ManagedObjects> broadworks'ü alırken ve çıkışınızın iyi göründüğünü kontrol edin. Örnek çıkışı için aşağıya bakın: AS_CLI/Maintenance/ManagedObjects> broadworks BroadWorks Managed Objects ========================== * Sunucu: Kimlik..............: Sürüm OLARAK...............: Rel_21.sp1_1.551 Idari Devlet..: Kilidi Açılmış * Uygulamalar: Ad Sürüm Konuşlandırılmış Yönetim Durumu Etkin Durum ========================================================================================= Yürütme Ve Hazırlama 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 giriş bulundu. * Barındırılan Uygulamalar: Ad Sürüm Bağlam Yolu Dağıtım ================================================================== 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 giriş bulundu. 

Açık istemci sunucusunun dağıtıldığını ve etkin olduğunu doğrulayın

Dağıtılmamışsa veya henüz başlatılmamışsa ikincil Uygulama Sunucusunda Açık Istemci Sunucusunu dağıtmak ve başlatmak için aşağıdaki komutları kullanın.

1. Adım: Sunucuyu aşağıdaki CLI komutuyla dağıtın:

AS_CLI/Maintenance/ManagedObjects> uygulama dağıtma OpenClientServer

2. Adım: Sunucuyu şu komutla başlatın:

AS_CLI/Maintenance/ManagedObjects> uygulamayı başlat OpenClientServer

Numara etkinleştirmeyi etkinleştir

Numaraların etkinleştirilmesini etkinleştirmek için CLI'da aşağıdaki komutları çalıştırın:

1. Adım: Numara etkinleştirme komutunu çalıştırın:

AS_CLI> cd AbonesiMgmt/NumaraEtkinleştirme

2. Adım: Etkinleştirme etkinleştirilmiş komutunu çalıştırın:

AS_CLI> dnMode groupAndUserActivationEnabled grubunu ayarla

3. Adım: Onay isteminde Y değerini girin.

BroadCloud için

Ayıklama aracı, BroadCloud Hizmet Sağlayıcı portalına entegre edilmiştir. Hizmet sağlayıcı yöneticisi şunları yapabilir:

1. Istek başına 50 adede kadar müşteri için özü istekleri gönderin.
   Ayıklama isteği aynı müşteri için günde 10 defadan fazla gönderilemez.
2. Çıkarılan veri dosyasını, istek gönderim tarihinden itibaren 28 güne kadar ZIP biçiminde indirin.

Aşağıdaki şekillerde Hizmet Sağlayıcı portalı gösterilmektedir.

Şekil 6: Hizmet Sağlayıcı portalı

Şekil 7: Hizmet Sağlayıcı portalı

Cisco BroadWorks için ve BroadWorks için Webex

1. Ayıklama aracı, iş ortağı ağında ikincil Cisco BroadWorks Uygulama Sunucusunda çalışır ve OCI-P aracılığıyla bağlanır.
2. Araç, ham işletme, grup, numara, kullanıcı, hizmet, cihaz ve yazılım istemcisinin verilerini Cisco BroadWorks veya BroadCloud platformundan çeker ve bu verileri dönüştürme aracı için girdileri sağlayan XML dosyalarına çıkarır.

Sonraki bölümlerde, ayıklama aracının nasıl kurulacağı ve yapılandırılacağı anlatılmaktadır.

Ön koşullar

1. SCP, ikincil Cisco BroadWorks Uygulama Sunucusuna çıkarma aracı ikili dosyaları.
2. Ön koşulları yapılandırmak ve ayıklama aracını çalıştırmak için ikincil Cisco BroadWorks Uygulama Sunucusuna SSH.
3. conf/exportTool.yml içindeki Cisco BroadWorks'ten çıkarmak için Hizmet Sağlayıcıyı ve Grup Kimliğini yapılandırın. Aşağıdaki örnek YAML parçacığına bakın:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - TÜMÜ 

4. conf/partner.cfg dosyasında ikincil Cisco BroadWorks Uygulama Sunucusu Kullanıcı Kimliğinin, Parolasının ve Ana Bilgisayar Adının doğru olduğundan emin olun:

   BROADWORKS_KULLANICI_KIMLIĞI = yönetici BROADWORKS_PAROLASI = yönetici BROADWORKS_TOPLANTI SAHIBI_ADI = localhost REFRESH_TOKEN = Iş ortağı yöneticisinin yenileme belirteci Token Oluşturucu aracından kopyalandı. GEÇIŞ_MODU = Desteklenen değerler şunlardır: webex_for_broadworks_to_wholesale. Varsayılan değer broadworks_to_wholesale. BroadWorks webex_for_broadworks_to_wholesale geçişleri için Webex için kullanın. 

   YENILEME_BELIRTECI özelliği, BroadWorks geçişi için Webex zorunludur.

5. Ikincil Cisco BroadWorks Uygulama Sunucusu JDK/JRE ortam yolu dosyadan farklıysa export.sh dosyasındaki JDK/JRE ortam yolunu değiştirin:

   JAVA_HOME=/usr/local/java/java_base

Çalıştırma talimatları

Aşağıdaki komutu, ayıklama aracı dizininden ikincil Cisco BroadWorks Uygulama Sunucusunda çalıştırın:

./export.sh

Terminal günlükleri

Başarılı dışa aktarmada terminalde aşağıdaki günlükler mevcuttur: BroadSoft Veri Dışa Aktarma Aracı Çalıştırılıyor:

 BroadSoft Veri Dışa Aktarma Aracı ************************************************ Başlatma Dışa Aktarma Aracı v: 1.15.0 SP=collabmigrationtestSP için dışa aktarma başladı_engg, Group=collabmigrationtestGRP_engg için dışa aktarılıyor SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg için dışa aktarma tamamlandı SP=collabmigrationtestSP için tamamlandı_engg, Group=collabmigrationtestGRP_engg için dışa aktarma tamamlandı _engg, Group=collabmigrationtestSP_engg için tamamlandı Dışa Aktarma Dökümü Zip Dizini: output/20221017223452_ExportTool Export Dump Zip Dosya adı :extracted_data_1666060500618.zip adında extracted_data_1666060500618.zip dosyası oluşturuldu ZIP dosyası oluşturma işlemi tamamlandı Dışa aktarılan dosyalar ZIP dosyası olarak dönüştürüldü ************************************************** 

Çıkış

Aynı ayıklama aracı dizininde bir çıktı ZIP (extracted_data_.zip) dosyası bulunacaktır. Dönüşüm Aracı girişi için ZIP dosyasını görüntülemek ve kullanmak için aşağıdaki komutu kullanın:

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

Bu dönüşüm aracı tüm geçişler için çalıştırılır. Dönüşüm aracı, iş ortağının yönetici dizüstü bilgisayarı da dahil olmak üzere herhangi bir bilgisayarda çalışır ve Webex Herkese Açık API'lerini kullanır. Ayıklama aracı çıktı ZIP (extracted_data_.zip) dosyasını girdi olarak okur ve ham XML'i hazırlama aracı tarafından kullanılan bir JSON biçimine dönüştürür.

Ön koşullar

Geçiş araçları ikili dosyalarını indirip çıkardıktan sonra aşağıdaki ön koşulları yapılandırın:

1. conf/partner.cfg dosyasındaki REFRESH_TOKEN (Token Jeneratör Aracından kopyalandı) ve ANA_KONUMUN__ADINI ayarlayın:

   YENILE_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj ADI_OF_ANA MENÜ_KONUM=Ana 

2. Isteğe bağlı olarak conf/partner.cfg dosyasında SAĞLAMA_kimliğini (Partner Hub'daki şablondan kopyalanır) ayarlayın:

   HAZIRLAMA_KIMLIĞI=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Müşteri e-posta adresinin daha eksiksiz doğrulanmasını almak için isteğe bağlı olarak SAĞLAMA_KIMLIĞINI ayarlayabilirsiniz.
3. Eksikse input/customers.csv dosyasında eksik bilgileri yapılandırın (sonraki bölüme bakın).
4. Son kullanıcının e-posta adresini input/users.csv dosyasına ekleyin.
5. Yeni telefonlar sağlanacaksa kullanıcının yeni telefonunun mac adresini ve e-posta adresini input/newphones.csv dosyasına ekleyin. Bu, yalnızca iş ortağı yöneticilerinin Toptan Satış çağrısında yeni telefonlar sağlamak istemesi durumunda gereklidir.
6. input/cxessentials.csv dosyasını kullanarak BroadWorks Çağrı Merkezlerini CxEssentials'a dönüştürün.
7. Isteğe bağlı olarak tüm Çağrı Merkezlerini CxEssentials'a dönüştürmek amacıyla TÜM__ÇAĞRI_MERKEZLERINI__CX_ESSENTIALS'A YÜKSELTME özelliğini etkinleştirin.
8. Yöneticilerin müşterilerinin konumlarını konuma göre taşımasını sağlayan büyük kurumsal geçişini desteklemek için input/locations.csv dosyasını kullanın
9. MAC adresi Cisco BroadWorks cihaz profilinde mevcut olmadığında, SIP KAYDI mesajının Kullanıcı-Aracısı üstbilgisinden MAC adreslerinin kullanılmasını isteğe bağlı olarak etkinleştirin. conf/partner.cfg dosyasındaki "_MAC_ADRESINI__SIP_REGISTER=evet" satırı yorumunu kaldırın

Girdinin/customers.csv dosyasının doldurulması

Dosya input/customers.csv, Cisco BroadWorks veya BroadCloud'da eksik olan verileri sağlar. Eğer tüm zorunlu bilgiler zaten mevcutsa bu dosya boş bırakılabilir. Tüm sütunları doldurmanız gerekmez, sadece eksik bilgiler zorunludur.

Aşağıdaki tablo, input/customers.csv dosyasındaki en önemli sütunları açıklamaktadır.

Çalıştırma talimatları

Transform Tool'u herhangi bir işletim sisteminde çalıştırın. Aracı Windows ve macOS'ta çalıştırmak için aşağıdaki adımları kullanın:

Windows

Windows'ta Dönüşüm Aracı'nı çalıştırmak için aşağıdaki komutu çalıştırın:

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

macOS

macOS'ta dönüştürme aracını çalıştırmak için aşağıdaki adımları uygulayın:

1. Bir sanal ortam oluşturun ve Python kullanarak dönüşüm aracını çalıştırmak için bağımlılıklar yükleyin:

   python3 -m venv venv kaynak venv/bin/activate python3 -m pip yükleme istekleri python3 -m pip yükleme istekleri-oauthlib 

2. Dönüştürme aracını çalıştırın:

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

Müşteri/kullanıcı ön kontrolü

Dönüştürme Aracı, potansiyel hazırlama sorunlarını yakalamak için Webex’e API çağrıları yapar. Varsayılan olarak müşterinin adresini ve birincil e-postasını doğrular. SAĞLAMA_KIMLIĞI değeri conf/partner.cfg dosyasında belirtilirse konum bilgilerini de doğrular. Ön kontrol sonuçları istisna raporuna dahil edilir.

Ayrıca, dönüştürme aracı çalıştırılırken aşağıdaki isteğe bağlı parametreler eklenebilir:

ön kontrol

Dönüşüm Aracı, müşteri bilgileri için ön kontrol API'sini çalıştırmanın yanı sıra abone e-postaları için ön kontrol API'sini de çalıştıracaktır.

önçeckinfo

Varsayılan olarak, yalnızca ön kontrol hataları (yani sağlamayı engelleyecek sorunlar) istisna raporuna dahil edilir. Bu bayrağın eklenmesi, başarılı ön kontrol sonuçlarını da içerir (örneğin, otomatik olarak eklenebilen bir Webex kuruluşu zaten varsa).

Terminal günlükleri

Başarılı dönüşümde terminalde aşağıdaki günlükler:

Özet Raporu Başarıyla taşınabilen BroadWorks işletmeleri: Taşınamayan 1 BroadWorks işletmeleri: Başarıyla taşınabilen 0 BroadWorks kullanıcısı: Taşınamayan 4 BroadWorks kullanıcısı: 0 Başarıyla taşınabilen telefonlar: Webex Calling ile uyumlu olmayan 3 Telefon: 0 

Istisna raporu

Dönüştürme Aracı çıktı//exception_report.txt dizininde istisna raporu oluşturur. Bu raporu kullanarak, taşımayı etkileyecek sorunları tespit edebilir ve Cisco BroadWorks sisteminde düzeltebilirsiniz.

Istisnayı çözmek için kullanıcı verilerini değiştirdikten sonra, Ayıklama ve Dönüştürme Araçlarını yeni verilerle yeniden çalıştırın. Örnek istisna rapor dosyası aşağıdaki gibidir:

Istisna Raporu Tue Oct 18 08:12:09 2022 Iletişim Barring Özelliği Olan Işletmeler Tavsiye: Control Hub collabmigrationtestGRP’de Giden Çağrı Planını manuel olarak ________________________________________________________________________________ yapılandırın_engg 

Çıkış

output// dizininde bir çıktı JSON (customer.json) dosyası bulunacaktır. Örnek customer.json dosyası aşağıdaki gibidir:

{ "customer": { "provisioningId": "!!!!!!!!!!DEĞIŞTIR_ŞUNUNLA_HAZIRLANINGID!!!!!!!!!!", "paketleri": [ "webex_calling"..."common_area_calling" ], "externalId": "external_id_engg_grp1", "adres": { "addressLine1": "100 Main Street", "addressLine2": "", "şehir": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "ülke": "ABD" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "konum": { "name": "Main", "adres": { "addressLine1": "100 Main Street", "addressLine2": "", "şehir": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "ülke": "ABD" }, "saat dilimi": "Amerika/New_York", "dil": "en_us", "sayılar": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info": {" içinservice_provider_id": "collabmigrationtestSP_engg"..."group_id": "collabmigrationtestGRP_engg" }, "aboneler": [ { "amareswaranvel+benjaminjack@gmail.com": { "abone": { "customerId": "!!!!!!!!!!DEĞIŞTIR_ŞUNUNLA_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "hazırlamaParametreleri": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "etkin": true, "karşılama": "VARSAYILAN" }, "sendUnansweredCalls": { "etkin": true, "karşılama": "VARSAYILAN", "numberOfRings": 3 }, "messageStorage": { "mwiEtkin": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!DEĞIŞTIR_ŞUNUNLA_PERSONID!!!!!!!!!!", "ürün": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "abone": { "customerId": "!!!!!!!!!!DEĞIŞTIR_ŞUNUNLA_CUSTOMERID!!!!!!!!!!", "e-posta": "amareswaranvel+lucasoliver@gmail.com", "paket": "webex_calling", "hazırlamaParametreleri": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "etkin": true, "karşılama": "VARSAYILAN" }, "sendUnansweredCalls": { "etkin": true, "karşılama": "VARSAYILAN", "numberOfRings": 3 }, "messageStorage": { "mwiEtkin": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "cihazlar": [ { "cisUuid": "!!!!!!!!!!PERSONID!!!!!!!!!!", ILE_DEĞIŞTIRME_"ürün": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "abone": { "customerId": "!!!!!!!!!!CUSTOMERID_ILE_DEĞIŞTIRME!!!!!!!!!!", "e-posta": "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": { "etkin": true, "karşılama": "VARSAYILAN" }, "sendUnansweredCalls": { "etkin": true, "karşılama": "VARSAYILAN", "numberOfRings": 3 }, "messageStorage": { "mwiEtkin": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "abone": { "customerId": "!!!!!!!!!!DEĞIŞTIR_ŞUNUNLA_CUSTOMERID!!!!!!!!!!", "e-posta": "amareswaranvel+owenalex@gmail.com", "paket": "webex_calling", "hazırlamaParametreleri": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "etkin": true, "karşılama": "VARSAYILAN" }, "sendUnansweredCalls": { "etkin": true, "karşılama": "VARSAYILAN", "numberOfRings": 3 }, "messageStorage": { "mwiEtkin": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_ŞUNUNLA_PERSONID!!!!!!!!!!", "ürün": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "zamanlamalar": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Otomatik Ses Portalı", "firstName": "Otomatik", "lastName": "Ses Portalı", "languageCode": "en_us", "phoneNumber": "+15205551105", "extension": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Cihaz Profili" ], "connect_client_to_upgrade_to_webex_app": [], "konumlar": [], "webex_for_broadworks_info": { "kullanıcılar": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgKimliği": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

Hazırlama aracı, genellikle (iş ortağının yönetici dizüstü bilgisayarı) herhangi bir makinede çalışabilir ve Webex Herkese Açık API'lerini kullanır. Dönüştürme aracı çıkışı JSON (customer.json) dosyasını, Webex Wholesale RTM çözümünde müşterilerin, konumların, numaraların, kullanıcıların, hizmetlerin ve cihazların girdi ve sağlama olarak okur.

Ön koşullar

Hazırlama aracı dizininde aşağıdaki ön koşulları yapılandırın:

1. Bilgisayara Java 8, 11 veya 17'yi yükleyin. Java, aşağıdakiler de dahil olmak üzere birçok kaynaktan kullanılabilir:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Geçiş araçları ikili dosyalarını indirip çıkardıktan sonra, MAC için provisioning_tool.sh ve Windows için provisioning_tool.bat dosyasında JAVA_HOME ortam değişkenini ayarlayın.
3. partner.cfg dosyası:
   • WHOLESALE_HAZIRLAMA_KIMLIĞINI ve REFRESH_TOKEN'ı ayarlayın (Token Token Jeneratör Aracından kopyalandı). Iş ortağı yöneticilerinin, SAĞLAMA_kimliğini almak için hesap ekipleriyle iletişim kurması gerekir:

     TOPTAN_HAZIRLAMA_KIMLIĞI = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Eğer iş ortağı kullanıcılara karşılama e-postası göndermek istemiyorsa, IZIN VER_YÖNETICI_DAVET ET_E-POSTALARINI yanlış ayarlara getirin. Varsayılan değer doğrudur.

4. BroadWorks aboneleri için Webex parola isteği e-posta konusunu göndermek üzere BroadWorks için Webex4bwks_EMAIL_SUBJECT özelliğini kullanın.
5. BroadWorks aboneleri için Webex parola isteği e-posta gövdesini göndermek üzere BroadWorks için Webex4bwks_EMAIL_BODY özelliğini kullanın.

BroadCloud geçişleri için aynı bölge:

1. Araç numaraları, cihazları ve Paylaşılan Çağrı Görünümleri sağlamayı atlayacaktır.
2. Araç, dahili ve geçici dahili numaraya sahip kullanıcıları ve sanal kullanıcıları oluşturacaktır.

BroadCloud geçişleri için başka bir bölge:

1. Araç, numara, cihaz ve Paylaşılan Çağrı Görünümleri sağlayacaktır.
2. Araç, gerçek telefon numaralarına ve dahili numaraya sahip kullanıcıları ve sanal kullanıcıları oluşturacaktır.
   Tüm Avrupa BroadCloud göçleri başka bir bölgeye.

Çalıştırma talimatları

Aracı Windows ve macOS'ta çalıştırmak için aşağıdaki adımları kullanın:

Windows

Aracı Windows işletim sisteminde çalıştırmak için aşağıdaki adımları uygulayın:

Tek müşteri sağlamak için: provision.bat -input= Birden fazla müşteriyi sağlamak için: provision.bat -input= 

macOS

Aracı macOS'ta çalıştırmak için aşağıdaki adımları uygulayın:

Tek müşteriyi sağlamak için: ./transform.sh -input= Birden fazla müşteriyi sağlamak için: ./transform.sh -input= 

BroadWorks Geçişi için Webex Ön Koşulları

Iş Ortağı Yöneticilerinin, BroadWorks birlikte yaşama özellikleri için Webex için BroadWorks ekleme şablonlarını güncellemesi gerekir. Aşağıdaki resme bakın:

BroadWorks'ten Toptan Satış geçişi için sağlama aracını ek bir Webex argümanıyla çalıştırın.

Hazırlık aşaması: Yöneticilerin BroadWorks kullanıcılarını Toptan Satış abonesi olarak sağlayabileceği ve BroadWorks kullanıcıları için Webex ile devam edebileceği varsayılan aşamadır.

Bakım aşaması: Yöneticilerin, BroadWorks kullanıcıları için mevcut Webex'e Toptan Satış lisansı atayabileceği ikinci aşamadır. Sağlama aracını bir argüman bakımı ile çalıştırmanız gerekir.

Geçiş Sonrası aşaması: Yöneticilerin BroadWorks'ü tamamen Wholesale'a dönüştürebileceği son aşama mı? Sağlama aracını bir argüman postmigration ile çalıştırmanız gerekir.

Terminal günlükleri

Terminaldeki başarılı sağlama hakkındaki günlükler aşağıdadır:

Araç Adı: Sağlama Aracı Sürümü: 1.15.0 ********** Işleme Başladı Dosyası : input/customer.json **************** Müşteri Sağlama Müşteri external_id_engg_grp1'in sağlamayı tamamlamasını bekliyor... Müşteri external_id_engg_grp1'in sağlamayı tamamlaması bekleniyor...   Müşteri external_id_engg_grp1 durumu: sağlanan Sağlama Numaraları Sağlama Kullanıcılar Sağlama Kullanıcı Özellikleri Sağlama Karşılamalar Sağlama Hazırlama Planları Hazırlama Cihazları Sağlama Paylaşılan Çağrı Görünümleri Sağlama Otomatik Santraller Sağlama Çağrı Sıraları Sağlama Çağrı Yakalama Grupları Sağlama Grup Sağlama Çağrı Grupları Sağlama Çağrı Çağrı Parkları Sağlama Çağrı Alımları Sağlama Ses Portalı ********** Tamamlanan Dosya : giriş/müşteri.json **************** 

Her çalışma için oluşturulan konum sayısını içeren bir tablo yazdırılır:

Çıkış

Sağlama aracı, Webex Teams içinde başarı ve hata raporları oluşturur: çıktı/<external_id>/*.başarı/hata dosyaları. Başarılı sağlamayı doğrulamak için çıktı başarısı ve hata günlüklerini inceleyin.

Iş ortağı yöneticileri, Partner Hub ve Control Hub portalında müşteri sağlamayı doğrulayabilir. Partner Hub ve Control Hub portalından aşağıdaki resimlere bakın:

Şekil 8: İş Ortağı Hub'ı

Şekil 9: Control Hub’ı

Şekil 10: Cihazlar

Şekil 11: Arıyor

BroadCloud için

BroadCloud iş ortakları için numara, cihaz ve SCA geçişleri için geçiş isteği göndermek üzere Hizmet Sağlayıcı portalını kullanın.

Hizmet Sağlayıcı portalında, geçiş isteği en fazla 50 müşteri içerebilir. Bir gün içinde en fazla 10 istek gönderilebilir.

Aşağıdaki şekillerde Hizmet Sağlayıcı portalı gösterilmektedir.

Şekil 12: Hizmet Sağlayıcı portalı

Şekil 13: Hizmet Sağlayıcı portalı

Cisco BroadWorks için ve BroadWorks için Webex

Cisco BroadWorks ve BroadWorks Webex için araç, iş ortağı ağında ikincil Cisco BroadWorks Uygulama Sunucusunda çalışır ve OCI-P aracılığıyla AS'ye bağlanır. Transform Tool çıkışı JSON (customer.json) dosyasını giriş olarak kullanır ve cihazları ve yazılım istemcilerini taşımak için OCI-P komutlarını yürütür.

Başarılı işlem sırasında, cihaz taşıma aracı şunları yapar:

1. Cisco BroadWorks'teki cihazların kaydını silip Wholesale'a kaydedin.
2. UC-One istemcisini kullanan kullanıcılar, ilk kez oturum açmada Webex Uygulamasına yönlendirecektir.
3. Cisco BroadWorks'ten Telefon Numaralarını devre dışı bırakın veya telefon numaralarını BroadCloud'dan kaldırın.
4. Toptan Satış'ta numaraları etkinleştirin.
5. BroadCloud geçişleri için Toptan Satış’ta Paylaşılan Çağrı Görünümleri oluşturun. [Bu adım yalnızca BroadCloud geçişleri için geçerlidir].

SCP ve SSH'ı

1. SCP cihaz taşıma aracını ikincil Cisco BroadWorks Uygulama Sunucusuna taşır.
2. Ön koşulları yapılandırmak ve cihaz taşıma aracını çalıştırmak için ikincil Cisco BroadWorks Uygulama Sunucusuna SSH.

Ön koşullar

1. conf/partner.cfg dosyasında REFRESH_TOKEN'ı (Token Generator Tool'dan kopyalandı) ayarlayın:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Ikincil Cisco BroadWorks Uygulama Sunucusu Kullanıcı Kimliğinin, Parolasının ve Ana Bilgisayar Adının conf/deviceMoveTool.conf dosyasında doğru olduğundan emin olun:

   BROADWORKS_KULLANICI_KIMLIĞI = yönetici BROADWORKS_PAROLA = yönetici BROADWORKS_TOPLANTI SAHIBI_ADI = yerel toplantı sahibi 

3. devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

   adresinde JDK/JRE ortam yolunun doğru olduğunu doğrulayın.
4. Yöneticiler, bir işletme altındaki tüm grupları yerine belirli grupları taşımak için giriş dizinindeki locations.csv dosyasını kullanabilir.

Polycom telefonları

Polycom telefonlarını Cisco BroadWorks'ten Toptan Arama'ya taşımak için, bir iş ortağı yöneticisinin her Polycom cihaz şablonunda Sistem düzeyinde yeni bir Kimlik/Cihaz Profili Türü Dosyası oluşturması gerekir. Şekil 14’e bakın ve özel dosya dosyasını device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg yükleyin. Yeni cihaz dosyasını yükledikten sonra, yeni oluşturulan dosyanın Grup düzeyinde mevcut olduğundan emin olun. Bu dosyayı da migration_%BWMAC ADDRESS%.cfg, sisteminizdeki mevcut herhangi bir dosyayla çakışmaz).

Cihaz taşıma aracı tarafından dahili olarak kullanılır.

Polycom telefonları için geçiş süreci:

1. Cihaz taşıma aracı, cihaz düzeyindeki file.cfg dosyasını %BWMACADDRESS%2.cfg ile polycom_vvxdeğiştirir. Bu dosyanın migration_%BWMACADDRESS%.cfg için geçerli olduğunu unutmayın.
2. Cihaz profillerini grup düzeyinde veya cihaz düzeyinde yeniden oluşturun.
   Grup düzeyinde veya cihaz düzeyinde hareket etmek, dosya device-move-tool/conf/partner.cfg içindeki deviceLevelRebuild parametresinin yapılandırmasına bağlıdır.
3. Cihaz taşıma aracı, Cisco BroadWorks Uygulama Sunucusundan telefonları grup düzeyinde veya cihaz düzeyinde yeniden başlatmasını ister.
4. Yeniden başlatma talebinden sonra, Polycom telefonları indirme ve işleme% BWMACADDRESS%.cfg, Polycom telefonlarının indirilmesini ve işlenmesini ister. migration_%BWMACADDRESS%device.prov.serverName olarak ayarlanan .cfg https://plcm.sipflash.com.
   https://plcm.sipflash.com ABD bölgesi için, diğer bölgeler farklı URL'lere sahiptir.
5. Polycom telefonu, %BWMACADDRESS%.cfg dosyasını indirir https://plcm.sipflash.com ve Webex Calling DMS tarafından yönetilir.

Şekil 14: Kimlik/cihaz profili türü dosya ekle

Çalıştırma talimatları

DMT'yi çağırmak için iki yöntem vardır, birincisi bir seferde tek müşteri aramaktır, diğeri de aynı anda birden fazla müşteri aramaktır.

Cihaz taşıma aracı, cihaz taşıma aracı dizininin içindeki ikincil Cisco BroadWorks Uygulama Sunucusundan çalıştırılır:

Tek müşteriyi cihaz taşıma için: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Birden fazla müşteriyi cihaz taşıma için: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Ayrıca, cihaz taşıma aracı tek/belirli telefonların 1.35.0 sürümünden geçirilmesini destekler. Aşağıdaki komutu kullanın: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Terminal günlükleri

Cihaz taşıma için cihaz taşıma aracını başarıyla çalıştıran terminaldeki günlükler aşağıdadır:

Araç Adı: Aygıt Taşıma Aracı Sürümü: 1.15.0 Cihaz Aracı Başlatıldı... Taşıma için geçerli Cihazlar: ------------------------------------------------------------------------------------------------------------------- | Cihaz Türü | Mac | Sürümü | E-posta | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Tüm bu cihazları taşımak istiyor musunuz? ([Y]es veya [N]o) evet DMS için Cihaz Profilleri Yükleniyor Cisco MPP LC Cihazı Yeniden Oluşturma Işlemi Başlatıldı Cihazı Yeniden Oluşturma Işlemi Başarıyla Tamamlandı Yeniden Başlatma Işlemi Başlatıldı Yeniden Başlatma Işlemi Başarıyla Tamamlandı Grup iş birliği altında Business Communicator için profillerin değiştirilmesi_engg Müşteri kuruluş kimliği için webex telefon numaralarını etkinleştirme işlemi başlatıldı 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Müşteri kuruluş kimliği için tamamlanan Webex telefon numaralarını etkinleştirme işlemi: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Broadworks telefon numaralarını devre dışı bırakma işlemi başlatıldı groupId: collabmigrationtest_engg GRP BroadWorks telefon numaralarını devre dışı bırakma işlemi groupId için tamamlandı: collabmigrationtest_engg GRP Cihaz Geçişi Tamamlandı 

Çıkış

Cihaz geçişinin ardından, cihazlar çevrimiçi hale geldi ve çağrı yapmaya/almaya hazır hale geldi. Cihaz durumunun bir örneğini görmek için şekil 15'e bakın:

Şekil 15: Cihaz durumu

Cihaz geçişinden sonra numaralar etkin hale gelir. Bir sayı örneğinin etkin olduğunu görmek için şekil 16'ya bakın:

Şekil 16: Etkin numaralar

Geri alma işlemi, her seferinde bir kuruluş için yürütülmelidir.

BroadCloud Carrier için

BroadCloud iş ortakları için geri alma işlemi aşağıdaki gibidir:

1. Cihazların geri alınmasını istemek için Cisco TAC’de bir bilet açın.
2. Geri alma modunda aygıtı taşıma aracını çalıştırın:
   • Telefon numaralarının ataması Webex Calling’den kaldırılacak ve kullanıcıların ve hizmetlerin yalnızca dahili numaralara sahip olması kaldırılacaktır.
   • Webex Calling'deki e-posta adresleri geçici e-posta adreslerine döndürülecektir.
   • Telefonlar Webex Calling'den silinir.
   • Telefon numaraları, altertedIds olarak kullanılan e-posta adresleri ve telefonlar BroadCloud'da yeniden oluşturulur.
   • Telefonlar yeniden başlatılır.
3. Iş ortağı yöneticilerinin, PSTN telefon numaralarını BroadCloud Carrier'a geri taşımaları gerekir.

Cisco BroadWorks için ve BroadWorks için Webex

Cisco BroadWorks ve BroadWorks için Webex için geri alma işlemi aşağıdaki gibidir:

1. Cihazların geri alınmasını istemek için Cisco TAC’de bir bilet açın.
2. Cihaz geçişlerini geri döndürmek için ikincil BroadWorks Uygulama Sunucusunda geri alma modunda cihaz taşıma aracını çalıştırın. Bu, DMS URL'sini Cisco BroadWorks'teki cihaz profilleri için hizmet sağlayıcısı DMS URL'sine geri ayarlar ve telefon numaralarını yeniden etkinleştirir.
3. Webex Calling Ekibi, Webex Calling’deki cihaz profillerinde DMS URL’sini hizmet sağlayıcı DMS URL’sine tekrar ayarlar.
4. Iş ortağı yöneticilerinin, Control Hub portalı aracılığıyla Webex Calling’deki telefon numaralarını devre dışı bırakması veya silmesi gerekir.
5. Iş ortağı yöneticilerinin, PSTN telefon numaralarını Cisco BroadWorks'e geri taşımaları gerekir.

Geri alma modunda cihaz taşıma aracını çalıştırma talimatları

Cihazı taşıma aracını geri alma modunda çalıştırmak için aşağıdaki adımları izleyin:

Aşağıdaki komutu, cihaz taşıma aracı dizinindeki ikincil Cisco BroadWorks Uygulama Sunucusunda çalıştırın:

Profilleri geri al

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Numaraları geri al

./devicemove.sh -input=  -revertNumbers

Terminal günlükleri

Geri döndürme işlemi için cihaz taşıma aracını başarıyla çalıştıran terminalde aşağıdaki günlükleri alacağız:

Profilleri geri al

Araç Adı: Aygıt Taşıma Aracı Sürümü: Geri Alma Işlemi için 1.15.0 Aygıt Aracı Başlatıldı... Webex Calling’den BroadWorks’e geri taşınabilen cihazlar: - ------------------------------------------------------------------------------------------------------------------- | Cihaz Türü | Mac | Sürümü | E-posta | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Bu cihazları Webex Calling'den BroadWorks'e geri taşımak istiyor musunuz? (Evet, E, Hayır, N):  evet DMS için Cihaz Profillerini Yükleme Cisco MPP LC Cihazı Yeniden Oluşturma Işlemi Başlatıldı Cihazı Yeniden Oluşturma Işlemi Başarıyla Tamamlandı Yeniden Başlatma Işlemi Başlatıldı Yeniden Başlatma Işlemi Başarıyla Tamamlandı Geri Alma Işlemi Için Cihaz Geçişi Başarıyla Tamamlandı 

Numaraları geri al

Araç Adı: Aygıt Taşıma Aracı Sürümü: 1.15.0 Numaraları Broadworks’e geri döndürmeye devam etmek istiyor musunuz?  ([Y]es veya [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Geri dönüş başlatılıyor Broadworks telefon numaralarını etkinleştirme işlemi groupId için başlatıldı: collabmigrationtestGRP_engg GroupId için tamamlanan broad works telefon numaralarını etkinleştirme işlemi: collabmigrationtest_engg GRP Cihaz Geçişi Geri Alma işlemi Başarıyla Tamamlandı