Strumento di gestione da riga di comando

Parent page: Manutenzione

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

• User Management – consentire il precaricamento del 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 Workspace basata su browser. 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 – consentire di eseguire manualmente una nuova indicizzazione delle Part Choices per i componenti di 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. Passa 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 ?; includerla visualizza la guida sulle funzioni disponibili nello strumento di configurazione:

• usermanagement – importazione di utenti e gruppi.
• suppliers – indicizzazione delle Part Choices.
• help – visualizzazione della schermata di aiuto (? può essere usato al posto della stringa help).

Sintassi e opzioni di Usermanagement

Quando si usa la funzione usermanagement dello strumento, sono disponibili le seguenti opzioni:

avconfiguration usermanagement [-help | params [options]]

dove i parametri disponibili sono:

• --url – obbligatorio. Indirizzo e porta dell'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, queste opzioni verranno elencate come utile riferimento.Opzioni disponibili quando si usa lo strumento in modalità usermanagement.

File CSV di esempio

Nella directory dello strumento è incluso un esempio di ciascun file *.csv riconosciuto (\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 opzioni di Suppliers

Quando si usa la funzione suppliers dello strumento, sono disponibili le seguenti opzioni:

avconfiguration suppliers [-help | params]

dove i parametri disponibili sono:

• --url – obbligatorio. Indirizzo e porta dell'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.
• --reindexPartChoice – obbligatorio. Nome/i del fornitore per avviare l'indicizzazione delle Part Choices. Si tratta del nome della Part Source di database personalizzata definita dall'utente e configurata per connettersi a un database locale aziendale di componenti. Separa più Suppliers (Part Sources) usando una virgola. Nota che, poiché il carattere virgola è usato come separatore, non può essere usato all'interno del nome di una Part Source.

Digitando semplicemente avconfiguration suppliers, queste opzioni verranno elencate come utile riferimento.

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

Un esempio di voce potrebbe essere:

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