Parent page: Wartung
Der Enterprise Server stellt ein Befehlszeilentool für die folgenden Aspekte der Enterprise Server-Konfiguration bereit:
-
User Management – damit kann der Enterprise Server Workspace mit umfangreichen Benutzer- und Rollenkonfigurationen vorab geladen werden, die aus Unternehmenssystemen oder -datensätzen abgeleitet sind. Dadurch entfällt die Notwendigkeit, die Einträge einzeln über die browserbasierte Oberfläche des Workspace zu erstellen. Das Tool unterstützt den Import von Benutzern, Rollen und Benutzer-Rollen-Zugehörigkeitsdaten aus standardmäßigen kommagetrennten *.csv-Dateien.
-
Part Choice Indexing – damit können Sie eine Neuindizierung der Part Choices für die Bibliothekskomponenten Ihres Workspace manuell durchführen, die über benutzerdefinierte Part Sources (Verbindungen zu lokalen Teile-Datenbanken) bezogen werden.
Die Neuindizierung der Part Choices kann so eingerichtet werden, dass sie automatisch erfolgt. Konfigurieren Sie dies über das Feld
Indexing part choices every, wenn Sie eine benutzerdefinierte Datenbank-Part-Source definieren. Part Sources werden von einem Workspace-Administrator auf der Seite
Part Providers (
Admin – Part Providers) der Browseroberfläche des Workspace definiert. Weitere Informationen finden Sie unter
Konfigurieren einer benutzerdefinierten Datenbank-Part-Source.
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:
-
Starten Sie die Windows-Eingabeaufforderung.
-
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\.
-
Um das Tool auszuführen und die verfügbaren Optionen aufzulisten, geben Sie an der Eingabeaufforderung Folgendes ein:
avconfiguration ?
Je nach Betriebssystem des Server-PCs kann kopierter Text per Rechtsklick oder Ctrl+V oder mit beiden Methoden in die Eingabeaufforderung eingefügt werden.
Zugriff auf das Konfigurationstool über eine Eingabeaufforderung.
Beachten Sie die Option ?; wenn diese mit angegeben wird, wird Hilfe zu den im Konfigurationstool verfügbaren Funktionen angezeigt:
-
usermanagement – Benutzer und Rollen 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 die verfügbaren Parameter sind:
-
--url – erforderlich. Adresse und Port des Ziel-Enterprise Server.
-
--user – erforderlich. Der User Name-Anteil der Zugangsdaten eines Enterprise Server Workspace-Benutzers.
-
--password – erforderlich. Der Password-Anteil der Zugangsdaten eines Enterprise Server Workspace-Benutzers (Groß-/Kleinschreibung beachten).
-
--roles – Dateiname der Datei mit den zu importierenden Rollen.
-
--users – Dateiname der Datei mit den zu importierenden Benutzern.
-
--memberships – Dateiname der Datei mit den zu importierenden Benutzerzugehörigkeiten.
Der Standardsuchpfad für die CSV-Eingabedateien ist das aktuelle Verzeichnis (in dem sich die Datei avconfiguration.exe befindet). Wenn sich eine Datendatei nicht im aktuellen Verzeichnis befindet, muss der Pfad zur Datendatei mit angegeben werden.
Verfügbare Optionen sind:
-
-d – Benutzer und Rollen löschen, die nicht in den bereitgestellten Dateien aufgeführt sind. Alle vorhandenen Benutzer und Rollen 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 Rolle Administrators).
-
-o – vorhandene Daten überschreiben. Wenn ein Benutzer im Enterprise Server Workspace vorhanden ist und zugleich 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.
Usermanagement Example
Der folgende Eintrag importiert Benutzer, Rollen und Benutzer-Rollen-Zugehörigkeiten, wie sie in den im Installationsverzeichnis enthaltenen Beispieldateien definiert sind (users.csv, roles.csv und memberships.csv). Vorhandene Benutzerdaten werden überschrieben, wenn ein entsprechender Benutzer in der Datei users.csv definiert ist. Darüber hinaus werden alle anderen vorhandenen Enterprise Server-Benutzer und -Rollen, die nicht in den Dateien users.csv und roles.csv definiert sind, gelöscht.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
Beachten Sie, dass sprachspezifische Zeichen (wie Umlaute, Graviszeichen usw.) nicht unterstützt werden.
Das Tool prüft die Dateidaten vor dem Import in den Enterprise Server auf Gültigkeit und zeigt während der Ausführung außerdem für jede verarbeitete Datei Meldungen über Erfolg oder Fehlschlag des Imports an.
Das Ergebnis der Ausführung des Beispielbefehls configuration-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.
users.csv
Enthält Benutzerprofildaten.
| Feldname |
Beschreibung |
Anforderungen |
| FIRSTNAME |
Vorname |
Erforderlich (muss mindestens ein Zeichen enthalten) |
| LASTNAME |
Nachname |
Erforderlich (muss mindestens ein Zeichen enthalten) |
| USERNAME |
Benutzername |
Erforderlich |
| PASSWORD |
Benutzerpasswort |
Erforderlich für den Authentifizierungsmodus 'Built In' |
| PHONE |
Telefonnummer |
|
| AUTHTYPE |
AUTHTYPE |
Erforderlich: Authentifizierungstyp; 0 für 'Built In'-Authentifizierung, 1 für 'Windows'-Authentifizierung (Domäne) |
| EMAIL |
E-Mail-Adresse |
|
| DOMAIN |
Domänenname |
Erforderlich für den Authentifizierungsmodus 'Windows'. |
-
Jeder Benutzer muss in einer neuen Zeile der Datei definiert werden.
-
Es werden keine Einträge in den Enterprise Server Workspace importiert, wenn Daten für eines der erforderlichen Felder in der Datei
users.csv 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 ein Komma getrennt sein. Die Daten für nicht erforderliche Felder sollten leer sein (z. B. field1,,field2,...).
roles.csv
Enthält Rollendaten.
| Feldname |
Beschreibung |
| ROLENAME |
Name der Rolle (muss mindestens ein Zeichen enthalten) |
-
Jede Rolle muss in einer neuen Zeile der Datei definiert werden.
memberships.csv
Enthält Benutzer-Rollen-Zugehörigkeitsdaten (also welche Benutzer Mitglieder welcher Rollen sind)
| Feldname |
Beschreibung |
| ROLENAME |
Rollenname |
| USERNAME |
Benutzername |
-
Jede Definition einer Benutzer-Rollen-Zugehörigkeit muss in einer neuen Zeile der Datei definiert werden.
-
Die Felder müssen durch ein Komma 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 die verfügbaren Parameter sind:
-
--url – erforderlich. Adresse und Port des Ziel-Enterprise Server.
-
--user – erforderlich. Der User Name-Anteil der Zugangsdaten eines Enterprise Server Workspace-Benutzers.
-
--passwordMD5 – erforderlich. Der Password-Anteil der Zugangsdaten eines Enterprise Server Workspace-Benutzers als MD5-Hashwert.
-
--reindexPartChoice – erforderlich. Lieferantenname(n), für die die Part-Choice-Indizierung gestartet werden soll. Dies ist der Name der benutzerdefinierten Custom Database Part Source, die für die Verbindung zu einer lokalen Unternehmens-Teiledatenbank konfiguriert wurde. Trennen Sie mehrere Suppliers (Part Sources) durch ein Komma. Beachten Sie, dass das Komma als Trennzeichen verwendet wird und daher nicht innerhalb eines Part-Source-Namens verwendet werden kann.
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 --reindexPartChoice=MySQLODBC,MsSQL
AI-localized