Skip to main content

BriefCam Kurulum Kılavuzu

NGINX'i Kurma ve Yapılandırma

Son güncelleme: 5 dakikalık okuma
Sürüm2025r1
DilTürkçe

Bu bölüm NGINX kullanmak için atılması gereken adımları açıklar.

Not

SSL ve BriefCam, ile çalışmak için bir yük dengeleyici kullanılması gerekir. NGINX kullanmanızı BriefCamönerir.

Öneriler

Yük dengeleyicinin ayrı bir makineye kurulması önerilir.

Sanallaştırılmış bir ortamda çalışıyorsanız yük dengeleyici ayrı bir makinede olmalıdır.

Sanallaştırılmamış (fiziksel sunucular) bir ortamda çalışıyorsanız, yük dengeleyiciyi Web Hizmetleri (önerilmese de) ile aynı makinede kullanabilirsiniz. Ancak, yük dengeleyiciyi Web Hizmetleri ile aynı makineye kurarsanız, IIS'nin farklı bir bağlantı noktasında çalışması gerekir (80 değil, çünkü 80 NGINX içindir).

Önemli

NGINX yapılandırma dosyasında manuel değişiklikler yapmamanız önerilir. Ancak, değişiklik yaparsanız, tüm değişikliklerin geçerli NGINX sözdizimine uygun olduğundan ve tüm uç nokta adlarının büyük/küçük harf duyarlılığı dahil tam olarak tanımlandığı şekilde kullanıldığından emin olun.

Ön koşullar

  • 80 ve 443 portlarının başka bir uygulama tarafından kullanılmadığından emin olun.

  • IIS kuruluysa, durdurduğunuzdan veya varsayılan bağlantı noktasını değiştirdiğinizden emin olun.

Adımlar

  1. BriefCam NGINX Kurulum sihirbazını çalıştırmak için, BriefCamNGINX_<Version number>.exedosyaya sağ tıklayın ve Yönetici olarak çalıştır öğesini seçin.

    En son Windows Update'i kullanıyorsanız ve bir Windows Defender uyarısı görünürse, Daha fazla bilgi bağlantısına tıklayın ve yine de Çalıştır'a tıklayın.

    Windows protected your PC4.png

  2. Hoş Geldiniz ekranında, Başlangıç ' a tıklayın.

    NGINX_welcome.png

  3. BriefCam lisans anlaşmasının koşullarını kabul edin ve İleri ' yi tıklatın.

    NGINX_license_2.png

  4. Lisans anlaşmasını okuyun ve İleri düğmesini tıklatın.

    NGINX_license_1.png

  5. Aşağıdaki ilgili hizmetlerin her biri için IP adresini veya ana bilgisayar adını (DNS çözünürlüğü varsa) girin ve İleri ' yi tıklatın. Research host'a girdikten sonra, bu değere sahip tüm alanları doldurmak için "Click to use the RESEARCH host for all service" butonuna tıklayabilirsiniz.

    NGINX_services_configuration.png

  6. Güvenli bir iletişimle çalışıp çalışmayacağınıza karar verin.

    NGINX_using_HTTPS.png

  7. Onay kutusunu işaretlerseniz, sertifikanın ve özel anahtarın yollarını girin.

    Not

    Kendinden imzalı bir sertifikayı iki dosyaya ayrılmış olarak oluşturmanız veya kullanmanız gerekir: .crt ve .key.

  8. SSL sertifikanız bir parola ile korunuyorsa, ayrı bir dosyada depolanan parolaların bir listesini okumak için NGINX'i yapılandırmanız gerekir. Özel anahtar bu dosyada yoksa, NGINX başlamayacaktır. Bunu aşağıdaki gibi yaparsınız:

    1. ssl_passwords.txtAdında yeni bir metin dosyası oluşturun ve SSL sertifikasının bulunduğu yerden ayrı bir klasöre kaydedin.

    2. Dosyayı sadece NGINX çalıştıran kullanıcı tarafından okunabilir olacak şekilde ayarlayın.

    3. Sertifika parolasını ssl_passwords.txtdosyanın ilk satırına girin.

    4. nginx configDosyaya mevcut sertifika satırlarının üzerine aşağıdaki satırı ekleyin:

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

    5. Bu dosyayı yapılandırma dosyasından ayrı olarak dağıtın.

  9. İleri üzerine tıklayın.

    Aşağıdaki ekran görünür.

    NGINX_Database_fields.png

  10. Veritabanı Ana Bilgisayarı ve Veritabanı Bağlantı Noktası alanlarına, PostgreSQL'i kurduğunuz makinenin adını ve bağlantı noktasını girin.

  11. Uygulama Kullanıcısı ve Uygulama Şifresi alanlarına PostgreSQL'i kurarken girmiş olduğunuz kullanıcı adı ve şifreyi girin.

  12. Veritabanı Bağlantısını Test Et düğmesini tıklatın.

  13. İleri üzerine tıklayın.

  14. NGINX'i kurmak istediğiniz sürücüyü onaylayın veya seçin ve Kur ' a tıklayın.

    NGINX_install_path.png

  15. Birden fazla web hizmeti ana bilgisayar adınız varsa, NGINX'i kurduktan sonra, nginx.confdosyayı açın (varsayılan olarak şu adreste bulunur: C:/nginx/conf) ve httpbölümün içinde , mevcut satırları kopyalayıp yapıştırın ve yeni satırları ek ana bilgisayar adlarıyla güncelleyin.

  16. Uygulamayı (tarayıcı) çalıştıran herhangi bir ana bilgisayarda, etki alanlarının (veya ana bilgisayar adının) DNS tarafından çözülebildiğinden emin olun. Hiçbir DNS mevcut değilse, ana bilgisayar dosyasını düzenleyebilir ve aşağıdaki sözdizimini kullanarak yük dengeleyicinin IP adresini ekleyebilirsiniz:

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

    Örneğin: 10.0.0.143 www.example.com

  17. BriefCamSunucuda aşağıdaki üç web yapılandırma .js dosyasını açın ( varsayılan olarak bu üç dosya şuradadır C:\Program Files\BriefCam\WebServices):

    • \app\webConfig.js

    • \ProWebAdminClient\web.config.js

    • \ProWebClient\webConfig.js

      NGINX Webconfig files.png

  18. Üç web yapılandırması .js dosyasının her birinde, yük dengeleyiciyi göstermek için uç noktaları ( endPointApi) ayarlayın. Aşağıdaki örnekte, sadece yük dengeleyicinin adresini değiştireceksiniz PRODUCT1. "http:" ifadesinin yolda görünmediğinden emin olun.

    Web config endpoint.png

  19. RESEARCH modülünü ( https://<hostname>/qmc) kurmak için kullanılan kullanıcıyla QLIK QMC'yi açın.

  20. Her iki proxy'ye de sanal proxy'lere göz atın ve her bir makinenin ana bilgisayar adını kullanarak iki yeni parametre ekleyin (örneğin, aşağıdaki resimde gösterildiği gibi QLIK makinesi ve NGINX makine ana bilgisayar adları):

    • Sanal Vekiller -> bc -> gelişmiş ->Ana bilgisayar beyaz listesi

    • Sanal Vekiller -> Merkezi Vekil Sunucu (Varsayılan) -> Gelişmiş ->Ana bilgisayar beyaz listesi

      Host white list.png

      Not

      Bazı sistemlerde, yük dengeleyicinin ana bilgisayar adını, FQDN ve IP adresini ve tüm web hizmetleri örneklerini QMC'deki sanal proxy beyaz listesine eklemeniz gerekebilir.

  21. Kullanıcı dizini konektörleri ekranında, Görünür bağlantı dizesine gidin ve serverdeğere etki alanı adını ekleyin. Örneğin, aşağıdaki resimde, Stress-DBorijinal değerdi ve şimdi .Stress-DB.briefcamdev.com

    Qlik User directory connectors.png

  22. ' i açın.BriefCam Administrator Console

  23. Güvenli bağlantı (https) kullanmayı seçtiyseniz, DefaultSiteProtocol ortam ayarını .https

  24. Aşağıdaki ortam ayarlarının NGINX IP adresine veya FQDN'ye ayarlı olduğunu kontrol edin ve URL'lerin http://veya https://(güvenli bir bağlantı kullanmayı seçtiyseniz) ile başladığından emin olun:

    • TemelVideoUrl

    • clientNotificationEndPoint

    • CommonPlatformAPI.ServiceURL

    • DB.LocalStorageAddress

    • LoadBalancerAddress - Bu ayar NGINX ana bilgisayar adına (FQDN) ayarlanmalıdır

    • ProWebApiAdres

    • ProWebClientAddress

    • QlikServer

    • Site.Url

    • StorageGatewayUrl

    • SSOEndpoint - Katıştırılmış bir istemci kullanmak istiyorsanız, bu değer şu şekilde ayarlanmalıdır: http[s]://<NGINX-host>:8030/MilestoneSSO/

  25. Linux tabanlı bir OX motoru kuruyorsanız, OX6.EngineOutputGatewayGrpcPort ortam ayarının değerinin, yükleyicinin İşleme kutusuna girdiklerinizle (varsayılan 49149) eşleştiğinden emin olun.

  26. Linux tabanlı bir OX motoru kuruyorsanız, OX6.VmsAdapterGraphport ortam ayarı değerinin yükleyicinin VYY Aracısı kutusuna girilenle (varsayılan 49151) eşleştiğinden emin olun.

    NGINX_ports_check.png

  27. BriefCamHizmetleri yeniden başlatın.

  28. Güvenli bağlantı (https) kullanmayı seçtiyseniz uygulamaya gidin ve https istekleriyle çalışıp çalışmadığını kontrol edin. Örneğin:

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

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

NGINX Windows Hizmeti

BriefCamNGINX yükleyicisi, Windows Hizmetleri ekranında bir BriefCamNGINX Web Server hizmeti oluşturur. Bu hizmet, NGINX işleminin sürekli çalıştığından ve yük dengeleyicinin istekleri kabul etmeye hazır olduğundan emin olmakla sorumludur. Bu hizmeti çalıştıran kullanıcı, BriefCamWindows kullanıcısıdır.

NGINX Web Server.png

Genel Yapılandırmalar

Amazon ELB, Google Cloud Platform Load Balancer ve benzeri gibi diğer herhangi bir yük dengeleyici türü için, URL'ye dayalı yeniden yönlendirme kurallarını yapılandırmanız gerekir. Aşağıda yeniden yönlendirme kuralları verilmiştir:

1. Bildirim Hizmeti

Ara: /signalr

Yeniden yönlendir: notification-server:7080

2. Video Streaming Gateway

Ara: /vsg

URL'den kaldırmak /vsgiçin yeniden yazma kuralını kullanın

Yeniden yönlendir: videostreaming-server:5010

3. Araştırma (Qlik)

Ara: /bc/

Yeniden yönlendir: www.example.com:8090

4. Web Hizmetleri

Ara: /

Yeniden yönlendir: briefcam-webserver

5. Storage Gateway (kullanılıyorsa)

Ara: /StorageGateway

Yeniden yönlendir: storage gateway server:5012

6. Hub BI Ağ Geçidi (çoklu tesis için)

Ara: /hubbigateway

Hub BI Ağ Geçidinin çalıştığı bağlantı noktası 5007 sunucusuna yeniden yönlendirin

7. Outbound API Gateway (çoklu tesis için)

Ara: /outboundapigateway

Outbound API Gateway çalıştığı sunucuya yeniden yönlendirin, bağlantı noktası: 5005

8. Common Platform API

Ara: /commonplatformapi/

Common Platform API hizmetinin çalıştığı sunucuya yeniden yönlendirin, bağlantı noktası 5014

9. Görev Yönetimi

Ara: /taskmanagement

Görev Yönetimi hizmetinin çalıştığı bağlantı noktası 5013 sunucusuna yeniden yönlendirin