Informacje dla działów IT

Chociaż instalacja i korzystanie z Altium On-Prem Enterprise Server oraz powiązanych z nim usług są szczegółowo opisane na innych stronach tej witryny dokumentacji, celem tej strony jest dostarczenie jednego, szczegółowego źródła informacji dla działu IT w organizacji. Miejsca, do którego można sięgnąć po odpowiedzi na najczęściej zadawane pytania dotyczące tej technologii, w tym:

• What are the hardware requirements to install the Enterprise Server?

• What is installed?

• What programs and processes are running?

• Where is the data stored?

• What ports are used?

• What protocol is used for communications?

• How is data backed up?

Poniższe sekcje zawierają szczegółowe odpowiedzi na te i inne pytania, w tym ogólny przegląd architektury i przepływów danych.

Konfiguracja IIS

W ramach konfiguracji IIS włączana jest funkcja ISAPI Extensions. Funkcję tę można znaleźć w sekcji \Internet Information Services\World Wide Web Services\Application Development Features w oknie dialogowym Windows Features – dostępnym z okna Programs and Features systemu Windows.

Instalacja Enterprise Server włącza funkcję Windows ISAPI Extensions, będącą częścią konfiguracji IIS.

Obsługa protokołu HTTPS

Enterprise Server zapewnia bezpieczną komunikację w sieciach z użyciem protokołu HTTPS, aby chronić prywatność i integralność danych.

Konfigurowanie certyfikatu

Dla nowej instalacji Enterprise Server oferuje certyfikat z podpisem własnym, generowany i konfigurowany w IIS. Ze względów bezpieczeństwa zaleca się wygenerowanie własnego certyfikatu (przy użyciu standardowych/preferowanych narzędzi), a następnie skonfigurowanie go w IIS. Możesz utworzyć żądanie certyfikatu i wysłać je do znanego urzędu certyfikacji (CA), takiego jak VeriSign lub GeoTrust, albo uzyskać certyfikat z internetowego CA w domenie intranetowej. Więcej informacji znajdziesz na stronie How to Set Up SSL on IIS 7 or later w dokumentacji Microsoft.

Konfigurowanie HTTPS

Konfigurację i powiązania (bindings) serwera dla Enterprise Server można otworzyć z poziomu panelu Internet Information Services (IIS) Manager systemu Windows – dostępnego z okna Administration Tools (Control Panel\System and Security\Administrative Tools). Wybierz wpis „Altium On-Prem Enterprise Server” na liście Connections panelu, a następnie przejdź do karty Features View.

Uzyskaj dostęp do ustawień konfiguracji i powiązań serwera dla Enterprise Server.

Dostępne porty i nazwy serwera dla Enterprise Server są pokazane jako wybieralne łącza w panelu Actions. Użyj tych łączy, aby sprawdzić i przetestować protokoły połączenia z serwerem, lub uzyskać dostęp do bieżących powiązań nazwa/port, wybierając łącze Bindings w sekcji Edit Site panelu.

Powiązanie (Binding), w tym numer portu protokołu, można edytować w oknie dialogowym Site Bindings za pomocą przycisku Edit .

Skonfiguruj powiązania w oknie dialogowym Site Bindings.

Zwróć uwagę, że nazwa serwera localhost dotyczy tylko komputera lokalnego, więc komputery other niż ten, który hostuje Enterprise Server, muszą używać rzeczywistej nazwy (serwera) tej maszyny hostującej, aby się połączyć.

Aby potwierdzić nazwę komputera hosta, na którym Enterprise Server jest zainstalowany i uruchomiony, na tej maszynie przejdź do Control Panel\System and Security\System i zanotuj zarówno Computer name, jak i Full computer name (jego w pełni kwalifikowaną nazwę domenową) – ta druga będzie używana przez Enterprise Server do bezpiecznych połączeń w sieci.

Jeśli edytowałeś powiązania witryny Enterprise Server tak, aby używały numeru portu innego niż wartość domyślna, tę zmianę należy odzwierciedlić również w pliku LocalVault.ini Enterprise Server. Wynika to z faktu, że odwołania do portów są wykorzystywane podczas nawiązywania połączeń z Enterprise Server przez Altium Designer. Plik LocalVault.ini znajduje się w katalogu głównym instalacji Enterprise Server – zazwyczaj Program Files (x86)\Altium\Altium365.

Na przykład, jeśli zmieniłeś powiązanie witryny Enterprise Server tak, aby używało standardowego portu 443 dla połączeń HTTPS, zaktualizuj odpowiednią linię HttpsPort=9785 w pliku LocalVault.ini na HttpsPort=443.

Podczas ponownej konfiguracji powiązań witryny

Jeśli dodałeś nowe powiązanie witryny IIS dla Enterprise Server lub edytowałeś istniejący wpis powiązania (patrz wyżej), komputer serwera powinien zostać uruchomiony ponownie, aby poprawnie ustanowić nową konfigurację. Typowe zmiany powiązań witryny to edycja numeru portu dla wpisu hosta lub dodanie nowego powiązania dla aliasu domeny.

Gdy ponowne uruchomienie maszyny hostującej serwer nie jest praktyczne, alternatywą jest ponowne uruchomienie usługi serwera na platformie IIS – Restart w obszarze Manage Website – oraz ponowne uruchomienie usługi Altium DXP App Server Pinger (usługi systemu Windows).

Dostęp przez HTTPS

Aby ustanowić bezpieczne połączenie z Enterprise Server:

• Z poziomu Altium Designer – użyj adresu serwera z prefiksem HTTPS oraz skonfigurowanego portu HTTPS. Domyślnie jest to https://<computername>:9785 (gdzie [computername] to nazwa komputera hosta lub w pełni kwalifikowana nazwa domenowa).

  Altium Designer zawiera wymagane mechanizmy bezpieczeństwa, aby zaakceptować połączenie HTTPS z Enterprise Server bez dodatkowej interwencji.

• Z poziomu przeglądarki – wprowadź adres usługi nazwy komputera hosta (https://<computername>:9785).

  Jeśli zdecydowałeś się zachować certyfikat tożsamości z podpisem własnym wygenerowany dla Enterprise Server, przeglądarka ostrzeże, że połączenie nie jest bezpieczne/prywatne. Możesz zaakceptować ostrzeżenie w przeglądarce, aby kontynuować. Niektóre przeglądarki (na przykład Firefox) oferują opcję trwałego zaakceptowania certyfikatu, dzięki czemu dalsze działania nie są wymagane.

Sieć

Porty domyślne

Następujące domyślne numery portów komunikacyjnych są używane przez Enterprise Server:

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

  Port usługi LDAP w rzeczywistości nie jest używany. Dla standardowego LDAP (z adresem URL ldap://) używany jest port z tego adresu URL. Dla bezpiecznego LDAP (z adresem URL ldaps://) używany jest port 636.

• Websocket Port – 4649

  Zwróć uwagę, że /websocket/WebService.asmx jest punktem końcowym HTTP SOAP dla wywołań API, więc – podobnie jak inne punkty końcowe API – używa portu HTTPS (domyślnie 9785).

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 i 9300

Pierwsze trzy pozycje na liście można skonfigurować podczas instalacji początkowej, na stronie Altium On-Prem Enterprise Server Configuration instalatora.

Wybierając port, pamiętaj, że nie może on kolidować z żadnymi portami używanymi przez inne aplikacje – jeśli port jest aktualnie zajęty, instalator Cię o tym powiadomi.

Zobacz informacje o portach i adresach IP dla oprogramowania Altium Design.

Protokół używany do komunikacji między usługami

SOAP przez HTTP.

Połączenie z podsystemem tożsamości AltiumLive

Połączenia z podsystemem tożsamości AltiumLive są domyślnie realizowane przez HTTPS, a wpis IdentityCloudServiceUrl w pliku LocalVault.ini (znajdującym się w folderze C:\Program Files (x86)\Altium\Altium365 dla instalacji domyślnej) ma domyślnie wartość https://ids.api.altium.com/ids?cls=soap.

Domyślne ścieżki instalacji

Poniżej znajduje się lista domyślnych ścieżek instalacji podczas instalowania Enterprise Server:

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.

• Firebird Installation Folder – \Program Files\Firebird\Firebird_3_0.

• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.

• Revision Files Folder – \ProgramData\Altium\Altium365Data\Revisions.

• Search Index Data Folder – \ProgramData\Altium\Altium365Data\SearchData.

Architektura usług – przegląd

Enterprise Server instaluje szereg usług podstawowych, a także oparte na przeglądarce konsole zarządzania oraz Explorer (również oparty na przeglądarce). Aby uzyskać dostęp do którejkolwiek z tych usług, tożsamość użytkownika musi zostać rozpoznana i uwierzytelniona. Enterprise Server jest dostarczany z jednym predefiniowanym użytkownikiem (Username: admin, Password: admin). Strona Users w przeglądarkowym interfejsie Enterprise Server Workspace może służyć do dodawania i zarządzania kolejnymi użytkownikami. Nie ma limitu liczby użytkowników, którzy mogą zostać zarejestrowani w celu uzyskania dostępu do Enterprise Server i korzystania z niego, ale istnieje limit jednoczesnych połączeń, określany i egzekwowany przez wymagane licencjonowanie.

Altium Designer używa nieszyfrowanego kanału (SOAP over HTTP) do komunikacji z następującymi usługami:

• Applications Registry Service (gdy usługa Network Installation Service jest używana jako źródło rozszerzeń/aktualizacji)

• Collaboration Service

• Comments Service

• Data Acquisition Service

• Data Storage Service (DSS)

• Identity Service (IDS)

• Notifications Service

• Part Catalog Service

• Projects Service

• Simple Lock Service (SLS)

• SVN (przez protokół SVN://)

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

Wszystkie pozostałe usługi komunikują się ze sobą.

Większość usług wymaga dostępu do tej samej bazy danych Enterprise Server, w której przechowywane są dane właściwe dla tych usług. Poniżej przykłady danych przechowywanych przez niektóre z tych usług:

• Part Catalog Service – przechowuje pozycje dostawców i producentów, historię zmian cen i ilości itp...

• Identity Service – przechowuje użytkowników, grupy, konfigurację licencjonowania oraz informacje o sesjach.

• Vault Service – przechowuje swoją strukturę (foldery, elementy, rewizje, typy zawartości, stany cyklu życia itp...).

Rzeczywiste dokumenty są przechowywane w systemie plików, w folderze Revisions (\ProgramData\Altium\Altium365Data\Revisions).

Następujące aplikacje oparte na przeglądarce używają SOAP API do komunikacji z odpowiednimi usługami – nie wymagają dostępu do bazy danych Enterprise Server ani żadnych innych plików do działania:

• User Management – aplikacja stojąca za stroną Users oraz podstronami w przeglądarkowym interfejsie Enterprise Server Workspace.

• Vault Explorer – aplikacja stojąca za stroną Explorer w przeglądarkowym interfejsie Enterprise Server Workspace.

• Catalog Management – aplikacja stojąca za stroną Part Providers w przeglądarkowym interfejsie Enterprise Server Workspace.

• Projects Management – aplikacja stojąca za stroną Projects w przeglądarkowym interfejsie Enterprise Server Workspace.

• TC2 Console – aplikacja stojąca za stroną Configurations w przeglądarkowym interfejsie Enterprise Server Workspace.

Operacje

Kopia zapasowa/przywracanie danych serwera

Tworzenie kopii zapasowej i przywracanie danych Enterprise Server odbywa się z wiersza poleceń, w sposób zautomatyzowany, przy użyciu dedykowanego narzędzia Backup & Restore Tool. To narzędzie – avbackup.exe – można znaleźć w folderze \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (dla domyślnej instalacji Enterprise Server).

Więcej informacji znajdziesz na stronie Backing up & Restoring Your Installation.

Ponowne indeksowanie zawartości serwera po migracji danych

Aby ponownie zindeksować zawartość Enterprise Server, na przykład po migracji danych:

1. Zatrzymaj wszystkie pule aplikacji IIS powiązane z Enterprise Server.

2. Zatrzymaj usługę Elasticsearch (AltiumElasticSearch). Wykonuje się to z panelu Windows Services – dostępnego z okna Administrative Tools systemu Windows.

3. Usuń zawartość folderu SearchData, który zawiera dane indeksowania wyszukiwania (\ProgramData\Altium\Altium365Data\SearchData dla instalacji domyślnej).

4. Uruchom ponownie usługę Elasticsearch (AltiumElasticSearch).

5. Uruchom ponownie pule aplikacji IIS powiązane z Enterprise Server.

Po wykryciu, że folder SearchData jest pusty, Enterprise Server ponownie zindeksuje swoją zawartość po uruchomieniu.

Zwiększanie rozmiaru sterty Java

Niewystarczający rozmiar sterty Java może uszkodzić indeks wyszukiwania komponentów i spowodować, że dane komponentów będą niedostępne z poziomu Altium Designer. Jeśli masz problemy z indeksem wyszukiwania (w Health Monitor Status Report w logach występują błędy SearchService Schema not found: 'vault1ex2_04), rozważ zwiększenie rozmiaru sterty Java.

Aktualny rozmiar sterty Java można sprawdzić, otwierając http://localhost:9200/_cat/nodes?h=heap*&v na maszynie hostującej Enterprise Server. Jeśli wartość heap.max wynosi około 1 GB, zwiększ ją zgodnie z opisem poniżej.

1. Uruchom Wiersz polecenia w trybie administratora.

2. Uruchom następujące polecenie:

   "C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch

3. Na karcie Java w otwartym oknie dialogowym wprowadź następujące zmiany:

   • W polu Java Options usuń wpisy -Xms1g i -Xmx1g.

   • Zaktualizuj wartości w polach Initial memory pool i Maximum memory pool na 4096.

     Przy zwiększaniu rozmiaru sterty Java do wartości innej niż 4 GB odpowiednio zmień opcje Initial memory pool i Maximum memory pool (np. podaj 6144, jeśli zwiększasz rozmiar do 6 GB).

   

4. Kliknij Apply i OK w oknie dialogowym.

5. Z panelu Windows Services (dostępnego z okna Administrative Tools systemu Windows) uruchom ponownie usługę AltiumElasticsearch .

6. Zweryfikuj, że zmiany zostały zastosowane, otwierając http://localhost:9200/_cat/nodes?h=heap*&v i sprawdzając wartość parametru heap.max.