FAQ dotyczące Altium On-Prem Enterprise Server

Ogólne

Czy mogę używać Altium On-Prem Enterprise Server do moich komponentów, ale projekty projektowe trzymać lokalnie?

Możesz używać Altium On-Prem Enterprise Server wyłącznie do zarządzania komponentami, ale nie jest to zalecane. Jedną z największych zalet Enterprise Server jest zarządzanie codzienną pracą nad PCB w toku (work-in-progress), co obejmuje także dane projektowe. Przy prawidłowym użyciu Enterprise Server tworzy powiązania relacyjne między całą zawartością bibliotek i projektów, ułatwiając takie funkcje jak „Where-Used”. Jest to niezwykle pomocne przy identyfikowaniu zduplikowanych lub błędnych części, które mogły zostać omyłkowo użyte w jednym lub wielu projektach.

Czy wszystko jest przechowywane lokalnie?

Tak, wszystko jest lokalne. Wszystko znajduje się za Twoim firewallem — my niczego z tego nie dotykamy. Jedyną rzeczą, która wychodzi do internetu, są dane łańcucha dostaw i nawet nie musisz z nich korzystać. Jeśli chcesz odpytać Digikey, Farnell lub innych dostawców, to jest to jedyny rodzaj dostępu do internetu, jaki będziesz mieć. Cała reszta jest lokalna.

Czy mogę hostować Enterprise Server na maszynie wirtualnej albo gdzieś w Amazon AWS?

Tak. To od Ciebie i Twojego zespołu IT zależy wybór lokalizacji, w której będzie znajdował się Enterprise Server.

Jeśli nasza sieć VPN jest wolna, jak wpływa to na przepływ pracy?

Sam workflow może nie być zbyt uciążliwy. Podczas pracy z komponentami biblioteki Workspace początkowe przeglądanie i wyszukiwanie może być nieco wolne, ale gdy dane zostaną zbuforowane (cached), będzie łatwiej. A w przypadku projektów — gdy otwierasz projekt Workspace, przechowujesz go i pracujesz na nim lokalnie.

Dlatego codzienne korzystanie z Enterprise Server nie powinno być mocno odczuwalnie dotknięte. Oczywiście szybszy VPN byłby lepszy, ale słyszeliśmy od użytkowników, że ich VPN-y nie są najlepsze, a mimo to działa to dobrze, ponieważ nie ma stałej interakcji z Enterprise Server.

Czy użytkownik niebędący administratorem może zmienić własne dane uwierzytelniające dostępu do Enterprise Server?

Tak. Chociaż zarządzanie użytkownikami przez osobę niebędącą administratorem nie jest możliwe, użytkownik może zmienić profil własnego konta, gdy uwierzytelnianie odbywa się z użyciem wbudowanej usługi uwierzytelniania Enterprise Server — w tym zmienić nazwę użytkownika i hasło. Wykonuje się to w oknie Edit User, do którego przechodzi się, klikając obszar aktywnego użytkownika w prawym górnym rogu interfejsu przeglądarkowego, a następnie wybierając Profile z powiązanego menu.

Czy mogę połączyć się z wieloma Workspace w Enterprise Server?

W danym momencie możesz być „zalogowany” tylko do jednego Workspace Enterprise Server, ponieważ łączysz się z platformą usług, a nie z pojedynczą usługą Enterprise Server. Zwykle organizacja ma jedną instalację Enterprise Server. Jeśli jednak dostępny jest więcej niż jeden Enterprise Server, po prostu wyloguj się z jednego i zaloguj do drugiego — w razie potrzeby.

Z poziomu Altium Designer nadal możesz sign in do Altium NEXUS Server (wycofany), Altium Concord Pro (wycofany), starszego Altium Vault (Vault 2.0 do 3.0) lub connect do starszego Altium Personal Vault:

• Altium NEXUS Server / Altium Concord Pro / Altium Vault - wyloguj się z aktywnego serwera, a następnie użyj okna Sign in aby sign in do serwera docelowego.
• Altium Personal Vault - wyloguj się z aktywnego serwera, a następnie użyj okna Sign in, aby connect do Personal Vault. Pamiętaj, że w przypadku Personal Vault nawiązujesz połączenie, a nie logujesz się — dlatego po pomyślnym połączeniu z takim vaultem interfejs Altium Designer nie będzie pokazywał, że jesteś zalogowany do jakiegokolwiek serwera.

Po zalogowaniu/połączeniu z jednostką docelową zostanie ona wymieniona w obszarze Known Servers, na stronie Data Management - Servers page w oknie Preferences w Altium Designer.

Nadal chciałbym uruchamiać Altium Personal Vault — czy to możliwe?

Oczywiście. Jeśli na tym samym komputerze działa wcześniejszy wariant serwera, upewnij się, że porty komunikacyjne są unikalne. Enterprise Server używa domyślnego portu 9780 (takiego samego jak jego poprzednik Altium Concord Pro/Altium NEXUS Server/Altium Vault ), natomiast Altium Personal Vault używa domyślnego portu 9680.

Aby dodać Personal Vault jako „Known Server” w Altium Designer — na stronie Data Management - Servers page w oknie Preferences — wyloguj się z aktywnego serwera, a następnie użyj okna Sign in, aby połączyć się z Personal Vault. Pamiętaj, że w przypadku Personal Vault nawiązujesz połączenie, a nie logujesz się — dlatego po pomyślnym połączeniu z takim vaultem interfejs Altium Designer nie będzie pokazywał, że jesteś zalogowany do jakiegokolwiek serwera. Następnie możesz ponownie zalogować się do serwera, który był wcześniej aktywny, nadal korzystając z połączenia z Personal Vault.

Nie mogę zalogować się do Enterprise Server — zamiast tego dostaję komunikat o brakujących plikach DLL. Co powinienem zrobić?

Enterprise Server do poprawnego działania i dostępu opiera się na szeregu składników środowiska uruchomieniowego Microsoft; w niektórych sytuacjach mogą one nie być obecne na komputerze docelowym. Jeśli podczas próby zalogowania do Enterprise Server otrzymujesz komunikat o brakującej bibliotece (DLL), oznacza to brakujące składniki Microsoft runtime. Pobierz i zainstaluj odpowiedni pakiet Microsoft Visual C++ Redistributable Package dla Twojego systemu operacyjnego.

Gdy próbuję zalogować się do Enterprise Server, pojawia się błąd „HTTP Error 503. The service is unavailable”. Co powinienem zrobić?

Ten błąd może wystąpić, gdy Enterprise Server jest zainstalowany na komputerze, na którym działa również Microsoft Exchange Server. Instalacja Exchange Server może zmienić konfigurację Internet Information Services (IIS) w sposób powodujący konflikt z Enterprise Server.

Aby to rozwiązać, należy wprowadzić następujące zmiany w pliku applicationHost.config:

<handlers accessPolicy="Read, Script">
...

<add name="kerbauth" image="C:\Program Files\Microsoft\Exchange Server\V15\Bin\kerbauth.dll" preCondition="bitness64" />
<add name="WSMan" image="C:\Windows\system32\wsmsvc.dll" preCondition="bitness64" />
<add name="exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\ClientAccess\Owa\auth\exppw.dll" preCondition="bitness64" />
<add name="cafe_exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\FrontEnd\HttpProxy\bin\exppw.dll"  preCondition="bitness64" />

...
</handlers>

Informacje o pliku ApplicationHost.config znajdziesz w tym artykule.

Informacje o edycji pliku znajdziesz w tym artykule.

Licencjonowanie

Jakie licencje są wymagane?

Licencjonowanie Enterprise Server składa się z dwóch elementów:

• Server License - umożliwia pełny zestaw usług Enterprise Server dla Twojej organizacji. Wymagana jest jedna licencja serwera na organizację.
• Client Access License - zapewnia użytkownikom dostęp do funkcjonalności Enterprise Server. Wymagana jest jedna licencja Client na każdego użytkownika korzystającego z usług Enterprise Server.

Czy muszę odświeżyć licencje, jeśli zaktualizuję istniejącą instalację Enterprise Server do nowszej wersji?

Tak — upewnij się, że odświeżysz licencjonowanie Enterprise Server. Na stronie Admin - Licenses w interfejsie przeglądarkowym Workspace Enterprise Server usuń istniejące licencje (Altium Enterprise Server i Altium Enterprise Server CAL), a następnie dodaj je ponownie jako nowe instancje. Zapewni to posiadanie najnowszych licencji, uwzględniających wszelkie zmiany funkcji związane z licencjonowaniem w tej nowszej wersji Enterprise Server.

Nie mamy wystarczającej liczby połączeń dla naszej instalacji Enterprise Server — co możemy zrobić?

W interfejsie przeglądarkowym Workspace Enterprise Server użytkownik administracyjny może zakończyć sesję użytkownika, aby wymusić zwolnienie połączenia. Wykonuje się to na stronie Sessions page interfejsu.

Alternatywnie — i jako znacznie lepsze rozwiązanie długoterminowe — po prostu dodaj więcej stanowisk (połączeń), kupując dodatkowe licencje Client Access Licenses (Altium Enterprise Server CAL).

Zarządzanie komponentami

Czy komponent biblioteki Workspace to to samo co Unified Component?

Tak i nie. Wszystko zależy od tego, czy dla komponentu biblioteki Workspace zdefiniowano powiązane Part Choices. Gdy komponent zostanie utworzony i wydany (released), a następnie jest określany jako komponent biblioteki Workspace, reprezentuje on po prostu inżynierski lub projektowy widok tego komponentu. W istocie jest to kontener, w którym przechowywane są wszystkie informacje używane do modelowania tego komponentu w obszarze projektowym (Design Area). Obejmuje to łącza do wszystkich wymaganych modeli dziedzinowych (symbol schematowy, komponent PCB 2D/3D, Sim itd.), a także informacje parametryczne. Ma to duże znaczenie dla projektanta używającego go w projekcie płytki, ale nie ma znaczenia poza obszarem projektowania. Aby stać się prawdziwym „Unified Component”, który łączy obszary Design i Supply Chain, komponent musi zostać zmapowany na fizyczne, rzeczywiste części produkowane. Robi się to poprzez określenie Part Choices dla komponentu.

I to właśnie to inteligentne mapowanie komponentu — z tradycyjnego obszaru projektowania elektroniki do szerszej „areny produktu”, widzianej przez resztę organizacji — zamienia zwykły komponent biblioteki Workspace w prawdziwy Unified Component!

Co jeśli mam już duże biblioteki?

Altium Designer, w połączeniu z Enterprise Server Workspace, zapewnia usprawniony i prosty proces szybkiego importu istniejących bibliotek do Workspace – Library Importer. Interfejs GUI tego procesu oferuje intuicyjny przebieg, który bierze początkowo wybrane biblioteki i importuje je do Twojej instancji Enterprise Server. Obsługując wszystkie typy bibliotek związanych ze starszymi metodologiami zarządzania komponentami – SCHLIB, PCBLIB, INTLIB, DBLIB, SVNDBLIB – Library Importer jest idealnym rozwiązaniem do szybkiego zbudowania firmowego zestawu komponentów bibliotecznych Workspace oraz skorzystania z licznych korzyści, jakie takie komponenty zapewniają (wysoka integralność, zarządzanie cyklem życia, scentralizowane przechowywanie i zarządzanie, funkcja where-used, łatwość ponownego użycia projektu).

Library Importer oferuje minimalistyczny tryb interfejsu Simple, w którym wybrane, plikowe biblioteki komponentów są importowane do komponentów bibliotecznych Workspace w jednym kroku, a importer automatycznie dba o klasyfikację typu, docelowy folder źródłowy, dołączanie parametrów i typ wartości oraz przeniesienie wszystkich istotnych danych. Interfejs jest dostępny także w trybie Advanced, który zapewnia pełny podgląd proponowanego importu biblioteki oraz dostęp do powiązanych danych i ustawień. I choć domyślnie import jest procesem wykonywanym jednym kliknięciem, importer oferuje również zaawansowane opcje konfiguracji poprzez panel Properties panel, zapewniając większą kontrolę nad tym, jak dokładnie import jest wykonywany.

Wszystkie informacje obecne w oryginalnej bibliotece źródłowej są importowane do komponentów bibliotecznych Workspace, w tym wszystkie referencjonowane modele dziedzinowe (symbole schematowe, footprinty PCB, Simulation Models), informacje parametryczne, przypisane Part Choices, pliki datasheet itd. W razie potrzeby tworzone są również Component Templates, które następnie można dopracować i wykorzystać przy kolejnych importach bibliotek. Jeśli Twoje oryginalne komponenty mają zdefiniowanych wiele footprintów PCB, Library Importer przeniesie te modele i zachowa bieżący domyślny footprint. A jeśli pracujesz wyłącznie z bibliotekami PCB – a Twoim jedynym obszarem jest projektowanie PCB – wówczas Library Importer obsługuje import tylko tych bibliotek lub można go przełączyć w tryb importu wyłącznie modeli, w którym określone typy modeli są importowane z bibliotek zintegrowanych lub bazodanowych. Biblioteki zawierające wiele typów komponentów (biblioteki monolityczne) są również automatycznie wykrywane i przetwarzane.

Czy mogę ograniczyć, kto może modyfikować komponenty w Enterprise Server Workspace?

Tak, możesz ustawić różne uprawnienia określające, kto co może robić. Możesz utworzyć grupę bibliotekarzy i określić, kto może lub nie może czytać (mieć dostęp do) dowolnego folderu. Możesz nawet utworzyć folder typu sandbox, do którego część inżynierów ma dostęp, jeśli chcą tworzyć własne części, natomiast oficjalne, wydane części mogą trafiać do innego folderu, do którego dostęp ma każdy. Dzięki temu wszystko jest bardzo dobrze kontrolowalne.

Czy istnieje sposób na pobranie migawki komponentów bibliotecznych Workspace na dni, gdy infrastruktura IT może być niedostępna?

Nie, obecnie nie ma możliwości uzyskania lokalnego obrazu Enterprise Server.

Podczas korzystania z panelu Components dane komponentów bibliotecznych Workspace są buforowane z Workspace na komputer lokalny. Zapewnia to tryb dostępu offline do komponentów bibliotecznych Workspace, gdy Altium Designer nie jest połączony z Enterprise Server, a tym samym umożliwia normalne przeglądanie i wstawianie komponentów itd. Zwróć uwagę, że Filters nie są w tym trybie włączone.

Ten stan jest sygnalizowany tekstem ostrzeżenia „Offline mode – cached data is being used” w dolnym pasku panelu listy komponentów.

Czy mogę utworzyć lokalną bibliotekę z Enterprise Server?

Tak, dostępna jest funkcja poprzez Content Cart, która pozwala pobrać komponenty z lokalnego Enterprise Server do biblioteki zintegrowanej (*.IntLib). A podczas umieszczania komponentów z takiej biblioteki zintegrowanej rzeczywiste odnośniki prowadzą z powrotem do Component Items w Enterprise Server. Daje to możliwość efektywnego korzystania z firmowych komponentów bibliotecznych Workspace w trybie offline, przy jednoczesnym zapewnieniu, że projekt nadal utrzymuje prawdziwe połączenie z tymi komponentami w źródłowym Enterprise Server.

Zarządzanie projektem

Czy funkcja Where-Used opiera się na tym, że projekty zostały zaewidencjonowane (checked in) w lokalnej usłudze Version Control Enterprise Server?

Enterprise Server musi „wiedzieć” o istnieniu repozytorium projektu, w którym przechowywany jest Twój projekt. Nowa instalacja Enterprise Server udostępnia pojedyncze repozytorium projektów oparte na Git, przeznaczone do przechowywania wszystkich projektów Workspace – i to wszystko! Pozwala to uniknąć konfiguracji i złożoności związanej z lokalną usługą Version Control Enterprise Server. Masz jedno repozytorium projektów – Versioned Storage – do którego wszyscy projektanci mają dostęp i do którego mogą wydawać (release) dane. Tego pojedynczego repozytorium Git nie można w żaden sposób modyfikować ani usunąć. Funkcja where-used jest natywnie wspierana przez wbudowane repozytorium projektów Git w Enterprise Server.

Gdy wprowadzam zmianę w komponencie, czy można sprawić, aby była ona tylko lokalna dla projektu?

Oczywiście, że tak. Wprowadzanie lokalnych zmian w projekcie jest istotną częścią podstawowej funkcjonalności Altium Designer. Nie jest to jednak zalecane. Jeśli na jakimś etapie zaktualizujesz ten komponent, używając jednej z funkcji aktualizacji w Altium Designer, zostanie pobrana kolejna rewizja z Enterprise Server, co nadpisze wszelkie zmiany lokalne. Dlatego znacznie lepiej jest wprowadzać zmiany bezpośrednio w komponentach bibliotecznych Workspace w Enterprise Server.

Czy mogę kontrolować, które naruszenia reguł projektu muszą przejść walidację przed zatwierdzeniem (commit) jakiejkolwiek rewizji do Enterprise Server?

Tak, i wszystko to można skonfigurować za pomocą pliku Output Job Configuration. Etap Validate Project procesu release process jest uruchamiany automatycznie, gdy w przypisanych plikach OutJob zostanie wykryty co najmniej jeden raport typu Validation. Uruchamiane są wszystkie zdefiniowane generatory wyjść walidacyjnych, zdefiniowane w pliku Output Job przypisanym do zwalnianego elementu danych. Obejmuje to uruchomienie dowolnych z poniższych:

• Differences Report – użycie komparatora w celu określenia, czy dokumenty źródłowe i dokument PCB są poprawnie zsynchronizowane.
• Electrical Rules Check – sprawdzenie poprawności elektrycznej/rysunkowej przechwyconego projektu źródłowego.
• Design Rules Check – sprawdzenie poprawności dokumentu PCB w odniesieniu do określonych ograniczeń projektowych na poziomie płytki.
• BOM Checks - sprawdzenie możliwych naruszeń związanych z Design Items lub Part Choices w źródłowym dokumencie BOM (*.BomDoc), jeśli jest dostępny.
• Footprint Comparison Report – porównanie footprintów na płytce z ich biblioteką źródłową, aby upewnić się, że są aktualne i zgodne.
• Component State Checking - sprawdzenie komponentów znajdujących się w stanach ograniczonych. W ramach konfiguracji określasz działanie, jakie ma zostać podjęte dla każdego aktualnie zdefiniowanego stanu, dla każdej aktualnie zdefiniowanej definicji cyklu życia (Lifecycle Definition) w docelowym Enterprise Server: brak działania, ostrzeżenie lub wygenerowanie błędu. To ostatnie uniemożliwi wydanie (release) projektu. Dodatkowo uruchomienie sprawdzenia wygeneruje przydatny raport HTML, pozwalający na szybkie sprawdzenie, które komponenty projektu nie znajdują się w prawidłowych stanach.
• Environment Configuration Compliance Check – sprawdzenie, czy używane są wyłącznie elementy danych dozwolone przez konfigurację środowiska dostępną do użycia przez przypisaną grupę (jeśli dotyczy). To sprawdzenie może również zapewnić, że wszystkie elementy projektu pochodzą z Enterprise Server.

Czy Enterprise Server może blokować commity, jeśli pewne walidacje nie przeszły poprzez plik Output Job?

Tak, jeśli kroki walidacji zakończą się niepowodzeniem, wówczas commit i release danych do Enterprise Server nie nastąpią.

Czy mogę zaimportować istniejące projekty do Enterprise Server?

Możesz przenieść istniejące projekty do swojego Enterprise Server, ale obecnie nie możesz przenieść istniejącego repozytorium Subversion. Jeśli chcesz przenieść dane projektowe, musisz je wyciągnąć i ponownie zatwierdzić (recommit) do odpowiedniego repozytorium w Enterprise Server. W praktyce stracisz więc historię tych projektów i zasadniczo zaczniesz od nowa, ale możesz wyeksportować te dane i wprowadzić je z powrotem.

Możesz także konwertować swoje komponenty ze starszych metodologii zarządzania komponentami na komponenty biblioteczne Workspace, z możliwością automatycznego dopasowywania zapewnianą przez potężny Item Manager.