Strumento di gestione da riga di comando

Enterprise Server mette a disposizione uno strumento da riga di comando per gestire i seguenti aspetti della configurazione di Enterprise Server:

• User Management – consente di precaricare il Workspace di Enterprise Server con configurazioni massive di utenti e gruppi derivate da sistemi o registri aziendali, evitando così la necessità di creare singolarmente le voci tramite l’interfaccia del browser del Workspace. Lo strumento supporta l’importazione di dati relativi a Utenti, Gruppi e appartenenze utente-gruppo da file *.csv standard delimitati da virgole.
• Part Choice Indexing – consente di eseguire manualmente una reindicizzazione delle Part Choices per i componenti della libreria del Workspace, ottenute tramite Part Sources definite dall’utente (connessioni a database locali di componenti).

Lo strumento – avconfiguration.exe – è incluso nell’installazione di Enterprise Server e si trova nella cartella \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Accesso allo strumento di configurazione

Per usare lo strumento:

1. Avvia un Prompt dei comandi di Windows.
2. Vai alla cartella corretta. Per un’installazione predefinita sull’unità C del computer host, sarà: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Per eseguire lo strumento e visualizzare le opzioni disponibili, al prompt digita: avconfiguration ?

Accesso allo strumento di configurazione tramite un Prompt dei comandi.

Nota l’opzione ?: includendola viene visualizzata la guida sulle funzioni disponibili nello strumento di configurazione:

• usermanagement – importa Utenti e Gruppi.
• suppliers – indicizzazione delle Part Choices.
• help – visualizza la schermata di aiuto (? può essere usato al posto della stringa help).

Sintassi e opzioni di Usermanagement

I seguenti switch sono disponibili quando si usa la funzione usermanagement dello strumento:

avconfiguration usermanagement [-help | params [options]]

dove i parametri disponibili sono:

• --url – obbligatorio. Indirizzo e porta dell’istanza Enterprise Server di destinazione.
• --user – obbligatorio. Porzione User Name delle credenziali di accesso di un utente del Workspace di Enterprise Server.
• --password – obbligatorio. Porzione Password delle credenziali di accesso di un utente del Workspace di Enterprise Server (con distinzione tra maiuscole e minuscole).
• --roles – nome del file contenente i gruppi da importare.
• --users – nome del file contenente gli utenti da importare.
• --memberships – nome del file contenente le appartenenze degli utenti da importare.

Le opzioni disponibili sono:

• -d – elimina utenti e gruppi non elencati nei file forniti. Tutti gli utenti e gruppi esistenti nel Workspace di Enterprise Server che non sono elencati nei file forniti verranno eliminati (ad eccezione degli utenti System e admin e del gruppo Administrators).
• -o – sovrascrive i dati esistenti. Se un utente esiste nel Workspace di Enterprise Server ed è anche presente in un file in fase di importazione, le informazioni nel Workspace verranno sovrascritte con quelle del file importato.

Digitando semplicemente avconfiguration usermanagement, questi switch verranno elencati come utile riferimento.

Switch disponibili quando si usa lo strumento in modalità usermanagement.

File CSV di esempio

Un esempio di ciascun file *.csv riconosciuto è incluso nella directory dello strumento (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Di seguito sono riportate le descrizioni del contenuto di ciascun tipo di file e gli eventuali requisiti.

Contiene i dati dei profili utente.

• Ogni utente deve essere definito su una nuova riga del file.
• Nessuna voce verrà importata nel Workspace di Enterprise Server se nel file users.csv mancano dati per uno qualsiasi dei campi obbligatori.
• Le voci utente non verranno importate se è presente un errore nei dati, ad esempio un dominio incluso quando AUTHTYPE è impostato in modo errato su 0 ('Built In').
• Tutti i campi devono essere presenti nel file CSV, separati da una virgola. I dati dei campi non obbligatori devono essere lasciati vuoti (ad esempio field1,,field2,...).

Contiene i dati dei gruppi.

• Ogni gruppo deve essere definito su una nuova riga del file.

Contiene i dati di appartenenza ai gruppi utente (ossia, quali utenti sono membri di quali gruppi)

• Ogni definizione di appartenenza utente-gruppo deve essere riportata su una nuova riga del file.
• I campi devono essere separati da una virgola.
• Le corrispondenze USERNAME–ROLENAME non valide non andranno a buon fine, ma non impediranno l’importazione delle corrispondenze valide.

Sintassi e switch di Suppliers

I seguenti switch sono disponibili quando si usa la funzione suppliers dello strumento:

avconfiguration suppliers [-help | params]

dove i parametri disponibili sono:

• --url – obbligatorio. Indirizzo e porta dell’istanza Enterprise Server di destinazione.

• --user – obbligatorio. Porzione User Name delle credenziali di accesso di un utente del Workspace di Enterprise Server.

• --passwordMD5 – obbligatorio. Porzione Password delle credenziali di accesso di un utente del Workspace di Enterprise Server, come valore hash MD5.

Digitando semplicemente avconfiguration suppliers, questi switch verranno elencati come utile riferimento.

Switch disponibili quando si usa lo strumento in modalità suppliers.

Una voce di esempio potrebbe essere:

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