Adobe Connect 12.12 LiveKit kurulumu (Gelişmiş Ses-Video kurulumu)

Ara

Giriş

Adobe Connect, gelişmiş ses ve video yetenekleri sağlamak için açık kaynak WebRTC tabanlı medya sunucusu olan LiveKit'i kullanır. Bu LiveKit tabanlı Gelişmiş Ses-Video kurulumu genellikle belirli rollere sahip birden fazla Linux® düğümünde çalışır: sinyalizasyon düğümleri, LiveKit medya/SIP düğümleri ve kayıt ile ASR (altyazı) düğümleri.Bu kurulum ayrıca PostgreSQL, Redis ve bir NATS mesaj veri yolu kümesi (LiveKit'in medya ve SIP sunucuları tarafından gerekli) kullanır; bunlar kullanıma bağlı olarak aynı veya ayrı makinelerde kurulabilir.

Her düğüm için yükleme işlemi, yükleyici zip dosyasını düğüme kopyalayıp bağımlılık yükleme betiği çalıştırıldıktan sonra yapılandırma dosyalarını düzenleyerek ve son olarak ana yükleme betiği çalıştırılarak gerçekleştirilir. Aşağıda ele alınan konular:

Bu adımlar Yükleme bölümünde açıklanmaktadır.

Ön koşullar ve sistem gereksinimleri

Gelişmiş Ses/Video sunucuları/düğümleri için boyut tahmini

session_participants_count.sql dosyası, gelişmiş ses/video sunucularının boyutunu tahmin etmek için çalıştırılabilir. SQL sorgularından elde edilen çıktı, bir Excel dosyası olan Additional Enhanced A/V hardware Livekit-estimator.xlsx hesaplayıcısına girdi olarak kullanılır.

Hesaplayıcı, Adobe Connect'in geçmiş kullanımına dayanarak gereken VM sayısını tahmin etmeye yardımcı olur. Hesaplayıcının aşağıdaki girdilere ihtiyacı vardır:

  • Sunucu CPU çekirdekleri ve RAM sayısı.
  • Bağlı SQL sorguları, son 12 ayda gerçekleştirilen eşzamanlı oturumların sayısının en fazla kaç olduğunu ve katılımcıların ortalama sayısını belirlemek için kullanılır.
  • Her bir oturum için tahmin edilen yayıncı sayısı. Yayıncı, toplantı odasında mikrofonunu (sessiz veya ses açık olarak) ve web kamerasını (canlı veya duraklatılmış olarak) bağlayan bir toplantı katılımcısıdır (toplantı sahibi, sunucu veya katılımcı).
Not

Hem session_participants_count.sql hem de Additional Enhanced A/V hardware Livekit-estimator.xlsx dosyaları Installer paketine dahildir ve başka yerde bulunmaz.

Port açma gereksinimleri

Kaynak Hedef Port aralığı Protokol Kullanım
WebRTC LB Sinyal Düğümü 18443 TCP WebRTC Sinyalizasyonu
0.0.0.0 WebRTC LB 443 TCP WebRTC Sinyalizasyonu
Connect Pro Server WebRTC LB 443 TCP  
Kendi Sinyal Düğümü 6379 TCP Redis
Medya Sunucusu Düğümü Sinyal Düğümü 6379 TCP Redis
Kayıt düğümü Sinyal Düğümü 6379 TCP Redis
Medya Sunucusu Düğümü Sinyal Düğümü 4222 - 4224 TCP NATS
Kendi Sinyal Düğümü 5432 TCP Postgres
Kendi Sinyal Düğümü 6222 TCP NATS
Kendi Sinyal Düğümü 7890 TCP LiveKit LB
Sinyal Düğümü Connect Pro Server LB 443 TCP  
Otomatik Alt Yazı/ASR Düğümü Sinyal Düğümü 7890 TCP LiveKit LB
Otomatik Alt Yazı/ASR Düğümü WebRTC LB 443 TCP WebRTC Sinyalleme
Medya Sunucusu Düğümü Sinyal Düğümü 7890 TCP LiveKit LB
Kendi Otomatik Alt Yazı/ASR Düğümü 6000 TCP Altyazı Hizmeti
Sinyal Düğümü Kayıt Düğümü 5000-5100 TCP Kayıt İsteği
Connect Pro Server Kayıt Düğümü 80 TCP Kaydı İndir
Sinyal Düğümü Medya Sunucusu Düğümü 7880 TCP WebRTC Sinyalleme
Kendi Medya Sunucusu Düğümü 6883 TCP Küme Bağlantısı
Kendi Medya Sunucusu Düğümü 6884 UDP Küme Bağlantısı
0.0.0.0 Medya Sunucusu Düğümü 50000 - 60000 UDP SRTP (gerçek zamanlı medya akışı)
Kendi Medya Sunucusu Düğümü 30000 - 40000 UDP TURN Aktarması
0.0.0.0 Medya Sunucusu Düğümü 3478 UDP UDP Üzerinden TURN
0.0.0.0 Medya Sunucusu Düğümü 443 TCP TLS Üzerinden TURN
0.0.0.0 Medya Sunucusu Düğümü 5060 UDP SIP
0.0.0.0 Medya Sunucusu Düğümü 5060 TCP SIP
0.0.0.0 Medya Sunucusu Düğümü 10000-20000 UDP SIP
Otomatik Alt Yazı/ASR Düğümü Medya Sunucusu Düğümü 50000 - 60000 UDP SRTP (gerçek zamanlı medya akışı)
Otomatik Alt Yazı/ASR Düğümü Medya Sunucusu Düğümü 3478 UDP UDP Üzerinden TURN
Kayıt düğümü Medya Sunucusu Düğümü 50000 - 60000 UDP SRTP (gerçek zamanlı medya akışı)
Kayıt düğümü Medya Sunucusu Düğümü 3478 UDP UDP Üzerinden TURN
Kayıt düğümü WebRTC LB 443 TCP WebRTC Sinyalleme

0.0.0.0 = Kullanıcılar/İstemci/İnternet

LiveKit yerinde kurulumu için yük dengeleme ayarlayın

Yük dengeleme genellikle aşağıdaki yapılandırmayla harici Uygulama Yük Dengeleyici aracılığıyla yapılır.

  • 443 numaralı HTTPS bağlantı noktası: 18443 numaralı HTTP bağlantı noktası sinyal düğümleri - CPS ve Son Kullanıcılar bu dinleyiciye bağlanır. Bu, yeni WebRTC kümesinin giriş noktasıdır.

Daha fazla bilgi için Gelişmiş Ses/Video (WebRTC) yerinde kurulumu için yük dengeleme ayarlama sayfasını görüntüleyin.

Not

LiveKit motoru için yük dengeleme yalnızca 18443 bağlantı noktası için gereklidir - LiveSwitch motorundan farklı olarak, yük dengeleme yapılacak ayrı bir yönetici paneli bağlantı noktası (9090) yoktur.

Ortamı hazırlama

Bir LiveKit kurulumu için en az dört Red Hat sunucusu gerekir: Sinyalleme, Medya, Kayıt ve ASR düğümleri için birer tane.Tahmin aracı, toplantı yüküne dayalı olarak birden fazla Medya Sunucusu, Kayıt düğümü, ASR düğümü ve Sinyalleme düğümü önerebilir.SSL boşaltma ve CPS ile son kullanıcı istemcileri ile Sinyalleme Düğümleri arasındaki iletişim için Uygulama Yük Dengeleyici kullanılır.

Burada, en yaygın dört sunucu kurulumunu ayrıntılı olarak açıklayacağız.

  • 4 adet Red Hat sunucusu sağlayın. Lütfen yapılandırma için Donanım tahmin aracına başvurun.
  • Yükleme için sudo erişimine sahip root olmayan bir kullanıcı gereklidir.
    • Red Hat yeni olarak yüklendikten sonra yeni bir kullanıcı kimliği oluşturun.
    • RHEL'de sudo'yu yeni bir kullanıcı kimliği için etkinleştirmek üzere kimliği wheel grubuna ekleyin:
      • su komutunu çalıştırarak root olun.
      • usermod -aG wheel kullanıcı_kimliğiniz komutunu çalıştırın.
      • Oturumu kapatın ve yeni kimliği kullanarak yeniden oturum açın.

Yükleyici zip dosyasını kopyalayın

  1. Patch_ACS_12_12_0_EnhancedAV.zip dosyasını tüm düğümlerin ana dizinine kopyalayın.Örneğin, scp Patch_ACS_12_12_0_EnhancedAV.zip -i ssh_key.pem my-user@webrtc.corp.example.com:/home/my-user/

  2. İsteğe bağlı olarak, Jarsigner'ı kullanarak indirilmiş imzalı zipi doğrulayın. Jarsigner, Java'nın bir parçası olarak yüklenir.

    1. JAVA indirilirken [ java -version ] komutunun kullanılıp kullanılmadığını doğrulayın. Java yüklenmişse çıktı olarak JAVA versiyonunu elde edersiniz.
    2. Makinede Java yoksa, Java'yı yükleyin.

      sudo yum install java-1.8.0-openjdk-devel

    3. Şimdi aşağıdaki komutu Terminal penceresine kopyalayın ve Enter'a tıklayın.

      jarsigner -verify -verbose Patch_ACS_12_12_0_EnhancedAV.zip

    4. Doğrulama çıktısı şunları içerir:
      • zip içerisindeki dosyaların listesi
      • kimlik doğrulama için Adobe'den gelen sertifika bilgileri
      • Başarılı çıktı mesajı olan "jar is verified" veya başarısız çıktı mesajı olan "jar is not verified"
    5. Sertifika bilgileri geçerliyse ve başarılı doğrulama çıktı mesajı yazdırılırsa kullanıcı, zip içeriğini kullanabilir ve ardından yükleme işlemine devam edebilir. Aksi takdirde kullanıcının Adobe Destek birimiyle iletişime geçmesi gerekir.

  3. ZIP dosyasını ayıklayın. Dosyaların uygun izinlere sahip olduğundan emin olun. Komutları kullanın: Açıkça belirtilmedikçe root/sudo erişimiyle herhangi bir komut çalıştırmayın.

    unzip Patch_ACS_12_12_0_EnhancedAV.zip
    cd ~/ncc-onprem-installer/
    sudo chmod +x ExternalDependencies/install.sh
    sudo chmod +x MainInstall.sh
    sudo chmod +x check-connectivity.sh
    sudo chmod +x uninstall.sh

    Not

    İnternet erişimi olmayan veya kilitli bir ortamda kurulumu çalıştırırken aşağıdaki komutu çalıştırın:

  4. Bağımlılık yükleme betiğini çalıştırın.

    1. Kurulumu, internet erişimi olmayan veya kilitlenmiş bir ortamda yaparken harici bağımlılıkları yüklemek için aşağıdaki komutu çalıştırın. İnternet erişiminiz varsa, aşağıdaki 2. adımla devam edin.

      Yükleyici üst dizinine gidin.Örneğin, ~/ncc-onprem-installer/ dizininde olduğunuzdan emin olun.
      bash ExternalDependencies/package-util.sh --install --rhel8 komutunu RHEL8 üzerinde çalıştırın.
      RHEL9'da bash ExternalDependencies/package-util.sh --install --rhel9 öğesini çalıştırın.
      Bu işlem, kutudaki tüm zorunlu harici bağımlılıkları yükler
      Bu, her düğüm için bir kez gerekir.
    2. Yükleyici üst dizinine geçiş yapın. Örneğin, ~/ncc-onprem-installer/ dizininde olduğunuzdan emin olun.
      bash ExternalDependencies/install.sh komutunu çalıştırın. Bu işlem, kutudaki tüm zorunlu harici bağımlılıkları yükler. Bu, her düğüm için bir kez gerekir.

Kurulum işlemi

Aşağıdaki adımlar, LiveKit ortamını (örnek olarak) 4 ayrı Red Hat örneği üzerinde kurma sürecini anlatır. Bir Sinyal düğümü, bir Kayıt düğümü, bir Medya Sunucusu düğümü ve bir ASR düğümü. Her bir düğümün talimatları için, containers.conf'ta yapılandırılmış hizmetlere çok dikkat edin. Her düğümü, yapılandırma dosyalarındaki belirli bir grup hizmet/kapsayıcı ile yapılandırmanız gerekir.

** Laboratuvar sisteminde, tüm bu 'düğümleri' (Signalling, Recording, Media ve ASR Server) tek bir Linux örneği üzerinde kurabilirsiniz. Bu durumda, containers.conf'ta ortamınız için gerekli olan tüm sunucular/kapsayıcılar için "count=1" olarak ayarlama yaparsınız.

Sinyal düğümü

Sinyal düğümlerinde genellikle aşağıdaki hizmetler çalıştırılır. Her hizmet, bir docker kapsayıcısı çalıştırır.

  • config (Yapılandırma Hizmeti)
  • cas (Yeni Connect API Hizmeti)
  • apigw (API Ağ Geçidi/Yönlendiricisi)
  • nats (3 düğümlü NATS kümesi – LiveKit media/SIP sunucuları için gerekli mesaj veri yolu)
  • redis
  • postgres

Sinyal düğümleri genellikle Connect istemcisi için Harici Yük dengeleyici aracılığıyla erişilebilir olan özel alt ağdadır.

Prosedür

  1. Hosts dosyasını düzenleyin. Bu hosts dosyası girişi, dağıtımdaki her düğüme – Signalling, Media, Recording ve ASR – eklenmelidir; <private-ip> her zaman Signalling düğümünün özel IP'sine ayarlanmalıdır.nano veya vi gibi bir metin düzenleyicisi kullanabilirsiniz.

    1. /etc/hosts dosyasını nano veya vi editörü kullanarak açın (örn. sudo vi /etc/hosts).
    2. Şu satırı sona ekleyin: <private-ip> kısmını Signalling düğümünün özel IP'si ile değiştirin. Lütfen aşağıda bulunan kelimeler arasındaki boşluklara dikkat edin.

    <private-ip> controller.livekit.svc.cluster.local nats.livekit.svc.cluster.local redis.ncc.svc.cluster.local postgres.ncc.svc.cluster.local cas.ncc.svc.cluster.local config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local

    192.168.1.100 controller.livekit.svc.cluster.local nats.livekit.svc.cluster.local redis.ncc.svc.cluster.local postgres.ncc.svc.cluster.local cas.ncc.svc.cluster.local config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local

  2. Yapılandırma dosyalarını düzenleme

    ncc-onprem-installer/Config/config.conf öğesinde bulunan yapılandırma dosyasını düzenleyin. Dosyayı düzenlemeye yönelik talimatlar config dosyasına yorumlar hâlinde eklenmiştir. Bu dosyanın Signalling düğümünde düzenlenmesi gerekir; diğer düğümler bağımsız olarak düzenlemek yerine aynı dosyayı kopyalar (aşağıdaki ilgili bölümlere bakın).

    1. hostnames bloğu altındaki aşağıdaki anahtarları güncelleyin:

    Şifre Tek kutu Çoklu kutu
    fqdn NCC_FQDN (örn. webrtc.example.com) aynı
    signalingNode örnek özel IP'si Signalling düğümü özel IP'si
    configService örnek özel IP'si Signalling düğümü özel IP'si
    recordingNode instance private IP HCR node private IP
    mediaNode instance private IP Media node private IP
    sipNode instance private IP Media node private IP

    2. livekit bloğu altındaki aşağıdaki anahtarları güncelleyin (tek kutu ve çok kutu için aynı):

    Tuş Değer
    etkin "true"
    mediaServers ["<media node private IP>"]

    3. Şimdi ncc-onprem-installer/Config/containers.conf dosyasını düzenleyin.Dosyayı düzenlemeye yönelik talimatlar, dosyaya yorumlar hâlinde eklenmiştir. Bu dosya, her ana bilgisayar için ayrı olarak düzenlenmelidir (indirilecek hizmetlere ve dağıtılacak kapsayıcıların sayısına bağlı olarak).

    4. Tipik bir Sinyal Düğümünde şunlar yüklenir:

    • casServer
    • configService
    • apiGateway
    • nats (3 replica'lı NATS kümesi için sayıyı ayarlayın)
    • redis
    • postgres

    5. Yukarıdaki tüm hizmetler için count=1 olarak, diğer her şey içinse 0 olarak ayarlama yapın.

    Önemli

    Config.conf dosyasında herhangi bir değişiklik yaptıktan sonra configService için restart=1 ayarlayın.

  3. Ana yükleyici betiği çalıştırma. Ana yükleyici dizinine geçin cd ~/ncc-onprem-installer/ Ana yükleyici komut dosyasını çalıştırın, bash MainInstall.sh.Onay mesajını bekleyin. Başarı Mesajı: 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installation successful.Hata Mesajı: 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installation failed.Daha fazla bilgi için installer.log'u kontrol edin.

  4. Yükleme Doğrulama

    1. Health Checker API Düğümün health checker için şu URL'ye göz atabilirsiniz: http://<private_ip>:18443/health.Sağlıklı yanıt şu şekilde olmalıdır: 200 OK {"apigw":"ok"}. RedHat makinesinden doğrulamak için curl komutunu kullanabilirsiniz. Örneğin, curl -v http://172.31.56.203:18443/health
    2. Konteyner Durumunu Doğrulama Terminal penceresinde docker ps komutunu çalıştırın.Çıktı aşağıdaki gibi görünmeli ve hiçbir konteynerin STATUS'u yeniden başlatılmış olmamalıdır.Media düğümüne geçmeden önce nats1/nats2/nats3 konteynerlerinin hepsinin sağlıklı olduğunu onaylayın.
    CONTAINER ID   IMAGE                                                          COMMAND                  CREATED        STATUS               PORTS                                                                 NAMES
aec6e82c8a6d   docker-connect-release.dr-uw2.adobeitc.com/ncc-onprem/redis:12.4     redis-server /red...    2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:6379->6379/tcp                                              redis
5add9e041cc0   docker-connect-release.dr-uw2.adobeitc.com/ncc-onprem/postgres:12.4  postgres                 2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:5432->5432/tcp                                              postgres
991a1a6e9145   docker-connect-release.dr-uw2.adobeitc.com/ncc-onprem/lb:12.4        nginx -g daemon o...     2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:7890->7890/tcp, 80/tcp, 443/tcp, 5349/tcp                    lb
246cdf8b2fdd   docker-connect-release.dr-uw2.adobeitc.com/ncc/config:12.12.0        /bin/bash /run.sh        2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:8089->8089/tcp                                              config
c310c28f04af   docker-connect-release.dr-uw2.adobeitc.com/ncc/cas:12.12.0          /bin/bash /run.sh        2 saat önce    Yaklaşık 1 saat boyunca çalışıyor     0.0.0.0:8090->8090/tcp                                              cas
4e8fddab5aba   docker-connect-release.dr-uw2.adobeitc.com/ncc/apigw:12.12.0        /bin/bash /run.sh        2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:18080->8080/tcp, 0.0.0.0:18443->8443/tcp, 80/tcp             apigw
dd88436359bc   docker-connect-release.dr-uw2.adobeitc.com/nats:2.11.6-alpine       -cluster nats://n...     2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:4222->4222/tcp, 0.0.0.0:6222->6222/tcp, 0.0.0.0:8222->8222/tcp   nats1
d08343e01019   docker-connect-release.dr-uw2.adobeitc.com/nats:2.11.6-alpine       -cluster nats://n...     2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:4223->4223/tcp, 0.0.0.0:6223->6222/tcp, 0.0.0.0:8223->8222/tcp   nats2
a578607fb4cc   docker-connect-release.dr-uw2.adobeitc.com/nats:2.11.6-alpine       -cluster nats://n...     2 saat önce    2 saat boyunca çalışıyor           0.0.0.0:4224->4224/tcp, 0.0.0.0:6224->6222/tcp, 0.0.0.0:8224->8222/tcp   nats3

Medya Sunucusu Düğümü

Medya düğümlerinde şu hizmetleri çalıştırabilirsiniz:

  • livekit-server (Media Server): Gelişmiş Ses ve Görüntü için
  • livekit-sip (SIP hizmeti): SIP kullanımı için, yalnızca livekit.enabled=true olduğunda yüklenir

Medya düğümleri, genel alt ağlarda (veya DMZ) ve genel bir IP'ye atanmış olmalı ya da 1:1 NAT aracılığıyla genel bir IP'ye eşlenmelidir. İstemciler Medya düğümlerinin Genel IP'lerine doğrudan bağlanır.

Prosedür

  1. Hosts dosyasını düzenleyin Yukarıdaki Sinyal düğümü prosedüründe belgelenen aynı /etc/hosts satırını (<private-ip> controller.livekit.svc.cluster.local nats.livekit.svc.cluster.local redis.ncc.svc.cluster.local postgres.ncc.svc.cluster.local cas.ncc.svc.cluster.local config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local) bu düğümün /etc/hosts dosyasına da ekleyin; <private-ip>'yi Sinyal düğümünün özel IP'sine ayarlayın.

  2. Yapılandırma dosyalarını düzenleme.

    • Sinyal düğümünden config.conf dosyasını kopyalayın, ~/ncc-onprem-installer/Config/config.conf – orada nelerin güncellenmesi gerektiğine ilişkin bilgi için yukarıdaki Sinyal düğümü bölümüne bakın.
    • config.conf dosyasındaki livekit bloğuna, bu düğümün özel IP adresini mediaServers dizisine ekleyin.Ayrıca config.conf dosyasındaki hostnames.mediaNode değerini bu düğümün özel IP adresiyle güncelleyin.
    • Bu düğüm aynı zamanda SIP hizmetini de çalıştırıyorsa, config.conf'da hostnames.sipNode'u bu düğümün özel IP'sine ayarlayın.
    • ~/ncc-onprem-installer/Config/containers.conf dosyasını düzenleyin ve livekitServer.count=1 olarak ayarlayın (SIP/Telefon desteği gerekirse livekitSip.count=1 değerini de ayarlayın).Ayrıca livekitServer.mediaNodeIP'yi (ve varsa livekitSip.sipNodeIP'yi) bu düğümün IP'sine güncelleyin.

  3. Ana yükleyici betiği çalıştırma. Ana yükleyici dizinine geçin cd ~/ncc-onprem-installer/ Ana yükleyici komut dosyasını çalıştırın: bash MainInstall.sh.Onay mesajını bekleyin. Başarı mesajı 2023-01-31 18:21:34,033 : INFO : Main : 55 : Kurulum başarılı.Hata Mesajı 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Kurulum başarısız.Daha fazla bilgi için installer.log'u kontrol edin.

  4. Kurulumu Doğrulayın Terminal penceresinde docker ps komutunu çalıştırın ve livekit-server konteynerinin (ve etkinse livekit-sip konteynerinin) çalıştığından emin olun.

SIP yapılandırma

LiveSwitch motorunun aksine, LiveKit motoru SIP yapılandırması için FM yönetici web panelini kullanmaz.Bunun yerine, Sinyal düğümünde, SIP trunk'ını doğrudan Config/config.conf'un livekit bloğunda yapılandırın:

livekit {
...
sipTrunkName = "<your trunk name>"
sipTrunkAddress = "<your SIP trunk address>"
sipTrunkNumber = "<your SIP trunk number>"
sipTrunkAuthUser = "<SIP trunk auth username>"
sipTrunkAuthPassword = "<SIP trunk auth password>"
}

Bu değerler Sinyal düğümünde düzenlendikten sonra, değişikliği uygulamak için Sinyal düğümünde bash MainInstall.sh'yi yeniden çalıştırın, ardından Sinyal düğümündeki cas konteynerini yeniden başlatın:

docker restart cas

Kayıt düğümü

Kayıt düğümleri özel bir ağda çalıştırılmalıdır. Kayıt düğümlerinde, şunlar arasından bir ya da daha fazla örnek çalıştırabilirsiniz:

  • hcr (Kayıt Kapsayıcısı. HCR konteyner sayısı, aynı anda çalışabilecek kayıt sayısını belirler)
  • recordingserver (Kayıtları CPS'ye sunmaya yarayan WebServer. Kayıt Düğümü başına 1)

Kayıt düğümlerine şuralardan ulaşılabilmelidir:

  • Yerel ağdan TCP 80 (böylece CPS, kayıtları indirebilir).
  • Yerel ağdan TCP 5000-5100: Bağımsız kayıt kapsayıcıları ilgili aralıktaki ana bilgisayar bağlantı noktalarına bağlı olacaktır.
  • Yerel ağdan TCP 8090.

Kayıt düğümleri; başarılı bir kayıt yapmak için Medya düğümleri bölümünde ve 443 numaralı bağlantı noktasındaki CPS'de listelenen, genel IP üzerindeki Medya düğümlerine erişebiliyor olmalıdır.

Prosedür

  1. Hosts dosyasını düzenleyin Yukarıda Sinyalleşme düğümü prosedüründe belgelenen aynı /etc/hosts satırını (<private-ip> controller.livekit.svc.cluster.local nats.livekit.svc.cluster.local redis.ncc.svc.cluster.local postgres.ncc.svc.cluster.local cas.ncc.svc.cluster.local config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local) bu düğümün /etc/hosts dosyasına da ekleyin, <private-ip> değerini Sinyalleşme düğümünün özel IP'sine ayarlayın.

  2. Yapılandırma dosyalarını düzenleme

    • config.conf dosyasını Sinyalleşme düğümünden kopyalayın, ~/ncc-onprem-installer/Config/config.conf – orada neyin güncellenmesi gerektiği için yukarıdaki Sinyalleşme düğümü bölümüne bakın; hostnames.recordingNode anahtarı zaten bu HCR düğümünün özel IP'sine işaret etmelidir.
    • Şimdi ~/ncc-onprem-installer/Config/containers.conf dosyasını düzenleyin.Dosyayı düzenlemeye yönelik talimatlar, dosyaya yorumlar hâlinde eklenmiştir.
    • Kayıt Sunucusu Düğümünde şunları yükleyebilirsiniz:
      • recordingContainer
      • recordingserver
    • recordingContainer için count >= 1 ve diğer tüm öğeler için 0 olarak ayarlama yapın. recordingServer otomatik olarak kurulacaktır.
    Not

    8 CPU başına bir kayıt kapsayıcınız olabilir. Örneğin, 16 CPU'lu bir makinede maksimum 2 kayıt konteyneri olmalıdır.

  3. Ana yükleyici komut dosyasını çalıştırın Ana yükleyici dizinine geçin cd ~/ncc-onprem-installer/ Ana yükleyici komut dosyasını çalıştırın, bash MainInstall.sh.Onay mesajını bekleyin. Başarı Mesajı 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installation successful.Hata Mesajı 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installation failed.Daha fazla bilgi için installer.log'u kontrol edin.

  4. Kurulumu Doğrulama Terminal penceresinde docker ps komutunu çalıştırın ve hcr ile recordingserver konteynerlerinin çalışıp çalışmadığını doğrulayın.

ASR Düğümü

ASR veya Kapalı Alt Yazı düğümleri özel bir ağda çalıştırılmalıdır. ASR düğümlerinde şunların örnekleri çalıştırılır:

  • asrCaptionerCpu
  • asrClient (Altyazı işlerini asrCaptionerCpu'ya yönlendiren LiveKit Agents dispatcher)

Her ikisi de yalnızca livekit.enabled=true olduğunda kurulur.

  1. Hosts dosyasını düzenleyin Sinyalizasyon düğümünün prosedüründe yukarıda belgelenen aynı /etc/hosts satırını (<private-ip> controller.livekit.svc.cluster.local nats.livekit.svc.cluster.local redis.ncc.svc.cluster.local postgres.ncc.svc.cluster.local cas.ncc.svc.cluster.local config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local) bu düğümün /etc/hosts dosyasına da ekleyin; <private-ip> değerini Sinyalizasyon düğümünün özel IP'si olarak ayarlayın.

  2. Yapılandırma dosyalarını düzenleme.

    • config.conf dosyasını Sinyalleşme düğümünden kopyalayın, ~/ncc-onprem-installer/Config/config.conf – orada neyin güncellenmesi gerektiği için yukarıdaki Sinyalleşme düğümü bölümüne bakın.
    • Şimdi şunu düzenleyin: ~/ncc-onprem-installer/Config/containers.conf.
    • Bir ASR Sunucu Düğümünde şunlar kurulur: asrCaptionerCpu, asrClient. Bu nedenle asrCaptionerCpu ve asrClient için count=1 olarak ayarlayın.

  3. Ana yükleyici betiği çalıştırma. Ana yükleyici dizinine geçin cd ~/ncc-onprem-installer/ Ana yükleyici komut dosyasını çalıştırın, bash MainInstall.sh.Onay mesajını bekleyin. Başarı Mesajı 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installation successful.Hata Mesajı 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installation failed.Daha fazla bilgi için installer.log'u kontrol edin.

Adobe Connect Hizmetinde (CPS) Livekit'i Yapılandırın

Tüm Adobe Connect 12 (CPS) sunucularında şu adımlar gerçekleştirilmelidir:

  1. <Installation_Dir>/Connect/custom.ini konumunda bulunan tüm Connect sunucularının custom.ini dosyasına aşağıdaki yapılandırmaları ekleyin.

    # virgülle ayrılmış CAS keşif URL'leri listesi
# Olası değerler
WEBRTC_CAS_DISCOVERY_URLS=http://<Sinyalleşme Düğümü IP'si>:18443/api/cps/ingest
WEBRTC_CAS_DISCOVERY_URLS=http://<Yük Dengeleyici URL'si>/api/cps/ingest
# CAS için paylaşılan gizli anahtar, CAS'a yapılan istekleri imzalamak için kullanılır.Sinyal düğümündeki hmac bölümünde bulunan config.conf dosyasındaki değeri girin.
WEBRTC_CAS_SHARED_SECRET - # Shared secret for JWT. Sinyal düğümündeki config.conf dosyasında bulunan jwtZonalSecrets bölümünün altında belirlediğiniz değeri girin. CAS_JWT_SHARED_SECRET=<CorrectHorseBatteryStaple>
# Gelişmiş Ses-video için LiveKit motorunu etkinleştir
ENABLE_LIVEKIT=true
DEFAULT_LIVEKIT_FOR_ACCOUNTS=true

  2. Dosyayı kaydedin ve connectpro hizmetini yeniden başlatın.

  3. Aşağıdaki API'yi çağırın:

    https://server_domain/api/xml?action=acl-field-update&field-id=1267&value=true&acl-id=<account-id>

Kurulum sonrası işlem

  1. Ağ bağlantısını doğrulayın.Farklı düğümler arasındaki ağ bağlantısını doğrulamak için Bağlantı Testi iş akışını çalıştırın:

    • Sinyal Düğümüne giriş yapın.
    • Installer'ın üst dizinine geçin, örneğin, cd ~/ncc-onprem-installer/ncc-onprem-installer/
    • bash check-connectivity.sh komutunu çalıştırın.
    • Bağlantı aracı Config.conf dosyasında sağlanan değerleri kullanarak şu temel ağ testlerini çalıştırır:
      • Farklı hizmetler arasındaki HTTP istekleri
      • Gerekli TCP ve UDP bağlantı noktalarındaki ağ bağlantısı testleri
      • Ad çözümlemesi
      • NATS kümesi dahil veritabanı bağlantısı
    • Bu test, düğümler ve hizmetler arasında gerekli bağlantıyı kontrol eder ve ağ bağlantı sorunlarını tanılamaya yardımcı olmak için sonuçları paylaşır.

  2. LiveKit tabanlı Gelişmiş Ses-Video ile Adobe Connect Meeting'i test edin

    • Yeni bir toplantı oluşturun ve Gelişmiş Ses/Video seçeneğinin seçili olduğundan emin olun.
    • Toplantı odasına katılın ve Mikrofon ile Kamerayı açın.
    • Mümkünse aynı zamanda toplantıya farklı bir bilgisayar veya Mobil cihazdan katılarak ses-video paylaşımını doğrulayın.
    • Ekran Paylaşımı özelliğini deneyin.
    • Kaydetmeye başlayın. 30 saniye bekleyip durun. Şimdi, kaydın erişilebilir olup olmadığını doğrulayın.

TURNS bağlamasını yapılandırma

Güvenli TURN iletişimi sağlamak için bu işleme ihtiyaç duyulur.

LiveSwitch motorunun aksine, yönetici panelinde sertifika yükleme adımı yoktur.TURNS doğrudan config.conf'un livekit bloğundaki özel alanlar aracılığıyla yapılandırılır:

  • livekit.turnsDomain'i istemcilerin TURNS'e erişmek için kullanacağı FQDN'ye ayarlayın (443 bağlantı noktası üzerinden TLS aktarımı).Bu genellikle yalnızca istemciler ağınızın dışından veya kısıtlayıcı güvenlik duvarı ilkeleri olan diğer şirketlerden bağlandığında gereklidir.
  • Media Server düğümünde certs dizinini oluşturun: cd ~ && mkdir -p connect/turns
  • TURNS etki alanı için SSL sertifikasını ~/connect/turns/turns.crt'ye ve özel anahtarını ~/connect/turns/turns.key'e kopyalayın (veya farklı dosya adları kullanıyorsanız config.conf'taki livekit.certFileName / livekit.keyFileName'yi güncelleyin).
  • Değişikliği uygulamak için bash MainInstall.sh'yi çalıştırın.

livekit.turnsDomain boş bırakılırsa, TURNS yapılandırılmaz ve istemciler UDP/TCP 3478 üzerinden STUN/TURN'e veya SRTP media aralığına geri döner.

Kaldırma

  • Yükleyici kök dizinine geçin (kök dizin uninstall.sh dosyasını içerir): cd ~/ncc_onprem_installer.
  • Şunu çalıştırın: bash uninstall.sh.
  • Sinyal düğümünden Postgres ve Redis veritabanları veri dizinlerini kaldırmak için aşağıdaki komutu çalıştırın:

    sudo rm -rf ~/connect

Not

Bu işlem, tüm NCC bileşenlerini ve görüntüleri sistemden siler. Ancak, harici bağımlılıklar (Python, PIP, Virtualenv ve Python paketleri) silinmez.

Adobe, Inc.

Daha hızlı ve daha kolay yardım alın

Yeni kullanıcı mısınız?

Hızlı bağlantılar

Tüm planlarınızı görüntüleyin Planlarınızı yönetin
Hızlı bağlantıları görüntüleyin
Hızlı bağlantıları gizleyin

Yasal Uyarılar    |    Çevrimiçi Gizlilik İlkesi