Narzędzie wiersza poleceń do zarządzania Altium On-Prem Enterprise Server

Parent page: Konserwacja

Enterprise Server udostępnia narzędzie wiersza poleceń, które obejmuje następujące aspekty konfiguracji Enterprise Server:

• User Management – umożliwia wstępne załadowanie Workspace Enterprise Server zbiorczymi konfiguracjami użytkowników i grup pochodzącymi z systemów lub rejestrów firmowych, dzięki czemu nie ma potrzeby tworzenia wpisów pojedynczo przez przeglądarkowy interfejs Workspace. Narzędzie obsługuje import danych Użytkowników, Grup oraz przynależności użytkownik–grupa ze standardowych plików *.csv rozdzielanych przecinkami.
• Part Choice Indexing – umożliwia ręczne wykonanie ponownego indeksowania Part Choices dla komponentów biblioteki Workspace, pozyskiwanych przez zdefiniowane przez użytkownika Part Sources (połączenia z lokalnymi bazami danych części).

Narzędzie – avconfiguration.exe – jest dołączone do instalacji Enterprise Server i można je znaleźć w folderze \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Dostęp do narzędzia konfiguracyjnego

Aby użyć narzędzia:

1. Uruchom Wiersz polecenia systemu Windows.
2. Przejdź do właściwego folderu. Dla domyślnej instalacji na dysku C komputera hosta będzie to: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Aby uruchomić narzędzie i wyświetlić dostępne opcje, w wierszu polecenia wpisz: avconfiguration ?

Dostęp do narzędzia konfiguracyjnego przez Wiersz polecenia.

Zwróć uwagę na ? — jego dodanie wyświetla pomoc dotyczącą funkcji dostępnych w narzędziu konfiguracyjnym:

• usermanagement – import Użytkowników i Grup.
• suppliers – indeksowanie Part Choice.
• help – wyświetlenie ekranu pomocy (? można użyć zamiast ciągu help).

Składnia i przełączniki Usermanagement

Następujące przełączniki są dostępne podczas używania funkcji usermanagement narzędzia:

avconfiguration usermanagement [-help | params [options]]

gdzie dostępne parametry to:

• --url – wymagane. Adres i port docelowego Enterprise Server.
• --user – wymagane. Część User Name danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server.
• --password – wymagane. Część Password danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server (z rozróżnieniem wielkości liter).
• --roles – nazwa pliku zawierającego grupy do zaimportowania.
• --users – nazwa pliku zawierającego użytkowników do zaimportowania.
• --memberships – nazwa pliku zawierającego przynależności użytkowników do zaimportowania.

Dostępne opcje:

• -d – usuń użytkowników i grupy niewymienione w dostarczonych plikach. Wszyscy istniejący użytkownicy i grupy w Workspace Enterprise Server, którzy nie są wymienieni w dostarczonych plikach, zostaną usunięci (z wyjątkiem użytkowników System i admin oraz grupy Administrators).
• -o – nadpisz istniejące dane. Jeśli użytkownik istnieje w Workspace Enterprise Server i jednocześnie znajduje się w importowanym pliku, wówczas informacje w Workspace zostaną nadpisane danymi z importowanego pliku.

Wpisując tylko avconfiguration usermanagement, przełączniki te zostaną wyświetlone jako pomocna ściągawka.

Przełączniki dostępne podczas używania narzędzia w trybie usermanagement.

Przykładowe pliki CSV

Przykład każdego rozpoznawanego pliku *.csv jest dołączony w katalogu narzędzia (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Opisy zawartości każdego typu pliku oraz wymagania przedstawiono poniżej.

Zawiera dane profili użytkowników.

• Każdy użytkownik musi być zdefiniowany w nowej linii pliku.
• Żadne wpisy nie zostaną zaimportowane do Workspace Enterprise Server, jeśli w pliku users.csv brakuje danych dla któregokolwiek z pól wymaganych.
• Wpisy użytkowników nie zostaną zaimportowane, jeśli w danych wystąpi błąd, np. podano domenę, gdy AUTHTYPE jest błędnie ustawione na 0 („Built In”).
• Wszystkie pola muszą być obecne w pliku CSV i rozdzielone przecinkiem. Dane dla pól niewymaganych powinny być puste (np. field1,,field2,...).

Zawiera dane grup.

• Każda grupa musi być zdefiniowana w nowej linii pliku.

Zawiera dane przynależności użytkowników do grup (tj. którzy użytkownicy są członkami których grup)

• Każda definicja przynależności użytkownik–grupa musi być zdefiniowana w nowej linii pliku.
• Pola muszą być rozdzielone przecinkiem.
• Nieprawidłowe dopasowania USERNAME–ROLENAME zakończą się niepowodzeniem, ale nie uniemożliwią importu poprawnych dopasowań.

Składnia i przełączniki Suppliers

Następujące przełączniki są dostępne podczas używania funkcji suppliers narzędzia:

avconfiguration suppliers [-help | params]

gdzie dostępne parametry to:

• --url – wymagane. Adres i port docelowego Enterprise Server.
• --user – wymagane. Część User Name danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server.
• --passwordMD5 – wymagane. Część Password danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server, jako wartość skrótu MD5.
• --reindexPartChoice – wymagane. Nazwa(-y) dostawcy(-ów) do rozpoczęcia indeksowania wyborów części. Jest to nazwa zdefiniowanego przez użytkownika niestandardowego źródła części (Part Source) z bazy danych, skonfigurowanego do łączenia z lokalną firmową bazą danych części. Wiele dostawców (Part Sources) rozdziel przecinkiem. Zwróć uwagę, że ponieważ przecinek jest używany jako separator, nie może on występować w nazwie Part Source.

Wpisując tylko avconfiguration suppliers, przełączniki te zostaną wyświetlone jako pomocna ściągawka.

Przełączniki dostępne podczas używania narzędzia w trybie suppliers.

Przykładowy wpis może wyglądać następująco:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL