Befehlszeilen-Verwaltungstool

Der Enterprise Server stellt ein Kommandozeilen-Tool für die folgenden Aspekte der Enterprise Server-Konfiguration bereit:

• User Management – damit der Enterprise Server Workspace mit umfangreichen Benutzer- und Gruppenkonfigurationen aus Unternehmenssystemen oder -datensätzen vorab befüllt werden kann, sodass die Einträge nicht einzeln über die browserbasierte Oberfläche des Workspace erstellt werden müssen. Das Tool unterstützt den Import von Benutzern, Gruppen und Benutzer-Gruppen-Zugehörigkeitsdaten aus standardmäßigen kommagetrennten *.csv-Dateien.
• Part Choice Indexing – damit Sie eine Neuindizierung der Part Choices für die Bibliothekskomponenten Ihres Workspace manuell durchführen können, die über benutzerdefinierte Part Sources (Verbindungen zu lokalen Teile-Datenbanken) bezogen werden.

Das Tool – avconfiguration.exe – ist in Ihrer Enterprise Server-Installation enthalten und befindet sich im Ordner \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Zugriff auf das Konfigurationstool

So verwenden Sie das Tool:

1. Starten Sie die Windows-Eingabeaufforderung.
2. Wechseln Sie in den richtigen Ordner. Bei einer Standardinstallation auf Laufwerk C des Host-Computers ist dies: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Um das Tool auszuführen und die verfügbaren Optionen aufzulisten, geben Sie an der Eingabeaufforderung Folgendes ein: avconfiguration ?

Zugriff auf das Konfigurationstool über eine Eingabeaufforderung.

Beachten Sie ?; wenn dies mit angegeben wird, wird die Hilfe zu den im Konfigurationstool verfügbaren Funktionen angezeigt:

• usermanagement – Benutzer und Gruppen importieren.
• suppliers – Part-Choice-Indizierung.
• help – den Hilfebildschirm anzeigen (? kann anstelle der Zeichenfolge help verwendet werden).

Syntax und Schalter für die Benutzerverwaltung

Die folgenden Schalter sind verfügbar, wenn die Funktion usermanagement des Tools verwendet wird:

avconfiguration usermanagement [-help | params [options]]

wobei folgende Parameter verfügbar sind:

• --url – erforderlich. Adresse und Port des Ziel-Enterprise-Servers.
• --user – erforderlich. Der Anteil User Name der Zugangsdaten eines Enterprise Server Workspace-Benutzers.
• --password – erforderlich. Der Anteil Password der Zugangsdaten eines Enterprise Server Workspace-Benutzers (Groß-/Kleinschreibung beachten).
• --roles – Dateiname der Datei mit den zu importierenden Gruppen.
• --users – Dateiname der Datei mit den zu importierenden Benutzern.
• --memberships – Dateiname der Datei mit den zu importierenden Benutzerzugehörigkeiten.

Verfügbare Optionen sind:

• -d – Benutzer und Gruppen löschen, die nicht in den bereitgestellten Dateien aufgeführt sind. Alle vorhandenen Benutzer und Gruppen im Enterprise Server Workspace, die nicht in den bereitgestellten Dateien aufgeführt sind, werden gelöscht (mit Ausnahme der Benutzer System und admin sowie der Gruppe Administrators).
• -o – vorhandene Daten überschreiben. Wenn ein Benutzer im Enterprise Server Workspace vorhanden ist und auch Teil einer importierten Datei ist, werden die Informationen im Workspace durch die Informationen aus der importierten Datei überschrieben.

Wenn Sie nur avconfiguration usermanagement eingeben, werden diese Schalter als hilfreiche Übersicht aufgelistet.

Verfügbare Schalter bei Verwendung des Tools im Modus usermanagement.

Beispiel-CSV-Dateien

Ein Beispiel für jeden erkannten *.csv-Dateityp ist im Verzeichnis des Tools enthalten (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Die Inhaltsbeschreibungen der einzelnen Dateitypen sowie etwaige Anforderungen sind unten aufgeführt.

Enthält Daten zu Benutzerprofilen.

• Jeder Benutzer muss in einer neuen Zeile der Datei definiert werden.
• Es werden keine Einträge in den Enterprise Server Workspace importiert, wenn in der Datei users.csv Daten für eines der erforderlichen Felder fehlen.
• Benutzereinträge werden nicht importiert, wenn ein Fehler in den Daten vorliegt, z. B. wenn eine Domäne angegeben ist, obwohl AUTHTYPE fälschlicherweise auf 0 ('Built In') gesetzt ist.
• Alle Felder müssen in der CSV-Datei vorhanden und durch Kommas getrennt sein. Die Daten für nicht erforderliche Felder sollten leer sein (z. B. field1,,field2,...).

Enthält Gruppendaten.

• Jede Gruppe muss in einer neuen Zeile der Datei definiert werden.

Enthält Daten zur Benutzer-Gruppen-Zugehörigkeit (also welche Benutzer Mitglieder welcher Gruppen sind)

• Jede Definition einer Benutzer-Gruppen-Zugehörigkeit muss in einer neuen Zeile der Datei definiert werden.
• Die Felder müssen durch Kommas getrennt sein.
• Ungültige USERNAME–ROLENAME-Zuordnungen schlagen fehl, verhindern jedoch nicht den Import gültiger Zuordnungen.

Syntax und Schalter für Suppliers

Die folgenden Schalter sind verfügbar, wenn die Funktion suppliers des Tools verwendet wird:

avconfiguration suppliers [-help | params]

wobei folgende Parameter verfügbar sind:

• --url – erforderlich. Adresse und Port des Ziel-Enterprise-Servers.

• --user – erforderlich. Der Anteil User Name der Zugangsdaten eines Enterprise Server Workspace-Benutzers.

• --passwordMD5 – erforderlich. Der Anteil Password der Zugangsdaten eines Enterprise Server Workspace-Benutzers als MD5-Hashwert.

Wenn Sie nur avconfiguration suppliers eingeben, werden diese Schalter als hilfreiche Übersicht aufgelistet.

Verfügbare Schalter bei Verwendung des Tools im Modus suppliers.

Ein Beispieleintrag könnte sein:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3