Skip to main content

Guida all'installazione di BriefCam

Installazione e configurazione di NGINX

Last Updated: 6 minute read
Versione2025r1
LinguaItaliano

Questa sezione descrive i passaggi da seguire per utilizzare NGINX.

Nota

Per lavorare con SSL e BriefCam, è necessario utilizzare un bilanciamento del carico. BriefCam Si consiglia di utilizzare NGINX.

Consigli

Si consiglia di installare il bilanciamento del carico su una macchina separata.

Se si lavora in un ambiente virtualizzato, il bilanciamento del carico deve trovarsi su un computer separato.

Se si lavora in un ambiente non virtualizzato (server fisici), è possibile avere il bilanciamento del carico sullo stesso computer dei servizi Web (anche se non è consigliato). Tuttavia, se si installa il bilanciamento del carico sullo stesso computer dei servizi Web, IIS deve lavorare su una porta diversa (non 80, poiché 80 è per NGINX).

Importante

Si consiglia di non apportare modifiche manuali al file di configurazione NGINX. Tuttavia, se si apportano modifiche, assicurarsi che tutte le modifiche siano conformi alla sintassi NGINX valida e che tutti i nomi degli endpoint siano utilizzati esattamente come definito, inclusa la distinzione tra maiuscole e minuscole.

Prerequisiti

  • Assicurarsi che le porte 80 e 443 non siano utilizzate da un'altra applicazione.

  • Se IIS è installato, assicurarsi di arrestarlo o di modificare la porta predefinita.

Operazioni

  1. Per eseguire la procedura guidata di installazione di BriefCam NGINX, fare clic con il pulsante destro del mouse sul BriefCamNGINX_<Version number>.exe file e selezionare Esegui come amministratore.

    Se si utilizza l'ultimo aggiornamento di Windows e viene visualizzato un avviso di Windows Defender, fare clic sul collegamento Ulteriori informazioni e fare clic su Esegui ugualmente.

    Windows protected your PC4.png
  2. Nella schermata di benvenuto, fare clic su Introduzione.

    NGINX_welcome.png
  3. Accettare i termini del contratto di licenza BriefCam e fare clic su Avanti.

    NGINX_license_2.png
  4. Leggere il contratto di licenza e fare clic su Avanti.

    NGINX_license_1.png
  5. Inserisci l'indirizzo IP o il nome host (se c'è una risoluzione DNS) per ciascuno dei servizi pertinenti qui sotto e fai clic su Avanti. Una volta inserito l'host Research, è possibile fare clic sul pulsante "Fare clic per utilizzare l'host RESEARCH per tutti i servizi" per compilare tutti i campi con questo valore.

    NGINX_services_configuration.png
  6. Decidere se eseguire con una comunicazione sicura.

    NGINX_using_HTTPS.png
  7. Se selezioni la casella di controllo, inserisci i percorsi del certificato e della chiave privata.

    Nota

    È necessario creare o utilizzare un certificato autofirmato esistente separato in due file: .crt e .key.

  8. Se il certificato SSL è protetto da una password, è necessario configurare NGINX per leggere un elenco di password memorizzate in un file separato. Se la chiave privata non è presente in questo file, NGINX non si avvierà. Eseguire l'operazione come segue:

    1. Creare un nuovo file di testo denominato ssl_passwords.txt e salvarlo in una cartella separata rispetto a quella in cui si trova il certificato SSL.

    2. Impostare il file in modo che sia leggibile solo per l'utente che esegue NGINX.

    3. Immettere la password del certificato nella prima riga del ssl_passwords.txt file.

    4. Nel nginx config file, aggiungere la seguente riga sopra le righe del certificato esistenti:

      ssl_password_file /var/lib/nginx/ssl_passwords.txt;

    5. Distribuire questo file separatamente dal file di configurazione.

  9. Fare clic su Avanti.

    Viene visualizzata la schermata seguente.

    NGINX_Database_fields.png
  10. Nei campi Host database e Porta database, inserire il nome e la porta del computer in cui è stato installato PostgreSQL.

  11. Nei campi Utente applicazione e Password applicazione, inserire il nome utente e la password inseriti durante l'installazione di PostgreSQL.

  12. Fare clic sul pulsante Test connessione al database.

  13. Fare clic su Avanti.

  14. Confermare o selezionare l'unità dove si desidera installare NGINX e fare clic su Installa.

    NGINX_install_path.png
  15. nginx.conf Se si dispone di più di un nome host del servizio Web, dopo aver installato NGINX, aprire il file (che si trova per impostazione predefinita in: C:/nginx/conf) e nella http sezione, copiare e incollare le righe esistenti e aggiornare le nuove righe con i nomi host aggiuntivi.

  16. Su qualsiasi host che esegue l'applicazione (browser), assicurarsi che i domini (o il nome host) possano essere risolti dal DNS. Se non è disponibile alcun DNS, è possibile modificare il file host e aggiungere l'indirizzo IP del load balancer utilizzando la seguente sintassi:

    10.x.x.x www.example.com example.com

    Ad esempio: 10.0.0.143 www.example.com

  17. Aprire i seguenti tre file .js di configurazione web sul BriefCam server (per impostazione predefinita questi tre file sono in C:\Program Files\BriefCam\WebServices):

    • \app\webConfig.js

    • \ProWebAdminClient\web.config.js

    • \ProWebClient\webConfig.js

      NGINX Webconfig files.png
  18. In ciascuno dei tre file .js di web config, impostare gli endpoint (endPointApi) in modo che puntino al bilanciamento del carico. Nell'esempio sottostante, si dovrebbe solo passare PRODUCT1 all'indirizzo del bilanciamento del carico. Assicurarsi che "http:" non compaia nel percorso.

    Web config endpoint.png
  19. Aprire QLIK QMC con l'utente che è stato utilizzato per installare il modulo RESEARCH (https://<hostname>/qmc).

  20. Accedere ai proxy virtuali e aggiungere due nuovi parametri utilizzando il nome host di ognuna delle macchine (ad esempio, il computer QLIK e i nomi host della macchina NGINX come mostrato nell'immagine sottostante) a entrambi i proxy:

    • Proxy virtuali->bc->avanzate->Lista bianca host

    • Proxy virtuali->Proxy centrale (predefinito)->avanzate->Lista bianca host

      Host white list.png

      Nota

      Su alcuni sistemi, potrebbe essere necessario aggiungere il nome host, il nome FQDN e l'indirizzo IP del bilanciamento del carico e di tutte le istanze dei servizi web nella lista bianca dei proxy virtuali in QMC.

  21. Nella schermata Connettori directory utente, andare alla stringa di connessione Visibile e aggiungere il nome di dominio al server valore. Ad esempio, nell'immagine sottostante, Stress-DB era il valore originale e ora è Stress-DB.briefcamdev.com.

    Qlik User directory connectors.png
  22. Apri il BriefCam Administrator Console.

  23. Se si è scelto di utilizzare una connessione protetta (https), impostare l'ambiente DefaultSiteProtocol su https.

  24. Verificare che le seguenti impostazioni di ambiente siano impostate sull'indirizzo IP o FQDN NGINX e assicurarsi che gli URL inizino con http:// o https:// (se si è selezionato di utilizzare una connessione protetta:

    • BaseVideoUrl

    • clientNotificationEndPoint

    • CommonPlatformAPI.ServiceURL

    • DB.LocalStorageAddress

    • LoadBalancerAddress – Questa impostazione deve essere impostata sul nome host NGINX (FQDN)

    • IndirizzoProWebApi

    • ProWebClientAddress

    • QlikServer

    • Sito.Url

    • StorageGatewayUrl

    • SSOEndpoint – Se si desidera utilizzare un client incorporato, questo valore deve essere impostato su: http[s]://<NGINX-host>:8030/MilestoneSSO/

  25. Se si sta installando un motore OX basato su Linux, assicurarsi che il valore per l'impostazione dell'ambiente OX6.EngineOutputGatewayGrpcPort corrisponda a quanto immesso nella casella Elaborazione del programma di installazione (impostazione predefinita 49149).

  26. Se si sta installando un motore OX basato su Linux, assicurarsi che il valore per l'impostazione dell'ambiente OX6.VmsAdapterGrpcPort corrisponda a quanto immesso nella casella Agente VMS del programma di installazione (predefinito 49151).

    NGINX_ports_check.png
  27. Riavviare i BriefCam servizi.

  28. Se si è scelto di utilizzare una connessione protetta (https), accedere all'applicazione e verificare che funzioni con le richieste https. Ad esempio:

    • https://www.example.com/app

    • https://www.example.com/admin

Servizio Windows NGINX

Il programma di installazione di BriefCam NGINX crea un servizio BriefCam NGINX Web Server nella schermata Servizi Windows. Questo servizio ha la responsabilità di assicurarsi che il processo NGINX sia costantemente in esecuzione e che il bilanciamento del carico sia pronto ad accettare le richieste. L'utente che esegue questo servizio è l'utente BriefCam Windows.

NGINX Web Server.png

Configurazioni generiche

Per qualsiasi altro tipo di bilanciamento del carico, come Amazon ELB, Google Cloud Platform Load Balancer e così via, è necessario configurare regole di reindirizzamento basate sull'URL. Di seguito sono riportate le regole di reindirizzamento:

1. Servizio di notifica

Cerca: /signalr

Reindirizza a: notification-server:7080

2. Video Streaming Gateway

Cerca: /vsg

Utilizzare la regola di riscrittura per rimuovere /vsg dall'URL

Reindirizza a: videostreaming-server:5010

3. Ricerca (Qlik)

Cerca: /bc/

Reindirizza a: www.example.com:8090

4. Servizi Web

Cerca: /

Reindirizza a: briefcam-webserver

5. Gateway di archiviazione (se utilizzato)

Cerca: /StorageGateway

Reindirizza a: storage gateway server:5012

6. Gateway BI Hub (per multisite)

Cerca: /hubbigateway

Reindirizzamento al server in cui è in esecuzione l’Hub BI Gateway, porta 5007

7. Outbound API Gateway (per multisite)

Cerca: /outboundapigateway

Reindirizzamento al server su cui è in esecuzione Outbound API Gateway, porta: 5005

8. Common Platform API

Cerca: /commonplatformapi/

Reindirizzamento al server in cui è in esecuzione il servizio Common Platform API, porta 5014

9. Gestione dei compiti

Cerca: /taskmanagement

Reindirizzamento al server in cui è in esecuzione il servizio Gestione attività, porta 5013