Adobe Connect 12.12 LiveKit-installatie (Verbeterde audio-video-setup)

Inleiding

Adobe Connect gebruikt LiveKit, een open-source WebRTC-gebaseerde Media Server, om verbeterde audio- en videomogelijkheden te bieden.Deze op LiveKit gebaseerde verbeterde audio-video-setup draait doorgaans op meerdere Linux®-nodes met specifieke rollen: signalering-nodes, LiveKit media/SIP-nodes en opname- en ASR (bijschrift)-nodes.Deze setup gebruikt ook PostgreSQL, Redis en een NATS-berichtenbus-cluster (vereist door de media- en SIP-servers van LiveKit), die kunnen worden geïnstalleerd op één of afzonderlijke machines, afhankelijk van het gebruik.

Elk knooppunt wordt ingesteld door het gezipte installatiebestand naar het knooppunt te kopiëren, de configuratiebestanden te bewerken, het installatiescript voor afhankelijkheden uit te voeren en tot slot het hoofdinstallatiescript uit te voeren. Hieronder staan de onderwerpen die in het volgende worden behandeld:

Deze stappen worden beschreven in het gedeelte Installatie.

Vereisten en systeemvereisten

Grootte schatten voor verbeterde audio/video-servers/nodes

Het bestand session_participants_count.sql kan worden uitgevoerd om de grootte van de verbeterde audio/video-servers te schatten.De uitvoer van de SQL-query's is de invoer voor de calculator, wat een Excel-bestand is: Additional Enhanced A/V hardware Livekit-estimator.xlsx.

De calculator helpt bij het schatten van het aantal benodigde VM's gebaseerd op uw vorige gebruik van Adobe Connect.De rekenmachine heeft de volgende invoersets nodig.

  • Het aantal CPU-cores en RAM van de server.
  • De bijgevoegde SQL-query's die worden gebruikt om het piekaantal gelijktijdige sessies in de afgelopen 12 maanden en het gemiddelde aantal aanwezigen in die sessies te bepalen.
  • Het geschatte aantal uitgevers in elke sessie. Een uitgever is een aanwezige bij een vergadering (host, presentator of deelnemer) die zijn of haar microfoon (zowel gedempt als niet gedempt) en webcam (zowel live als gepauzeerd) in de vergaderruimte heeft verbonden.
Notitie

Zowel het bestand session_participants_count.sql als Additional Enhanced A/V hardware Livekit-estimator.xlsx zijn opgenomen in het installatiepakket en zijn nergens anders beschikbaar.

Vereisten voor het openen van poorten

Bron Bestemming Poortbereik Protocol Gebruik
WebRTC LB Signaleringsknooppunt 18443 TCP WebRTC-signalering
0.0.0.0 WebRTC LB 443 TCP WebRTC-signalering
Connect Pro Server WebRTC LB 443 TCP  
Zelf Signaleringsknooppunt 6379 TCP Redis
Mediaserverknooppunt Signaleringsknooppunt 6379 TCP Redis
Opnameknooppunt Signaleringsknooppunt 6379 TCP Redis
Mediaserverknooppunt Signaleringsknooppunt 4222 - 4224 TCP NATS
Zelf Signaleringsknooppunt 5432 TCP Postgres
Zelf Signaleringsknooppunt 6222 TCP NATS
Eigen Signaleringsknooppunt 7890 TCP LiveKit LB
Signaleringsknooppunt Connect Pro Server LB 443 TCP  
Automatische ondertiteling/ASR-knooppunt Signaleringsknooppunt 7890 TCP LiveKit LB
Automatische ondertiteling/ASR-knooppunt WebRTC LB 443 TCP WebRTC-signalering
Mediaserverknooppunt Signaleringsknooppunt 7890 TCP LiveKit LB
Eigen Automatische ondertiteling/ASR-knooppunt 6000 TCP Ondertitelingsservice
Signaleringsknooppunt Opnameknooppunt 5000-5100 TCP Opnameverzoek
Connect Pro Server Opnameknooppunt 80 TCP Opname downloaden
Signaleringsknooppunt Mediaserverknooppunt 7880 TCP WebRTC-signalering
Zelf Mediaserverknooppunt 6883 TCP Clusterverbinding
Zelf Mediaserverknooppunt 6884 UDP Clusterverbinding
0.0.0.0 Mediaserverknooppunt 50000 - 60000 UDP SRTP (realtime mediaflow)
Zelf Mediaserverknooppunt 30000 - 40000 UDP TURN Relay
0.0.0.0 Mediaserverknooppunt 3478 UDP TURN via UDP
0.0.0.0 Mediaserverknooppunt 443 TCP TURN via TLS
0.0.0.0 Mediaserverknooppunt 5060 UDP SIP
0.0.0.0 Mediaserverknooppunt 5060 TCP SIP
0.0.0.0 Mediaserverknooppunt 10000-20000 UDP SIP
Automatische ondertiteling/ASR-knooppunt Mediaserverknooppunt 50000 - 60000 UDP SRTP (realtime mediaflow)
Automatische ondertiteling/ASR-knooppunt Mediaserverknooppunt 3478 UDP TURN via UDP
Opnameknooppunt Mediaserverknooppunt 50000 - 60000 UDP SRTP (realtime mediaflow)
Opnameknooppunt Mediaserverknooppunt 3478 UDP TURN via UDP
Opnameknooppunt WebRTC LB 443 TCP WebRTC-signalering

0.0.0.0 = Gebruikers/Client/Internet

Load balancing instellen voor On-Premise installatie van Livekit

De load balancing wordt doorgaans uitgevoerd via een externe Application Load Balancer met onderstaande configuratie.

  • HTTPS-poort 443: HTTPS-poort 18443 voor signaleringsknooppunten - CPS en eindgebruikers maken verbinding met deze listener en deze wordt de ingang voor de nieuwe WebRTC-cluster.

Bekijk Load balancing instellen voor On-Premise installatie van Enhanced Audio/Video (WebRTC) voor meer informatie.

Notitie

Voor de LiveKit engine is load balancing alleen nodig voor poort 18443 – er is geen aparte beheerpaneel poort (9090) voor load balancing, in tegenstelling tot de LiveSwitch engine.

Voorbereiden van de omgeving

Een LiveKit-installatie heeft minimaal vier Red Hat servers nodig: één voor elk van de Signalling, Media, Recording en ASR nodes.De estimator kan op basis van vergaderbelasting meerdere Media Servers, Recording nodes, ASR nodes en Signalling nodes voorstellen.Een Application Load Balancer wordt gebruikt voor SSL-offloading en voor communicatie tussen CPS en clients van eindgebruikers met Signalling Nodes.

Hier beschrijven we de vier meest voorkomende serverinstellingen in detail.

  • Richt 4 Red Hat-servers in. Raadpleeg de hardwareschatter voor de configuratie.
  • De installatie vereist een niet-rootgebruiker met toegang tot sudo.
    • Nadat Red Hat opnieuw is geïnstalleerd, maakt u een nieuwe gebruikers-id.
    • Als u sudo wilt inschakelen voor de nieuwe gebruikers-id op RHEL, voegt u de id toe aan de groep wheel:
      • Word root-gebruiker door su uit te voeren.
      • Voer usermod -aG wheel your_user_id uit.
      • Meld u af en meld u weer aan met de nieuwe id.

Kopieer het Installer zip-bestand

  1. Kopieer de Patch_ACS_12_12_0_EnhancedAV.zip naar de homedirectory van alle nodes.Bijvoorbeeld, scp Patch_ACS_12_12_0_EnhancedAV.zip -i ssh_key.pem my-user@webrtc.corp.example.com:/home/my-user/

  2. Verifieer het gedownloade, ondertekende zipbestand eventueel met Jarsigner. Jarsigner wordt geïnstalleerd als onderdeel van Java.

    1. Controleer met de opdracht [ java -version ] of Java is geïnstalleerd. Als Java is geïnstalleerd, krijgt u de Java-versie als een uitvoer.
    2. Als Java niet aanwezig is op de machine, installeer dan Java.

      sudo yum install java-1.8.0-openjdk-devel

    3. Kopieer nu onderstaande commando in het Terminal-venster en druk op Enter.

      jarsigner -verify -verbose Patch_ACS_12_12_0_EnhancedAV.zip

    4. De output van de verificatie bevat:
      • een lijst met bestanden in het zipbestand
      • certificaatgegevens van Adobe voor verificatie
      • het bericht voor geslaagde uitvoer 'jar is verified' of geen geslaagde uitvoer 'jar is not verified'
    5. Als de certificaatgegevens geldig zijn en het bericht voor geslaagde uitvoer wordt weergegeven, kan de gebruiker de inhoud van het zipbestand gebruiken en doorgaan naar de installatie. Zo niet, dan moet de gebruiker contact opnemen met ondersteuning van Adobe.
  3. Pak het zipbestand uit. Zorg dat de bestanden over de juiste rechten beschikken. Gebruik de commando's: Voer geen commando uit met root/sudo-toegang tenzij dit duidelijk is aangegeven.

    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

    Notitie

    Bij het uitvoeren van de installatie in een omgeving zonder internettoegang of een beveiligde omgeving, voer je onderstaand commando uit:

  4. Het installatiescript voor afhankelijkheden uitvoeren.

    1. Als u de installatie uitvoert in een omgeving zonder internettoegang of in een vergrendelde omgeving, voert u de onderstaande opdracht uit om externe afhankelijkheden te installeren. Als je wel internettoegang hebt, ga dan verder met stap 2.

      Ga naar de Installer bovenliggende map.Zorg er bijvoorbeeld voor dat je in de ~/ncc-onprem-installer/ map bent.
      Voer bash ExternalDependencies/package-util.sh --install --rhel8 uit op RHEL8.
      Voer de volgende bash uit: ExternalDependencies/package-util.sh --install in RHEL9.
      Hiermee worden alle vereiste externe afhankelijkheden op de box geïnstalleerd.
      Dit is één keer per knooppunt nodig.
    2. Ga naar de bovenliggende map van het installatieprogramma. Zorg er bijvoorbeeld voor dat je je in de map ~/ncc-onprem-installer/ bevindt.
      Voer bash ExternalDependencies/install.sh uit. Hiermee worden alle vereiste externe afhankelijkheden op de box geïnstalleerd. Dit is één keer per knooppunt nodig.

Installatieproces

De volgende stappen leiden je door het installeren van de LiveKit-omgeving (als voorbeeld) op vier afzonderlijke Red Hat-instanties.Een signaleringsknooppunt, een opnameknooppunt, een mediaserverknooppunt en een ASR-knooppunt. Let goed op de services die zijn geconfigureerd in de containers.conf voor de instructies van elk knooppunt. U moet voor elk knooppunt een specifieke reeks services/containers configureren in de configuratiebestanden.

** Op een labsysteem kun je alle 'nodes' (Signalling, Recording, Media en ASR Server) op één Linux-instantie installeren.In dat geval zou u in containers.conf 'count=1' instellen voor alle servers/containers die u nodig hebt in uw omgeving.

Signaleringsknooppunt

U voert doorgaans de volgende services op de signaleringsknooppunten uit: Elke service wordt uitgevoerd als een dockercontainer.

  • config (configuratieservice)
  • cas (nieuwe Connect API-service)
  • apigw (API-gateway/router)
  • nats (3-node NATS-cluster – berichtbus vereist door de LiveKit media/SIP-servers)
  • redis
  • postgres

Signaleringsknooppunten bevinden zich doorgaans in het privésubnet, dat voor de Connect-client toegankelijk is via een externe loadbalancer.

Procedure

  1. Bewerk het Hosts-bestand. Deze vermelding in het hosts-bestand moet worden toegevoegd op elke node in de implementatie – Signalling, Media, Opname en ASR – waarbij <private-ip> altijd wordt ingesteld op het privé-IP-adres van de Signalling-node.U kunt ook een teksteditor als nano of vi gebruiken.

    1. Open het bestand /etc/hosts met de nano- of vi-editor, bijvoorbeeld sudo vi /etc/hosts.
    2. Voeg de volgende regel toe aan het einde van het bestand. Vervang <private-ip> door het privé-IP-adres van de Signalling-node.Let hieronder op de ruimte tussen elke woord.

    <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. De configuratiebestanden bewerken

    Bewerk het configuratiebestand in ncc-onprem-installer/Config/config.conf. De bewerkingsinstructies voor het bestand zijn als opmerkingen aan het configuratiebestand toegevoegd. Dit bestand moet worden bewerkt op de Signalling-node; andere nodes kopiëren hetzelfde bestand in plaats van het onafhankelijk te bewerken (zie hun respectievelijke secties hieronder).

    1. Werk de volgende sleutels bij onder het hostnames blok:

    Sleutel Enkele box Meerdere boxes
    FQDN NCC_FQDN (bijvoorbeeld webrtc.example.com) hetzelfde
    signalingNode privé-IP-adres van instantie Privé-IP van signaleringsnode
    configService privé-IP-adres van instantie Privé-IP-adres van signaleringsnode
    recordingNode privé-IP van instantie Privé-IP van HCR-node
    mediaNode privé-IP-adres van de instantie Privé-IP van media-node
    sipNode instantie privé IP Media node privé IP

    2. Werk de volgende sleutels bij onder het livekit-blok (identiek voor single box en multi box):

    Key Waarde
    ingeschakeld "true"
    mediaServers ["<media node privé IP>"]

    3. Bewerk nu ncc-onprem-installer/Config/containers.conf.De bewerkingsinstructies voor het bestand zijn als opmerkingen aan het bestand toegevoegd. Dit bestand moet voor elke host afzonderlijk worden bewerkt. Afhankelijk van de te installeren services en het aantal te implementeren containers.

    4. Op een typisch signaleringsknooppunt zou u het volgende installeren:

    • casServer
    • configService
    • apiGateway
    • nats (stel het aantal in voor een 3-replica NATS-cluster)
    • redis
    • postgres

    5. Stel voor alle bovenstaande services dus count=1 in en voor alle andere services 0.

    Belangrijk

    Stel restart=1 in voor configService na het aanbrengen van wijzigingen in Config.conf.

  3. Voer het hoofdinstallatiescript uit. Schakel over naar de hoofdinstallatiemap cd ~/ncc-onprem-installer/ Voer het hoofdinstallatiescript uit, bash MainInstall.sh.Wacht op het bevestigingsbericht. Succesmelding: 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installatie geslaagd.Foutbericht: 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installatie mislukt.Bekijk installer.log voor meer informatie.

  4. De installatie controleren

    1. Health Check API Voor de statuscontrole van de node kun je verkennen naar de URL: http://<private_ip>:18443/health.Een positief resultaat is 200 OK {"apigw":"ok"}. Om te controleren vanaf de RedHat-machine kun je het curl-commando gebruiken. Bijvoorbeeld: curl -v http://172.31.56.203:18443/health
    2. Containerstatus controleren Voer in het terminalvenster het commando docker ps uit.De uitvoer moet eruitzien zoals hieronder, en de STATUS mag niet opnieuw gestart zijn voor een van de containers.Bevestig dat de nats1/nats2/nats3-containers allemaal gezond zijn voordat je verdergaat naar de Media node.
    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 uur geleden    Up 2 uur           0.0.0.0:6379->6379/tcp                                              redis
    5add9e041cc0   docker-connect-release.dr-uw2.adobeitc.com/ncc-onprem/postgres:12.4  postgres                 2 uur geleden    Up 2 uur           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 uur geleden    Up 2 uur           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 uur geleden    Up 2 uur           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 uur geleden    Up ongeveer een uur     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 uur geleden    Up 2 uur           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 uur geleden    Up 2 uur           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 uur geleden    Up 2 uur           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 uur geleden    Up 2 uur           0.0.0.0:4224->4224/tcp, 0.0.0.0:6224->6222/tcp, 0.0.0.0:8224->8222/tcp   nats3

Mediaserverknooppunt

U voert de volgende services op een of meer mediaknooppunten uit:

  • livekit-server (Media Server): Voor verbeterde audio en video
  • livekit-sip (SIP-service): Voor gebruik van SIP, alleen geïnstalleerd wanneer livekit.enabled=true

Mediaknooppunten moeten zich in de openbare subnetten (of DMZ) bevinden en er moet een openbaar IP-adres aan zijn toegewezen of de knooppunten moeten via 1:1 NAT aan een openbaar IP-adres zijn gekoppeld. Clients maken rechtstreeks verbinding met de openbare IP-adressen van het mediaknooppunt.

Procedure

  1. Het hosts-bestand bewerken Voeg dezelfde /etc/hosts-regel toe die is gedocumenteerd in de procedure van de signalering-node hierboven (<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) ook aan het /etc/hosts-bestand van deze node, waarbij <private-ip> wordt ingesteld op het particuliere IP-adres van de signalering-node.

  2. De configuratiebestanden bewerken.

    • Kopieer config.conf van de signalering-node, ~/ncc-onprem-installer/Config/config.conf – zie het gedeelte over de signalering-node hierboven voor wat daar moet worden bijgewerkt.
    • Voeg in het livekit-blok van config.conf het particuliere IP-adres van deze node toe aan de mediaServers-array.Werk ook hostnames.mediaNode in config.conf bij naar het particuliere IP-adres van deze node.
    • Als deze node ook de SIP-service draait, stel dan hostnames.sipNode in config.conf in op het particuliere IP-adres van deze node.
    • Bewerk ~/ncc-onprem-installer/Config/containers.conf en stel livekitServer.count=1 in (en livekitSip.count=1 als SIP/telefonie vereist is).Werk ook livekitServer.mediaNodeIP (en livekitSip.sipNodeIP, indien van toepassing) bij naar het IP-adres van deze node.
  3. Voer het hoofdinstallatiescript uit. Schakel naar de hoofdinstallatiemap cd ~/ncc-onprem-installer/ Voer het hoofdinstallatiescript uit, bash MainInstall.sh.Wacht op het bevestigingsbericht. Succesbericht 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installatie succesvol.Foutbericht 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installatie mislukt.Bekijk installer.log voor meer informatie.

  4. Installatie controleren Voer in het terminalvenster de opdracht docker ps uit en zorg ervoor dat de livekit-server-container (en livekit-sip-container, indien ingeschakeld) actief is.

SIP configureren

In tegenstelling tot de LiveSwitch-engine gebruikt de LiveKit-engine het FM-beheerwebpaneel niet voor SIP-configuratie.Configureer in plaats daarvan op de Signalling-node de SIP-trunk rechtstreeks in het livekit-blok van Config/config.conf:

livekit {
...
sipTrunkName = "<je trunk-naam>"
sipTrunkAddress = "<je SIP trunk-adres>"
sipTrunkNumber = "<je SIP trunk-nummer>"
sipTrunkAuthUser = "<SIP trunk-authenticatie gebruikersnaam>"
sipTrunkAuthPassword = "<SIP trunk-authenticatie wachtwoord>"
}

Na het bewerken van deze waarden op de Signalling-node, voer je opnieuw bash MainInstall.sh uit op de Signalling-node om de wijziging toe te passen en start je vervolgens de cas-container op de Signalling-node opnieuw:

docker restart cas

Opnameknooppunt

Opnameknooppunten moeten in een privénetwerk worden uitgevoerd. Op opnameknooppunten kunt u een of meer exemplaren uitvoeren van:

  • hcr (Opnamecontainer. # van hcr-containers beslissen over gelijktijdige opnames die kunnen worden uitgevoerd)
  • recordingserver (WebServer om opnamebestanden aan CPS te leveren. 1 per opname-node)

Opnameknooppunten moeten bereikbaar zijn op:

  • TCP 80 vanaf het lokale netwerk, zodat CPS de opnamen kan downloaden.
  • TCP 5000-5100 vanaf het lokale netwerk; individuele opnamecontainers worden gekoppeld aan hostpoorten in dat bereik.
  • TCP 8090 vanaf het lokale netwerk.

Voor een geslaagde opname moeten opnameknooppunten de mediaknooppunten op het openbare IP op de poorten die in het gedeelte Mediaknooppunten staan en CPS op poort 443 bereiken.

Procedure

  1. Bewerk het hosts-bestand. Voeg dezelfde /etc/hosts-regel toe die is gedocumenteerd in de bovenstaande procedure van de Signalling-node (<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) aan het /etc/hosts-bestand van deze node toe, waarbij <private-ip> wordt ingesteld op het privé-IP-adres van de Signalling-node.

  2. De configuratiebestanden bewerken

    • Kopieer config.conf van de Signalling-node, ~/ncc-onprem-installer/Config/config.conf – raadpleeg de sectie over de Signalling-node hierboven voor wat daar moet worden bijgewerkt; de hostnames.recordingNode-sleutel moet al verwijzen naar het privé-IP-adres van deze HCR-node.
    • Bewerk nu ~/ncc-onprem-installer/Config/containers.conf.De bewerkingsinstructies voor het bestand zijn als opmerkingen aan het bestand toegevoegd.
    • Op een opnameserverknooppunt zou u het volgende installeren:
      • recordingContainer
      • opnameserver
    • Stel voor recordingContainer count >= 1 in en voor alle andere 0. recordingServer wordt automatisch geïnstalleerd.
    Notitie

    U kunt één opnamecontainer per 8 CPU's hebben. Op een machine met 16 CPU's moet je bijvoorbeeld maximaal 2 opnamecontainers hebben.

  3. Voer het hoofdinstallatiescript uit. Ga naar de hoofdinstallatiemap cd ~/ncc-onprem-installer/ Voer het hoofdinstallatiescript uit, bash MainInstall.sh.Wacht op het bevestigingsbericht. Succesbericht 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installation successful.Foutbericht 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installation failed.Bekijk installer.log voor meer informatie.

  4. Installatie verifiëren Voer in het terminalvenster de opdracht docker ps uit en zorg ervoor dat de hcr- en recordingserver-containers worden uitgevoerd.

ASR-knooppunt

ASR- of ondertitelingknooppunten moeten in een privénetwerk werken. Op ASR-nodes voer je instanties uit van:

  • asrCaptionerCpu
  • asrClient (LiveKit Agents dispatcher die ondertitelingsjobs routeert naar asrCaptionerCpu)

Beide worden alleen geïnstalleerd wanneer livekit.enabled=true.

  1. Bewerk het hosts-bestand Voeg dezelfde /etc/hosts-regel toe die is gedocumenteerd in de bovenstaande procedure van de signaalnode (<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) aan het /etc/hosts-bestand van deze node, waarbij <private-ip> wordt ingesteld op het privé-IP-adres van de signaalnode.

  2. De configuratiebestanden bewerken.

    • Kopieer config.conf van de signaalnode, ~/ncc-onprem-installer/Config/config.conf – raadpleeg het gedeelte over de signaalnode hierboven voor wat daar moet worden bijgewerkt.
    • Bewerk nu ~/ncc-onprem-installer/Config/containers.conf.
    • Op een ASR-servernode zou je installeren: asrCaptionerCpu, asrClient. Stel dus count=1 in voor asrCaptionerCpu en asrClient.
  3. Voer het hoofdinstallatiescript uit. Ga naar de hoofdinstallatiemap cd ~/ncc-onprem-installer/ Voer het hoofdinstallatiescript uit, bash MainInstall.sh.Wacht op het bevestigingsbericht. Succesbericht 2023-01-31 18:21:34,033 : INFO : Main : 55 : Installation successful.Foutbericht 2023-01-31 20:04:44,849 : ERROR : Main : 59 : Installatie mislukt.Bekijk installer.log voor meer informatie.

Livekit configureren in Adobe Connect Service (CPS)

De volgende stappen moet worden uitgevoerd voor elke Adobe Connect 12-server (CPS):

  1. Voeg de onderstaande configuraties toe in custom.ini van alle Connect-server(s) aanwezig op <Installation_Dir>/Connect/custom.ini.

    # kommagescheiden lijst van CAS-discovery-URL's
    # Mogelijke waarden
    WEBRTC_CAS_DISCOVERY_URLS=http://<Signalling Node IP >:18443/api/cps/ingest
    WEBRTC_CAS_DISCOVERY_URLS=http://<Load Balancer URL>/api/cps/ingest
    # Gedeeld geheim voor CAS, gebruikt om aanvragen aan CAS te ondertekenen.Geef de waarde op die u in het gedeelte hmac hebt ingesteld in het config.conf-bestand op het signaleringsknooppunt.
    WEBRTC_CAS_SHARED_SECRET - # heeft geheim gedeeld voor JWT. Geef de waarde op die u in het gedeelte jwtZonalSecrets hebt ingesteld in het config.conf-bestand op het signaleringsknooppunt. CAS_JWT_SHARED_SECRET=<CorrectHorseBatteryStaple>
    # Schakel de LiveKit-engine in voor verbeterde audio-video
    ENABLE_LIVEKIT=true
    DEFAULT_LIVEKIT_FOR_ACCOUNTS=true
  2. Sla het bestand op en start de connectpro-service opnieuw.

  3. Roep de volgende API aan:

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

Proces na installatie

  1. Controleer netwerkconnectiviteit.Voer de workflow Connectiviteitstest uit om de netwerkconnectiviteit tussen verschillende nodes te controleren:

    • Meld u aan bij het signaleringsknooppunt.
    • Ga naar de map van het Installatieprogramma, bijvoorbeeld cd ~/ncc-onprem-installer/ncc-onprem-installer/
    • Voer de opdracht bash check-connectivity.sh uit.
    • De connectiviteitstool gebruikt de opgegeven waarden in het bestand Config.conf om basale netwerktests uit te voeren zoals:
      • HTTP-verzoeken tussen verschillende services
      • Netwerkverbindingstests op de vereiste TCP- en UDP-poorten
      • Naamomzetting
      • Databaseconnectiviteit, inclusief het NATS-cluster
    • Deze test controleert de vereiste connectiviteit tussen de nodes en services en deelt de resultaten om netwerkconnectiviteitsproblemen te helpen diagnosticeren.
  2. Test Adobe Connect Meeting met op LiveKit gebaseerde Enhanced Audio-Video

    • Maak een nieuwe vergadering en zorg dat Verbeterde audio/video is geselecteerd.
    • Neem deel aan de vergadering en schakel uw microfoon en camera in.
    • Indien mogelijk neemt u ook deel vanaf een andere computer of een mobiel apparaat om de uitwisseling van audio en video te controleren.
    • Probeer het scherm te delen.
    • Begin met opnemen. Wacht 30 seconden en stop. Controleer nu of de opname toegankelijk is.

De TURNS-verbinding configureren

Dit is vereist voor beveiligde TURN-communicatie.

Anders dan bij de LiveSwitch-engine is er geen stap voor het uploaden van certificaten in een beheerderspaneel.TURNS wordt rechtstreeks geconfigureerd via speciale velden in het blok livekit van config.conf:

  • Stel livekit.turnsDomain in op de FQDN die clients gebruiken om TURNS te bereiken (TLS-relay via poort 443).Dit is meestal alleen nodig wanneer clients verbinding maken van buiten je netwerk of van andere bedrijven met restrictieve firewallbeleidsregels.
  • Maak de map certs op de node van de Media Server: cd ~ && mkdir -p connect/turns
  • Kopieer het SSL-certificaat voor het TURNS-domein naar ~/connect/turns/turns.crt en de privésleutel naar ~/connect/turns/turns.key (of wijzig livekit.certFileName / livekit.keyFileName in config.conf als je andere bestandsnamen gebruikt).
  • Voer bash MainInstall.sh uit om de wijziging toe te passen.

Als livekit.turnsDomain leeg blijft, wordt TURNS niet geconfigureerd en vallen clients terug op STUN/TURN via UDP/TCP 3478 of het SRTP-mediabereik.

Verwijderen

  • Ga naar de hoofdmap van het installatieprogramma (de hoofdmap bevat uninstall.sh), cd ~/ncc_onprem_installer.
  • Voer bash uninstall.sh uit.
  • Voer de onderstaande opdracht uit om de gegevensdirectory met Postgres- en Redis-databases van het signaleringsknooppunt te verwijderen.

    sudo rm -rf ~/connect

Notitie

Hiermee worden alle NCC-componenten en -images van het systeem verwijderd. De externe afhankelijkheden (Python-, PIP, Virtualenv- en Python-pakketen) worden echter niet verwijderd.

Adobe, Inc.

Krijg sneller en gemakkelijker hulp

Nieuwe gebruiker?