Strumento di gestione da riga di comando

Parent page: Manutenzione

Enterprise Server mette a disposizione uno strumento da 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 ruoli 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, ruoli e appartenenze utente-ruolo da file *.csv standard delimitati da virgole.
• Part Choice Indexing – consentire di eseguire manualmente una nuova indicizzazione delle Part Choices per i componenti della libreria del Workspace, provenienti da 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\Altium NEXUS Server\Tools\VaultConfigurationTool.

Accesso allo strumento di configurazione

Per utilizzare lo strumento:

1. Apri 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\Altium NEXUS Server\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 ruoli.
• suppliers – indicizzazione delle Part Choices.
• help – visualizzazione della schermata di aiuto (? può essere usato al posto della stringa help).

Sintassi e opzioni di Usermanagement

Le seguenti opzioni sono disponibili quando si utilizza 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. Parte User Name delle credenziali di accesso di un utente del Workspace di Enterprise Server.
• --password – obbligatorio. Parte 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 ruoli 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 ruoli non elencati nei file forniti. Tutti gli utenti e i ruoli esistenti nel Workspace di Enterprise Server che non sono elencati nei file forniti verranno eliminati (ad eccezione degli utenti System e admin, e del ruolo 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 utilizza 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\Altium NEXUS Server\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 mancano dati per uno qualsiasi dei campi obbligatori nel file users.csv.
• 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 ruoli.

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

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

• Ogni definizione di appartenenza utente-ruolo 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

Le seguenti opzioni sono disponibili quando si utilizza 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. Parte User Name delle credenziali di accesso di un utente del Workspace di Enterprise Server.
• --passwordMD5 – obbligatorio. Parte Password delle credenziali di accesso di un utente del Workspace di Enterprise Server, come valore hash MD5.
• --reindexPartChoice – obbligatorio. Nome del fornitore o dei fornitori 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 viene usato come separatore, non può essere utilizzato all'interno del nome di una Part Source.

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

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

Un esempio di voce potrebbe essere:

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