Skip to main content

Guía de instalación de BriefCam

Instalación y configuración de NGINX

Last Updated: 6 minute read
Versión2024r2
IdiomaEspañol

Esta sección describe los pasos a seguir para usar NGINX.

Nota

Para trabajar con SSL y BriefCam, es necesario utilizar un equilibrador de carga. BriefCam recomienda utilizar NGINX.

Recomendaciones

Se recomienda instalar el equilibrador de carga en una máquina separada.

Si está trabajando en un entorno virtualizado, el equilibrador de carga debe estar en una máquina separada.

Si trabaja en un entorno no virtualizado (servidores físicos), puede tener el equilibrador de carga en el mismo ordenador que los servicios web (aunque no se recomienda). Sin embargo, si instala el equilibrador de carga en el mismo ordenador que los servicios web, IIS tiene que funcionar en un puerto diferente (no 80, ya que 80 es para NGINX).

Importante

Se recomienda no realizar cambios manuales en el archivo de configuración de NGINX. Sin embargo, si realiza cambios, asegúrese de que todas las modificaciones cumplen con la sintaxis válida de NGINX y que todos los nombres de puntos finales se utilizan exactamente como se han definido, incluida la distinción entre mayúsculas y minúsculas.

Requisitos previos

  • Asegúrese de que los puertos 80 y 443 no están en uso por otra aplicación.

  • Si IIS está instalado, asegúrese de detenerlo o cambiar su puerto predeterminado.

Pasos

  1. Para ejecutar el asistente de instalación de BriefCam NGINX, haga clic con el botón derecho en el archivo de BriefCamNGINX_<Version number>.exe y seleccione Ejecutar como administrador.

    Si está utilizando la última actualización de Windows Update y aparece una alerta de Windows Defender, haga clic en el vínculo Más información y haga clic en Ejecutar de todos modos.

    Windows protected your PC4.png

  2. En la pantalla de bienvenida, haga clic en Primeros pasos.

    NGINX_welcome.png

  3. Acepte los términos del acuerdo de licencia de BriefCam y haga clic en Siguiente.

    NGINX_license_2.png

  4. Lea el acuerdo de licencia y haga clic en Siguiente.

    NGINX_license_1.png

  5. Introduzca la dirección IP o el nombre de host (si hay una resolución DNS) para cada uno de los servicios relevantes a continuación, y haga clic en Siguiente. Tenga en cuenta que una vez que entre en el host de Research, puede hacer clic en el botón "Hacer clic para utilizar el host de RESEARCH para todos los servicios" para rellenar todos los campos con este valor.

    NGINX_services_configuration.png

  6. Decida si desea ejecutar una comunicación segura.

    NGINX_using_HTTPS.png

  7. Si marca la casilla de verificación, introduzca las rutas al certificado y a la clave privada.

    Nota

    Debe crear o utilizar un certificado autofirmado existente separado en dos archivos: .crt y .key.

  8. Si su certificado SSL está protegido por una contraseña, debe configurar NGINX para que lea una lista de contraseñas que están almacenadas en un archivo separado. Si la clave privada no está en este archivo, NGINX no se iniciará. Esto se hace de la siguiente manera:

    1. Cree un nuevo archivo de texto llamado ssl_passwords.txt y guárdelo en una carpeta distinta de la que contiene el certificado SSL.

    2. Establezca el archivo para que sea legible solo para el usuario que ejecuta NGINX.

    3. Introduzca la contraseña del certificado en la primera línea del archivo de ssl_passwords.txt .

    4. En el archivo de nginx config , añada la línea siguiente encima de las líneas de certificado existentes:

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

    5. Distribuya este archivo por separado del archivo de configuración.

  9. Haga clic en Siguiente.

    Aparece la siguiente pantalla.

    NGINX_Database_fields.png

  10. En los campos Host de Base de Datos y Puerto de Base de Datos, introduzca el nombre y el puerto de la máquina en la que instaló PostgreSQL.

  11. En los campos Usuario de Aplicación y Contraseña de Aplicación, introduzca el nombre de usuario y la contraseña que introdujo al instalar PostgreSQL.

  12. Haga clic en el botón Probar Conexión a Base de Datos.

  13. Haga clic en Siguiente.

  14. Confirme o seleccione la unidad donde desea instalar NGINX y haga clic en Instalar.

    NGINX_install_path.png

  15. Si tiene más de un nombre de host de servicio web, después de instalar NGINX, abra el archivo de nginx.conf (ubicado por defecto en: C:/nginx/conf) y en la sección, copie y pegue las http filas existentes y actualice las nuevas filas con los nombres de host adicionales.

  16. En cualquier host que ejecute la aplicación (navegador), asegúrese de que los dominios (o el nombre de host) pueden ser resueltos por el DNS. Si no hay DNS disponible, puede editar el archivo de hosts y añadir la dirección IP del equilibrador de carga utilizando la siguiente sintaxis:

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

    Por ejemplo: 10.0.0.143 www.example.com

  17. Abra los siguientes tres archivos web config .js en el servidor de BriefCam (por defecto, estos tres archivos están en C:\Program Files\BriefCam\WebServices):

    • \app\webConfig.js

    • \ProWebAdminClient\web.config.js

    • \ProWebClient\webConfig.js

      NGINX Webconfig files.png

  18. En cada uno de los tres archivos web config .js, establezca los puntos finales (endPointApi) para que apunten al equilibrador de carga. En el ejemplo siguiente, simplemente cambiaría la PRODUCT1 a la dirección del equilibrador de carga. Asegúrese de que "http:" no aparece en la ruta.

    Web config endpoint.png

  19. Abra QLIK QMC con el usuario que se utilizó para instalar el módulo RESEARCH (https://<hostname>/qmc).

  20. Navegue hasta los proxies virtuales y añada dos nuevos parámetros utilizando el nombre de host de cada una de las máquinas (por ejemplo, los nombres de host de la máquina QLIK y la máquina NGINX como se muestra en la imagen de abajo) a ambos proxies:

    • Proxies virtuales->bc->avanzado->Lista blanca de host

    • Proxies virtuales->Proxy central (Predeterminado)->Avanzado->Lista blanca de hosts

      Host white list.png

      Nota

      En algunos sistemas, es posible que se le pida que añada el nombre de host, el FQDN y la dirección IP del equilibrador de carga y todas las instancias de servicios web a la lista blanca de proxies virtuales en QMC.

  21. En la pantalla Conectores de directorio de usuario, vaya a la cadena de conexión Visible y añada el nombre de dominio al valor server . Por ejemplo, en la imagen de abajo, Stress-DB era el valor original y ahora es Stress-DB.briefcamdev.com.

    Qlik User directory connectors.png

  22. Compruebe que los siguientes ajustes de entorno están establecidos en la dirección IP o el nombre de host de NGINX y, si ha seleccionado utilizar una conexión segura (https), asegúrese de que las URL comienzan por https:

    • BaseVideoUrl

    • clientNotificationEndPoint

    • DB.LocalStorageAddress

    • LoadBalancerAddress – Este ajuste debe establecerse en el nombre de host NGINX (FQDN)

    • ProWebApiAddress

    • ProWebClientAddress

    • QlikServer

    • Sitio.Url

    • StorageGatewayUrl

    • Extremo SSO: si quiere utilizar un cliente integrado, este valor debe establecerse en: http[s]://<NGINX-host>:8030/MilestoneSSO/

  23. Si está instalando un motor OX basado en Linux, asegúrese de que el valor del entorno OX6.EngineOutputGatewayGrpcPort coincide con el que introdujo en el cuadro de procesamiento del instalador (valor predeterminado 49149).

  24. Si está instalando un motor OX basado en Linux, asegúrese de que el valor del entorno OX6.VmsAdapterGrpcPort coincide con el que se introdujo en el cuadro del agente VMS del instalador (valor predeterminado 49151).

    NGINX_ports_check.png

  25. Reinicie los servicios BriefCam .

  26. Si ha seleccionado utilizar una conexión segura (https), navegue hasta la aplicación y compruebe que funciona con solicitudes https. Por ejemplo:

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

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

Servicio de Windows NGINX

El instalador BriefCam NGINX crea un BriefCam NGINX Web Server en la pantalla de Servicios de Windows. Este servicio es responsable de garantizar que el proceso NGINX esté en funcionamiento constante y que el equilibrador de carga esté listo para aceptar solicitudes. El usuario que ejecuta este servicio es el usuario BriefCam de Windows.

NGINX Web Server.png

Configuraciones genéricas

Para cualquier otro tipo de equilibrador de carga, como Amazon ELB, Google Cloud Platform Load Balancer, etc., debe configurar reglas de redirección basadas en la URL. Las siguientes son las reglas de redirección:

1. Servicio de notificación

Buscar: /signalr

Redirigir a: notification-server:7080

2. Video Streaming Gateway

Buscar: /vsg

Utilice la regla de reescritura para eliminar /vsg de la URL

Redirigir a: videostreaming-server:5010

3. Research (Qlik)

Buscar: /bc/

Redirigir a: www.example.com:8090

4. Servicios web

Buscar: /

Redirigir a: briefcam-webserver