Le utilità installate con ArcGIS Data Store forniscono all'amministratore del data store gli strumenti necessari per gestire i data store. Questa pagina descrive le utilità e fornisce la sintassi e gli esempi per ciascuna di esse.
Tutte le utilità devono essere eseguite nel computer ArcGIS Data Store. Le utilità si trovano nella directory <ArcGIS Data Store installation directory>\datastore\tools.
Digitare il nome dell'utilità seguito da --help per ottenere assistenza sulla sintassi.
Nota:
L'account di accesso deve essere un membro del gruppo degli amministratori di Windowsed è necessario avviare il prompt dei comandi con l'opzione Esegui come amministratore per utilizzare le utilitàArcGIS Data Store.
allowconnection
Questa utilità viene utilizzata con i Data Store relazionali.
Per impostazione predefinita, tutte le connessioni al Data Store vengono effettuate tramite il sito di GIS Server per motivi di sicurezza. Se si desidera aprire un data store relazionale per le connessioni da un altro computer, è possibile utilizzare l'utilità di comando allowconnection.
È possibile eseguire l'utilità allowconnection solo nel computer primario del Data Store relazionale.
Sintassi
allowconnection <host name> <username> [<database>]
Specificare il nome del computer da cui si desidera connettersi al Data Store relazionale (nome host) e uno degli account del database utilizzati dal Data Store (nome utente): l'amministratore del Data Store, il proprietario della replica, l'amministratore del geodatabase o l'utente gestito (l'utente che pubblica i dati dei Feature Layer), che è possibile ottenere mediante l'utilità listadminusers o listmanageduser. È possibile specificare anche il nome del database del Data Store relazionale primario, ma poiché ne esiste uno solo questo valore è opzionale.
Esempio
In questo esempio si autorizzano le connessioni al Data Store relazionale effettuate dall'utente gestito hqo.n_1E7 dal computer workcom.
allowconnection workcom hqo.n_1E7
backupdatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Utilizzare questa utilità per creare un backup completo di un data store tra i tempi di backup programmati. Per esempio, creare un backup di ogni data store prima di effettuare l'aggiornamento del ArcGIS Data Store o prima di apportare un gran numero di modifiche a un data store.
L'utilità backupdatastore può essere eseguita per un solo tipo di data store alla volta.
La tabella seguente indica dove eseguire l'utilità backupdatastore e cosa fa l'utilità per ogni tipo di data store:
| Tipo di Data Store | Computer | Comportamento |
|---|---|---|
Data Store relazionali | Eseguire l'utilità backupdatastore solo nel computer primario del data store relazionale. | L'utilità backupdatastore crea sempre un backup completo del data store relazionale. |
Data Store cache tile | L'utilità backupdatastore può essere eseguita su qualsiasi computer del data store cache tile. | La prima volta che si esegue l'utilità backupdatastore per un Tile Cache Data store dopo aver impostato un percorso di backup, vengono create le copie di backup dei database di tutti i Tile Cache Data store esistenti. I successivi utilizzi dell'utilità backupdatastore creano copie di backup dei database di tutti i Tile Cache Data Store creati dopo l'ultima esecuzione dell'utilità. |
Spatiotemporal Big Data Store | L'utilità backupdatastore può essere eseguita su qualsiasi computer del cluster. | Quando viene eseguita l'utilità backupdatastore per uno Spatiotemporal Big Data store per la prima volta dopo aver impostato un percorso di backup, viene creato un backup completo. L'uso successivo dell'utilità backupdatastore crea un file di backup contenente solo le modifiche apportate dal backup completo iniziale. |
Archivio oggetti | L'utilità backupdatastore può essere eseguita su qualsiasi computer del cluster. | L'utilità backupdatastore crea sempre un backup completo dell'archivio oggetti per i dati del servizio video. Le cache di interrogazioni del feature layer non sono incluse nel file di backup. |
Archivio grafici | L'utilità backupdatastore può essere eseguita su uno dei due computer dell'archivio grafici. | L'utilità backupdatastore crea sempre un backup completo dell'archivio grafici. |
Prima di eseguire l'utilità backupdatastore, assicurarsi che la posizione di backup per il data store sia sufficientemente grande per ospitare i backup. Per modificare le posizioni di backup dei Data Store, utilizzare l'utilità configurebackuplocation.
Per maggiori informazioni sui backup ArcGIS Data Store, vedere Gestisci ArcGIS Data Store backup.
Sintassi
backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]
È necessario fornire un nome per il file di backup.
Se non si specifica l'opzione --store, si presume il valore relational.
Se non si specifica l'opzione --location, i file di backup vengono scritti nella posizione di backup predefinita del data store.
Per specificare invece una delle altre posizioni di backup registrate, utilizzare l'opzione --location. È possibile fornire il nome del backup o il tipo e la posizione del backup. Quando si utilizzano gli argomenti type= e location=, separarli con un punto e virgola (;).
Qui di seguito gli argomenti supportati per l'opzione --location:
| Argomento | Descrizione |
|---|---|
name= | È possibile utilizzare il nome della posizione di backup per indicare la posizione di backup registrata. Se si specifica un nome, non è necessario utilizzare gli argomenti type= e location=. |
type= | Se non si specifica il nome di una posizione di backup, è necessario specificare il tipo di posizione di backup e la posizione fisica. Qui di seguito i valori del tipo e le relative descrizioni:
|
location= | Utilizzare l'argomento location= per indicare la posizione fisica della posizione di backup registrata. Questo argomento deve essere utilizzato con l'argomento type=. Per le condivisioni di file, fornire il percorso del file. Per bucket S3, fornire il nome del bucket. Per i contenitori di archiviazione Azure Blob, fornire il nome del contenitore. |
Esempi
In questo esempio, l'utilità backupdatastore crea un file di backup completo denominato project1bu nella posizione di backup predefinita del data store relazionale. Includendo --prompt no, l'utilità non richiede una risposta di conferma.
backupdatastore project1bu --prompt no
In questo esempio, viene creato un file di backup denominato localbu5 per lo Spatiotemporal Big Data Store in una posizione di condivisione di file, denominata gadbu al momento della configurazione della posizione di backup.
backupdatastore localbu5 --store spatiotemporal --location name=gadbu You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
In questo esempio, viene creato il backup di uno Spatiotemporal Big Data Store in un contenitore di archiviazione Azure Blob denominato blob4backups. Il nome del file di backup è spds311016:
backupdatastore spds311016 --store spatiotemporal --location type=azure;location=blob4backups You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
changedatastoremode
Questa utilità viene utilizzata con Data Store relazionali e Spatiotemporal Big Data Store.
L'utilità changedatastoremode consente di impostare il Data Store relazionale primario sulla modalità di sola lettura durante l'esecuzione delle attività di manutenzione sul Data Store. Ad esempio, se è necessario eseguire un'attività di manutenzione che comporta il riavvio del Data Store, ad esempio la modifica della posizione di backup in un'unità diversa oppure la modifica delle proprietà del database, è possibile impostare il Data Store sulla modalità di sola lettura in modo da impedire agli utenti di pubblicare o modificare i dati quando il Data Store viene riavviato.
L'utilità changedatastoremode può essere utilizzata anche per reimpostare il Data Store relazionale sulla modalità di lettura/scrittura al termine delle attività di manutenzione oppure dopo aver aggiunto altro spazio su disco al computer primario del Data Store per consentire il corretto funzionamento del Data Store nella modalità di lettura/scrittura.
È necessario eseguire l'utilità changedatastoremode sul computer primario del Data store relazionale, non su quello di standby.
Quando lo spazio su disco dello spatiotemporal big data store è quasi esaurito, ArcGIS Data Store lo imposta in modalità di sola lettura per evitare che i dati vengano danneggiati. È possibile usare l'utilità changedatastoremode per riportare uno spatiotemporal big data store in modalità di lettura/scrittura dopo aver aggiunto sufficiente spazio su disco sui computer Spatiotemporal Big Data Store.
Nota:
Se ArcGIS Data Store posiziona il data store in modalità di sola lettura a causa dello spazio insufficiente sul disco, anche i backup automatici vengono disattivati per evitare di riempire ulteriormente il disco. Pertanto, è necessario reimpostare il programma di backup automatico utilizzando l'utilità updatebackupschedule dopo aver rimesso il data store in modalità lettura-scrittura.
Sintassi
changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}
Esempi
In questo esempio, il data store relazionale è posizionato in modalità di sola lettura, il che significa che i clienti non possono eseguire attività come la pubblicazione di feature layer in hosting su ArcGIS Enterprise o la modifica dei dati attraverso un feature layer in hosting. L'opzione --prompt viene fornita per eliminare la richiesta di conferma.
changedatastoremode readonly --store relational --prompt no
Per posizionare un big data store spaziotemporale in modalità lettura-scrittura dopo aver aggiunto spazio su disco ai computer, specificare l'opzione readwrite e specificare spatiotemporal con l'opzione --store come mostrato nel seguente esempio:
changedatastoremode readwrite --prompt no --store spatiotemporal
changedbproperties
Questa utilità viene utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.
L'utilità changedbproperties consente di modificare varie proprietà in base al tipo di Data Store rispetto al quale viene eseguita.
Sintassi
changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]
È necessario fornire l'opzione --store e almeno un'opzione di configurazione. Di seguito sono riportate le opzioni di configurazione supportate, le relative descrizioni e il tipo di data store con cui ciascuna opzione può essere utilizzata:
| Opzione di configurazione | Descrizione | Tipo di data store supportato |
|---|---|---|
--disk-threshold-readonly | Questa opzione controlla quando un data store relazionale verrà posto in modalità di sola lettura, per evitare la perdita di dati a causa dello spazio insufficiente sul disco. Specificare le dimensioni in MB. Il valore predefinito per lo spazio su disco è pari a 1024 MB. | Solo data store relazionale |
--max-connections | utilizzare questo parametro per specificare il numero massimo di connessioni consentite a un Data Store relazionale. I Data Store relazionali accettano fino a 150 connessioni per impostazione predefinita. Utilizzare la proprietà --max-connections per modificare il numero di connessioni consentite. Tener presente che i processi interni ArcGIS Data Store possono richiedere fino a cinque connessioni. Considerare inoltre il numero di connessioni contemporanee che il computer ArcGIS Data Store può accettare continuando a funzionare bene. Se il computer che esegue ArcGIS Data Store non dispone di molta memoria, potrebbe essere necessario diminuire il numero di connessioni consentite. Il numero specificato non può essere inferiore a 10. In tal caso, il numero massimo di connessioni consentite viene modificato sia sul computer del Data Store principale che su quello del Data Store di standby. | Solo data store relazionale |
--pitr | Questa opzione indica se ArcGIS Data Store crea backup incrementali del data store relazionale, consentendo così di ripristinare il data store relazionale a un momento preciso. Gli argomenti possibili per questa opzione sono enable o disable. | Solo data store relazionale L'impostazione predefinita è --pitr disable. Nota:È necessario impostare l'opzione --pitr su enable se si intende utilizzare l'utilità webgisdr, che è installata con Portal for ArcGIS—per creare backup incrementali della propria installazione ArcGIS Enterprise. |
--enablessl | Questa opzione controlla l'uso del protocollo Transport Layer Security (TLS) durante il popolamento del data store cache tile e per la comunicazione tra il data store relazionale e il server di hosting. Gli argomenti supportati per il parametro --enablessl sono:
| Data store relazionali e data store cache tile |
--heap-size | utilizzare questo parametro per modificare la quantità di memoria di heap (in MB) utilizzata da uno Spatiotemporal Big Data Store. Per impostazione predefinita, questo tipo di Data Store utilizzerà metà della memoria RAM disponibile sul dispositivo (fino al 70 percento di RAM libera) quando viene avviato. È possibile modificare la dimensione dell'heap in una quantità compresa tra 512 MB e 32.000 MB, ma occorre assicurarsi che la quantità specificata non superi la quantità di RAM disponibile sul computer. | Spatiotemporal Big Data Store |
--rebalance | Per impostazione predefinita, questa opzione è impostata su true, il che significa che il big data store spaziotemporale distribuisce i dati ad altri computer se uno di essi non è disponibile. Se occorre eseguire una manutenzione su un computer big data store spaziotemporale, ad esempio aggiornarlo, è possibile interrompere temporaneamente il ribilanciamento specificando --rebalance false. L'opzione di ribilanciamento verrà sospesa per il numero di minuti impostato per il parametro --max-rebalance-off. | Spatiotemporal Big Data Store |
--max-rebalance-off | Questa opzione viene utilizzata in combinazione con l'opzione --rebalance per indicare per quanto tempo il ribilanciamento resterà in sospeso. Per impostazione predefinita, --max-rebalance-off è impostato su 60 minuti. Questo significa che se il ribilanciamento viene temporaneamente arrestato, ripartirà dopo 60 minuti. Se è richiesto un periodo di tempo maggiore o minore, eseguire l'attività di manutenzione per la quale il ribilanciamento è stato sospeso e modificare l'impostazione del tempo per --max-rebalance-off. | Spatiotemporal Big Data Store |
--prompt | quando si esegue questa utilità, viene chiesto di confermare l'azione specificata. Se l'utilizzo di questa utilità viene automatizzato, specificare --prompt no; altrimenti, lo script non procederà fino a quando non si risponderà alla richiesta. | big data store relazionale, cache tile e spaziotemporale |
Esempi
Le seguenti sezioni includono esempi dell'utilizzo delle opzioni disponibili con l'utilità changedbproperties.
Caricare il threshold di sola lettura per i data store relazionali
In maniera predefinita, il data store relazionale viene impostato in modalità sola lettura quando lo spazio libero su disco viene ridotto a 1.024 MB. Nel seguente esempio, ci sono altre app che scrivono al dispositivo, per cui l'amministratore configura il data store relazionale impostato in modalità sola lettura più presto: quando lo spazio libero su disco del dispositivo viene ridotto a 4.000 MB:
changedbproperties --store relational --disk-threshold-readonly 4000
You are changing the following database properties:
...disk space threshold to change relational data store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesCambiare il numero di connessioni permesse per il data store relazionale
In questo esempio, il numero massimo di connessioni consentite a un Data Store relazione è impostato su 100:
changedbproperties --store relational --max-connections 100
You are changing the following database properties:
...max number of connections to 100 (on all relational data store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesAbilitare il ripristino point-in-time per il data store relazionale
Per impostazione predefinita, il ripristino point-in-time è disabilitato. In questo esempio, il ripristino point-in-time è abilitato per il data store relazionale:
changedbproperties --store relational --pitr enable
You are changing the following database properties:
...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesDisabilitare SSL
Per impostazione predefinita, il data store relazionale comunica con il server di hosting tramite HTTPS. In questo esempio, il --enablessl parametro viene utilizzato per configurare il data store relazionale affinché comunichi con il server di hosting tramite HTTP.
changedbproperties --store relational --enablessl false
You are changing the following database properties:
...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesCambiare la heap size per lo Spatiotemporal Big Data Store
Per impostazione predefinita, lo spatiotemporal big data store utilizza metà della RAM sul dispositivo (e 70 percento della RAM libera) all'avvio.
Attenzione:
La riduzione della heap size potrebbe impedire al data store di avviarsi. Se l'utente aumenta la heap size, si prega di non specificare un numero che supera la quantità di RAM disponibile sul dispositivo.
In questo esempio, la heap size è impostata su 1.600 MB.
changedbproperties --store spatiotemporal --heap-size 1600
You are changing the following database properties:
...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?YesMettere in pausa il ribilanciamento per lo Spatiotemporal Big Data Store
In questo esempio, l'amministratore ha bisogno di effettuare una breve procedura di manutenzione su un dispositivo in uno spatiotemporal big data store e non vuole che il data store venga nuovamente bilanciato. Per fare questo, le opzioni --rebalance e --max-rebalance-off sono utilizzate per sospendere il ribilanciamento per 30 minuti. Dopo 30 minuti, lo spatiotemporal big data store cambierà automaticamente rebalance in vero.
Dato che questo deve avvenire periodicamente, l'amministratore mantiene la seguente dichiarazione in uno script e imposta l'opzione prompt su no.
changedbproperties --store spatiotemporal --rebalance false --prompt no
changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no
changeloglocation
Questa utilità viene utilizzata con tutti i tipi di Data Store.
La posizione predefinita del file di registro degli errori per ArcGIS Data Store è <ArcGIS Data Store directory>\arcgisdatastore\logs. Per utilizzare una directory di file diversa, eseguire l'utilità changeloglocation e specificare il percorso della nuova directory.
L'account ArcGIS Data Store deve avere privilegi di scrittura sulla directory specificata.
Sintassi
changeloglocation <directory path>
Esempio
In questo esempio, i file di log verranno creati nella directory locale, d:\datastorefiles\logs.
changeloglocation 'd:\datastorefiles\logs'
changenosqldslocation
Questa utilità viene utilizzata con i Tile Cache Data Store.
Le dimensioni dei Tile Cache Data Store in cui sono memorizzate numerose tile ad alta risoluzione possono risultare elevate. In questi casi, è opportuno spostare i dati su un'altra unità dello stesso server o in un percorso condiviso su un altro server.
Qualora si dovessero spostare i dati in una directory condivisa, sarà necessario concedere le autorizzazioni di lettura e scrittura sulla directory all'account ArcGIS Data Store .
Sintassi
changenosqldslocation <path> [--prompt {yes | no}]
Esempio
In questo esempio, i database che memorizzano le cache degli Scene Layer verranno creati in una directory condivisa denominata dstorecache sul computer server2.
changenosqldslocation \\server2\dstorecache --prompt no
changepassword
Questa utilità viene utilizzata con i Data Store relazionali.
ArcGIS Data Store genera in modo casuale nomi utente e password per gli account di database utilizzati per i Data Store relazionali. Se il sito richiede di impostare le proprie password, procurarsi le password per gli account dei data store relazionali ed eseguire changepassword per reimpostarle.
Utilizzare l'utilità listadminusers per ottenere nomi utente e password per utenti con ruolo amministratore e l'utilità listmanageduser per ottenere nome utente e password per il proprietario dei dati della feature.
L'utilità changepassword deve essere eseguita sul computer primario del data store relazionale. Per identificare quale sia il computer primario, eseguire l'utilità describedatastore.
Sintassi
changepassword <username> <new password> [--prompt {yes | no}]
Esempio
In questo esempio la password dell'utente gwi_n2Te0 viene modificata in Phfl4mp!.
changepassword gwi_n2Te0 Phfl4mp
You are going to change the password for user gwi_n2Te0. Do you want to continue (Yes or No)?Yes
Se è necessario utilizzare uno script per modificare le password, includere un flag per disattivare il prompt di conferma, come nell'esempio seguente:
changepassword gwi_n2Te0 Phfl4mp --prompt no
changestaginglocation
Questa utilità viene utilizzata con il data store relazionale, il data store cache tile e l'archivio grafici.
Quando si ripristina il data store relazionale o cache tile, ArcGIS Data Store estrae i file di backup compressi in una posizione di archiviazione temporanea. Questo significa che è necessario disporre di un percorso di archiviazione temporanea per ospitare i dati non compressi. Per impostazione predefinita, questa posizione si trova nella directory dei dati ArcGIS Data Store. Se sono presenti molti dati nel data store relazionale o cache tile, impostare una posizione di archiviazione temporanea distinta e specificarla per il ripristino.
Allo stesso modo, se si definisce un bucket S3 o un contenitore di archiviazione Blob Azure per i file di backup del data store relazionale, del data store cache tile o dell'archivio grafici, la posizione di archiviazione temporanea viene utilizzata per impacchettare i file di backup prima di copiarli nella posizione di archiviazione cloud.
Sintassi
changestaginglocation <directory path>
Esempio
In questo esempio, il percorso di archiviazione temporanea specificato è \\netserver\rbustage.
changestaginglocation \\netserver\rbustage
configurebackuplocation
Questa utilità viene utilizzata con tutti i tipi di Data Store.
L'utilità configurebackuplocation consente di specificare la posizione in cui ArcGIS Data Store scrive i file di backup sia per i backup pianificati sia per i backup creati con l'utilità backupdatastore. L'utilità configurebackuplocation consente inoltre di modificare le proprietà di una posizione di backup e di rimuovere una posizione di backup.
I Data store relazionali vengono creati utilizzando un percorso di backup locale predefinito. Per evitare la perdita di dati, configura una posizione di backup predefinita registrando una condivisione di file remota utilizzando l'opzione change.
I data store cache tile in modalità primaria-standby hanno un percorso di backup predefinito; i data store cache tile creati in modalità cluster non ce l'hanno. In entrambi i casi, utilizzare l'utilità configurebackuplocation con l'opzione register per specificare un percorso di rete condiviso, un bucket Amazon Simple Storage Service (S3) o un contenitore di archiviazione Microsoft Azure Blob per memorizzare in maniera sicura i backup del data store cache tile. Non è possibile utilizzare un drive locale per i file di backup cache tile se il data store è in esecuzione in modalità cluster.
I big data store spaziotemporali, agli archivi grafici e gli archivi oggetti non vengono creati con una posizione di backup predefinita. Prima di iniziare a creare i backup, è necessario eseguire l'utilità configurebackuplocation con l'opzione register di specificare una posizione di condivisione file, un bucket Amazon Simple Storage Service (S3) o un contenitore di archiviazione Blob Microsoft Azure per questi backup.
Nota:
Non è possibile usare un'unità locale per i file di backup dello Spatiotemporal Big Data Store.
È possibile registrare un secondo percorso di backup per memorizzare i backup creati utilizzando l'utilità backupdatastore. È possibile utilizzare una directory dei file condivisa, un bucket S3 o un contenitore di archiviazione Azure Blob per percorsi di backup secondari.
Per maggiori informazioni sui backup ArcGIS Data Store, vedere Gestisci ArcGIS Data Store backup.
Sintassi
configurebackuplocation --store {relational | tileCache | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]
Opzioni richieste
È necessario fornire le seguenti opzioni quando si esegue l'utilità configurebackuplocation:
- --store {relational | tileCache | spatiotemporal | graph | object}
Specificare il tipo di ArcGIS Data Store per il quale si stanno configurando o interrogando le posizioni di backup. Il valore predefinito è relational.
- --operation {change | register | unregister | list | setdefault}
L'opzione --operation specifica l'azione che l'utilità configurebackuplocaton intraprenderà. Il valore predefinito è change.
Di seguito è riportata una spiegazione di ogni argomento utilizzabile con l'opzione --operation:
| Opzione | Descrizione |
|---|---|
change | Utilizzare questo argomento per modificare una qualsiasi delle seguenti opzioni:
|
register | Utilizzare questo argomento per registrare una posizione di backup. Quando si utilizza l'argomento register, è necessario fornire l'opzione --location . La prima posizione di backup definita per un Big Data Store spaziotemporale, archivio grafico o Data Store cache tile eseguito in modalità cluster è impostata come posizione di backup predefinita. Quando si registra un'altra posizione di backup per un data store di cache tile (modalità primaria-standby o cluster), un big data store spaziotemporale o un archivio grafico, viene registrata una posizione di backup secondaria. Per il data store relazionale, l'argomento register registra sempre una posizione di backup secondaria. La posizione di backup secondaria può essere utilizzata per archiviare i backup manuali generati con l'utilità backupdatastore. |
unregister | Utilizzare questo argomento per rimuovere una posizione di backup secondaria da un data store. Se è stata registrata una sola posizione di backup, l'argomento unregister rimuove completamente la posizione di backup per un big data store cache tile o spaziotemporale o un archivio grafici. |
list | Elencare tutte le posizioni di backup registrate per il data store specificato con l'opzione --store. L'elenco indica la posizione fisica di backup, il nome della posizione di backup e quale è registrata come posizione di backup predefinita. |
setdefault | Se sono state configurate più posizioni di backup per un archivio grafici, un data store cache tile o un big data store spaziotemporale, utilizzare l'argomento setdefault per designare una delle posizioni di backup come posizione predefinita. Questa sarà la posizione nella quale si scriveranno i backup programmati, nonché la posizione predefinita in caso di esecuzione dell'utilità backupdatastore, listbackups o restoredatastore senza specificare una posizione di backup. |
Opzione posizione
L'opzione --location è richiesta nei seguenti scenari:
- Specificare la posizione di archiviazione di backup quando si registra una posizione di backup o si modifica la posizione di backup predefinita per il data store relazionale.
- Per modificare il nome di una posizione di backup esistente, fornire l'argomento name e il valore del nuovo nome.
È possibile utilizzare l'opzione --location quando si imposta una posizione di backup predefinita o si rimuove una posizione di backup, oppure è possibile utilizzare il nome del backup.
Per i data store cache tile o i big data store spaziotemporali, o per registrare una posizione di backup secondaria per un data store relazionale, specificare i seguenti argomenti con l'opzione --location separata da un punto e virgola (;) e racchiudere l'intera stringa di argomenti tra virgolette doppie ("):
--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".
Di seguito viene fornita una spiegazione di ciascuno degli argomenti supportati dall'opzione --location:
| Argomento | Descrizione |
|---|---|
type= | Questo argomento è obbligatorio. Definire il tipo di posizione da utilizzare per i backup. Specificare fs per archiviare i backup in una condivisione di file. Per i data store relazionali, la posizione di backup predefinita deve essere una condivisione di file. Specificare s3 per archiviare i backup in un bucket Amazon S3. Specificare azure per archiviare i backup in un contenitore di archiviazione Blob Azure. |
location= | Questo argomento è obbligatorio. Per le condivisioni di file, specificare il percorso del file. Per i bucket Amazon S3, specificare il nome e il percorso del bucket. Per i contenitori di archiviazione Blob, specificare il nome del contenitore. |
name= | È possibile assegnare un nome alla posizione di backup. Ad esempio, se la posizione di backup è un percorso di file, ad esempio \\sharedserver_sharedfolders_datastorebackups, è possibile designare un nome per questa posizione, ad esempio dsbackupsfolder. Quando si esegue l'utilità backupdatastore, listbackups o restoredatastore, fornire questo nome invece del percorso di posizione. Se non si fornisce un nome quando si configura la posizione del backup del Data Store, ArcGIS Data Store assegna un nome predefinito. |
username= | Questo argomento è necessario se si imposta l'argomento type= su azure o s3. Per i bucket S3, fornire l'ID della chiave di accesso per l'account Amazon Web Services (AWS). Per i contenitori di archiviazione Azure Blob, fornire il nome per l'account di archiviazione Microsoft Azure che può accedere al contenitore di archiviazione Blob. |
password= | Questo argomento è necessario se si imposta l'argomento type= su azure o s3. Per i bucket S3, fornire la chiave segreta per l'account AWS. Per i contenitori di archiviazione Azure Blob, fornire la chiave per l'account Azure specificato con l'argomento username. |
endpointsuffix= | Se imposta l'argomento type= su azure, è possibile utilizzare l'argomento endpointsuffix per indicare dove si trova il contenitore di archiviazione Blob Azure. Per impostazione predefinita, si presume che endpointsuffix corrisponda a core.windows.net. Se il contenitore si trova nell'ambiente cloud GovernativoMicrosoft Azure, impostare endpointsuffix=core.usgovcloudapi.net. Se il contenitore si trova in un cloud privato, impostare endpointsuffix al suffisso endpoint del proprio cloud privato Azure. |
region= | Questo argomento è necessario quando si imposta l'argomento type= su s3. È necessario fornire il codice regione. Ad esempio, impostare la regione su ap-southeast-2 se il bucket è installato nella regione Asia Pacifico (Sidney). Per i codici regione, consultare la documentazione di AWS. |
Opzioni aggiuntive
Ulteriori opzioni che è possibile fornire con l'utilità configurebackuplocation sono:
| Opzione | Descrizione |
|---|---|
--force | utilizzata solo con Data Store relazionali, questa opzione consente di modificare la posizione di backup predefinita anche se quella esistente non è disponibile. I valori validi sono true o false. Quando si modifica la posizione di backup predefinita per un Data Store relazionale, ArcGIS Data Store copia i file di backup esistenti dalla vecchia posizione alla nuova posizione. Se ArcGIS Data Store non può accedere alla vecchia posizione, non può copiare i file. Nelle versioni precedenti, ciò causerebbe un errore nello strumento configurebackuplocation. Se si desidera procedere con la modifica della posizione di backup predefinita senza copiare i file di backup esistenti, specificare --force true. Il valore predefinito per questa opzione è false, il che significa che non è possibile modificare la posizione di backup predefinita se ArcGIS Data Store non può accedere alla posizione predefinita esistente. |
--prompt | I valori validi sono yes o no. quando si esegue questa utilità, viene chiesto di confermare l'azione specificata. Se si automatizza l'uso di questa utilità, impostare l'opzione --prompt su no; altrimenti, lo script non procederà fino a quando non si risponderà al prompt. |
Esempi
Le seguenti sezioni forniscono esempi di carica, impostazione, o elenco di posizioni backup per i data store.
Cambiare la posizione del backup di default per il data store relazionale
Nel primo esempio, la posizione di backup per un Data Store relazionale è impostata su una directory denominata fsdata_bu in un computer denominato myshare.
configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu" You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
Aggiungere una posizione di backup per il data store relazionale
In questo esempio, viene registrato un secondo percorso di backup su Azure per lo stesso Spatiotemporal Big Data Store.
configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)? Yes
Impostare una posizione di backup per un archivio di grafici
In questo esempio, una posizione di backup su una condivisione di network è registrata per un archivio di grafici. Si assegna un nome, fshare, alla posizione di backup.
configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare" --prompt no
Aggiungere le posizione di backup e impostare una posizione predefinita
In questo esempio, viene specificata una seconda posizione di backup su per lo Spatiotemporal Big Data Store. La posizione di backup aggiuntiva è nel' Azure archivio.
configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no
In questo esempio, viene specificata una seconda posizione di backup nella regione Europa (Spagna) su AWS per lo stesso big data store spaziotemporale. Si assegna un nome, awsloc, alla posizione di backup.
configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no
In questo esempio, il S3 bucket viene impostato come posizione di backup predefinita per lo Spatiotemporal Big Data Store utilizzando il nome della posizione di backup (awsloc).
configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no
Ottenere un elenco di tutte le posizioni di backup per un data store
In questo esempio, sono elencate tutte le posizioni di backup per lo Spatiotemporal Big Data Store.
configurebackuplocation --operation list --store spatiotemporal
Backup locations for spatiotemporal big data store: ================================================================ Name Type Location isDefault ================================================================ fsshare fs \\sharedmachine\ge_bu false awsloc s3 mybucket true mazloc azure myblobs false
configuredatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Dopo aver installato ArcGIS Data Store, è possibile eseguire l'utilità configuraatastore invece di eseguire la configurazione guidata Data Store per creare un archivio dati e registrarlo con un sito GIS Server. È possibile creare i seguenti tipi di data store utilizzando questa utilità:
- Data Store relazionali
- Data Store cache tile
- Spatiotemporal Big Data Store
- Archivio grafici
- Archivio oggetti
Di seguito sono riportati ulteriori utilizzi dell'utilità configuredatastore:
- Aggiornare un data store dopo aver aggiornato il software ArcGIS Data Store su tutti i computer del data store.
- Designare il ruolo di un computer in un big data store spaziotemporale.
Sintassi
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}] [--roles {coord | data}]
| Opzione | Descrizione |
|---|---|
<ArcGIS Server admin URL> | Questo è il sito GIS Server che viene o verrà utilizzato come server di hosting ArcGIS Enterprise. Il formato dell'URL di amministrazione di ArcGIS Server è https://gisserver.domain.com:6443. Nota:Anche se il sito GIS Server utilizza un web adaptor o un sistema di bilanciamento, è necessario specificare l'URL nel formato sopra indicato. |
<ArcGIS Server administrator> | Fornire il nome utente di un utente integrato (non specifico dell'organizzazione) che ha privilegi di amministratore nel sito di hosting GIS Server. |
<ArcGIS Server administrator password> | Fornire la password dell'account utilizzato in precedenza. |
<data directory> | La directory dei dati è la posizione sul computer locale dove verranno creati i file del data store. |
--stores | Questa opzione indica il tipo di ArcGIS Data Store da configurare. I valori validi sono i seguenti:
Se non si specifica l'opzione --stores, si presume il valore relational. |
--mode | Questa opzione facoltativa si applica solo ai data store cache tile e agli archivi di oggetti. I valori validi sono singleInstance, primaryStandby o cluster. Se non si specifica una modalità, i data store cache tile vengono creati in primaryStandby mode e gli archivi di oggetti vengono creati in modalità singleInstance. I Data Store cache tile creati in modalità primaryStandby possono contenere due computer. Se il data store cache tile deve essere scalabile per includere tre o più computer, creare un data store cache tile in modalità cluster. È possibile utilizzare l'opzione --mode per commutare il data store cache tile dalla modalità primaryStandby alla modalità cluster. Gli archivi di oggetti creati in modalità singleInstance possono contenere solo un computer. Se occorre un'alta disponibilità, installare l'archivio oggetti in modalità cluster. Quando utilizzato in modalità cluster deve contenere almeno tre macchine. La modalità primaryStandby non si applica più agli archivi di oggetti. Non è possibile cambiare modalità per un archivio oggetti. Per i dettagli, consultare Aggiungere un computer al Data Store. |
--roles | Questa opzione facoltativa si applica solo ai big data store spaziotemporali di più computer. I valori supportati sono coord, data o coord,data. I computer big data store spaziotemporali possono essere creati in uno dei due ruoli o in entrambi i ruoli. Per installare un computer in entrambi i ruoli, separare i due ruoli con una virgola; ad esempio, specificare --role coord,data quando si esegue l'utilità configuredatastore per creare un big data store spaziotemporale su un computer. Per una descrizione di ciascun ruolo - coordinatore e dati - vedere Aggiungi computer a un data store. È inoltre possibile eseguire l'utilità Configuredatastore con l'opzione --roles per cambiare il ruolo di un computer di big data store spaziotemporale esistente. |
Configurare un tipo specifico di Data Store
Specificare il tipo di data store da creare utilizzando l'opzione --stores, come indicato sopra. Utilizzare i seguenti link per una descrizione di ciascun tipo di data store:
- Data Store relazionali
- Data Store cache tile
- Spatiotemporal Big Data Store
- Archivio grafici
- Archivio oggetti
Per configurare più di un tipo di data store sullo stesso computer, separare i tipi con una virgola (senza spazi). Ad esempio, per configurare sia un Data Store relazionale che un Data Store cache tile sullo stesso computer, specificare --stores relational,tileCache.
Nota:
I Data Store configurati sullo stesso computer concorrono per la memoria e altre risorse, influendo negativamente sulle prestazioni e causando il possibile arresto dei Data Store. Ciò vale in particolar modo per gli Spatiotemporal Big Data Store , gli archivi di grafici e gli archivi oggetti; non configurare uno Spatiotemporal Big Data Store, un archivio di grafici o un archivio oggetti sullo stesso computer di un altro Data Store o altro componente ArcGIS.
Se si esegue lo script per la creazione di più computer di big data store spaziotemporale, è necessario configurare manualmente un computer di big data store spaziotemporale con il sito GIS Server prima di poter eseguire lo script per la creazione di ulteriori computer di big data store spaziotemporale. Includere i tempi di attesa nello script per accertarsi che i computer spatiotemporal big data store aggiuntivi non vengano aggiunti contemporaneamente.
Ogni tipo di data store ha una modalità predefinita in cui viene creato. È possibile specificare una modalità diversa quando si crea un data store cache tile o un archivio oggetti.
Per le istruzioni, vedere Crea un data store.
Configurare i Data Store dopo aver aggiornato le installazioni di ArcGIS Data Store
Come parte dell'aggiornamento di ArcGIS Data Store, è necessario riconfigurare i computer esistenti del Data Store. Dopo aver installato una nuova versione di ArcGIS Data Store sull'esistente ArcGIS Data Store su ogni computer del data store, accedere a qualsiasi computer di un data store ed eseguire l'utilità configuredatastore per terminare l'aggiornamento di quel particolare tipo di data store. Ad esempio, eseguire configuredatastore sul computer primario del data store relazionale, ed anche il computer standby verrà aggiornato.
Se il computer contiene sia un Tile Cache Data store sia un Data store relazionale, specificare --stores relational,tileCache quando si esegue l'utilità configuredatastore, e verranno aggiornati tutti i computer di entrambi i Data store.
Per riconfigurare i computer Spatiotemporal Big Data Store aggiornati, accedere a uno qualunque dei computer Spatiotemporal Big Data Store ed eseguire l'utilità configuredatastore. In questo modo, si aggiornano tutti i computer dello Spatiotemporal Big Data Store.
La configurazione non può procedere finché non si installa la nuova versione di ArcGIS Data Store su tutti i computer nell'installazione ArcGIS Enterprise.
Consultare Aggiorna ArcGIS Data Store per maggiori informazioni.
Cambio di modalità per il data store di cache tile
Per determinare la modalità corrente impostata per il Data Store tile cache, eseguire l'utilità describedatastore sul dispositivo del Data Store tile cache.
Se occorre cambiare la modalità del data store di cache tile da primaria-standby a cluster, eseguire l'utilità configuredatastore con l'opzione --modeimpostata su cluster.
Nota:
È possibile utilizzare l'opzione --mode per specificare la modalità data store cache tile o archivio oggetti al momento della creazione del data store o per cambiare la modalità del data store cache tile da primaryStandby a cluster, ma non è possibile cambiare la modalità durante l'aggiornamento di un data store cache tile, non è possibile cambiare la modalità del data store cache tile da cluster a primaryStandby e non è possibile cambiare la modalità di qualsiasi altro tipo di data store.
Cambiare il ruolo del computer del big data store spaziotemporale
Ogni cluster big data store spaziotemporale deve avere un computer nel ruolo di coordinatore che agisce come coordinatore corrente di tutti gli altri computer del cluster. Il primo computer creato in un big data store spaziotemporale deve includere il ruolo di coordinatore, e questo primo computer è il coordinatore corrente, attivo. Per garantire che il cluster continui a funzionare anche quando il computer coordinatore corrente si guasta, il cluster deve disporre di almeno altri due computer a cui è stato assegnato il ruolo di coordinatore.
Un cluster big data store spaziotemporale deve disporre di almeno un computer nel ruolo dati.
I ruoli vengono assegnati ai computer quando li si aggiunge al cluster, come descritto in Aggiungi computer a un data store. I computer idonei a diventare coordinatori possono essere modificati per archiviare solo i dati. Ai computer che attualmente hanno solo il ruolo dati può essere aggiunto il ruolo coordinatore.
I cambiamenti di ruolo supportati sono i seguenti:
- Specificare --roles data per cambiare un coordinatore in un computer di dati. Questo è possibile se ci sono altri computer eleggibili a coordinatore nel cluster. È possibile cambiare un computer coordinatore in un ruolo dati se ci sono almeno altri tre computer idonei al ruolo di coordinatore nel cluster.
- Specificare --roles data per rimuovere il ruolo di coordinatore da un computer che è stato installato con entrambi i ruoli. Questo lascia che il computer assuma il ruolo di dati. È possibile rimuovere il ruolo di coordinatore dal computer se nel cluster sono presenti almeno altri tre computer idonei al ruolo di coordinatore.
- Specificare --roles coord,data per aggiungere il ruolo di coordinatore a un computer che inizialmente era stato installato per ricoprire solo il ruolo dati. Il ruolo di coordinatore può essere ricoperto da un massimo di cinque computer. Se nel cluster sono già presenti cinque computer coordinatori, non è possibile aggiungere il ruolo di coordinatore a un computer dati nel cluster.
Suggerimento:
Prima di cambiare il ruolo di un computer, eseguire l'utilità describedatastore su uno dei computer per identificare il ruolo assegnato a ciascun computer nel cluster big data store spaziotemporale.
Esempi
In questo esempio viene creato un Data Store per i dati dei Feature Layer hosted (Data Store relazionale). L' URL del sito GIS Server che utilizzerà il data store è https://gisserver.domain.com:6443, il nome utente e la password dell'amministratore del site sono rispettivamente admin e Iph33l$ik e la directory dei dati per il Data Store è C:\datastore\data\.
configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\data\ --stores relational --prompt no
Nel seguente esempio, un Data Store cache tile (primario-standby) esistente viene commutato sulla modalità cluster.
configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\scenedata\ --stores tileCache --mode cluster --prompt no
Nell'esempio successivo, a uno dei computer di soli dati in un cluster big data store spaziotemporale viene aggiunto il ruolo di coordinatore, rendendolo idoneo ad agire come coordinatore se il computer coordinatore attuale si guasta.
configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\scenedata\ --stores spatiotemporal --roles coord,data --prompt no
configureserviceaccount
Questa utilità viene utilizzata con tutti i tipi di data store sui server Microsoft Windows.
L'utilità configureserviceaccount modifica l'accesso utilizzato per ArcGIS Data Store l'account su un singolo computer Windows.
Quando si imposta l'account utilizzando questa utilità, è possibile esportare le informazioni relative all'account in un file. La password è criptata nel file. È possibile utilizzare questo file per importare le stesse informazioni sull'account, ad esempio, è possibile configurare un altro ArcGIS Data Store e utilizzare lo stesso account. In questo caso, eseguire l'utilità configureserviceaccount su un nuovo computer e importare il file con le informazioni sull'account.
È anche possibile utilizzare questa utilità per aggiornare la password dell'account ArcGIS Data Store. Se la password per l'account di Windows cambia, eseguire l'utilità e specificare una nuova password per l'account.
Se si imposta l'account di ArcGIS Data Store su un account del servizio gestito di gruppo, l'account specificato con il parametro username può includere $ alla fine del nome dell'account o ometterlo. Non è necessario specificare il parametro password quando si utilizza un account del servizio gestito di gruppo.
Quando si aggiorna l'account, è necessario aggiornarlo per ogni computer del data store. Ad esempio, se si aggiorna l'account per un big data store spaziotemporale a tre nodi, è necessario eseguire l'utilità configureserviceaccount su tutti e tre i computer.
Sintassi
configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]
| Opzione | Descrizione |
|---|---|
--username | Accesso di rete o account di servizio gestito dal gruppo utilizzato per l'account ArcGIS Data Store. Questa opzione non è necessaria se si utilizza l'opzione --readconfig. |
--password | Password per l'accesso di rete specificato con l'opzione --username. Per cambiare la password dell'account esistente ArcGIS Data Store, eseguire l'utilità configureserviceaccount con l'opzione --username e specificare la nuova password con l'opzione --password. Questa opzione non è necessaria se si utilizza l'opzione --readconfig oppure se si specifica un account di servizio gestito da un gruppo con l'opzione --username. |
--writeconfig | Se inclusa quando si esegue l'utilità configureserviceaccount, questa opzione crea un file di configurazione contenente le credenziali fornite. Le informazioni sulla password sono crittografate nel file. |
--readconfig | Configura l'account ArcGIS Data Store utilizzando le informazioni memorizzate in un file di configurazione creato con l'opzione --writeconfig. Quando si utilizza questa opzione, non sono necessarie altre opzioni. |
Esempio
In questo esempio, l'utilità configureserviceaccount imposta l'account mynetwork\datastore per eseguire il servizio ArcGIS Data Store e concede a questo account i privilegi richiesti sulle cartelle e i file di sistema ArcGIS Data Store.
configureserviceaccount --username mynetwork\datastore --password SewL0ng
In questo esempio, viene utilizzato un account di servizio gestito dal gruppo per l'account ArcGIS Data Store e le informazioni vengono scritte in un file di configurazione nella directory temp:
configureserviceaccount --username mydomain\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml
Nota:
Se si modifica l'account rispetto al quale si esegue il servizio, questo viene riavviato.
In questo esempio, l'account ArcGIS Data Store viene modificato e le informazioni sull'account vengono scritte in un file (adsainfo) in C:\adminfiles.
configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml
In questo esempio, ArcGIS Data Store viene installato su un computer diverso e l'amministratore esegue l'utilità configureserviceaccount per impostare lo stesso account utilizzando il file creato nell'esempio precedente.
configureserviceaccount --readconfig C:\adminfiles\adsainfo
deletebackup
Questa utilità è usata con data store relazionali e archivi grafici.
L'utilità deletebackup consente di eliminare i file di backup creati per i data store relazionali e gli archivi oggetti. Eseguire innanzitutto l'utilità configurebackuplocation con l'opzione --operation impostata su list per ottenere un elenco di tutte le posizioni di backup configurate per il data store. Successivamente, eseguire l'utilità listbackups con una delle posizioni per visualizzare i nomi e l'ora di creazione dei backup in tale posizione. Ripetere il passaggio per ogni posizione di backup. Potete poi eseguire l'utilità deletebackup per cancellare i file di backup che non ti servono più. È necessario eseguire deletebackup separatamente per ogni posizione da cui si desidera eliminare i file di backup.
Nota:
È possibile eliminare solo i backup che non sono necessari per ripristinare il data store. Ad esempio, non è possibile eliminare il backup completo più recente di un Data Store relazionale.
Sintassi
deletebackup <backup name> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]
Esempio
Nell'esempio seguente, il backup del data store relazionale denominato featuresMarchbu viene eliminato dalla posizione di backup predefinita.
deletebackup featuresMarchbu --store relational
You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
In questo esempio, l'archivio oggetti june-videobu viene eliminato dalla posizione di backup predefinita denominata videobucket.
deletebackup june-videobu --store object -- location "videobucket"
You are attempting to delete backup 'june-videobu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
L'utilità describedatastore fornisce informazioni su un'installazione ArcGIS Data Store. Segnala quali tipi di data store sono installati sul computer in cui si esegue l'utilità e fornisce informazioni su ciascun tipo di data store presente sul computer.
Nota:
Se un data store viene installato sul computer ma non viene configurato, appare come ArcGIS Data Store non disponibile e non saranno restituite ulteriori informazioni per quel tipo di data store.
Alcune informazioni sono comuni a tutti i tipi di data store, mentre altre sono specifiche per un tipo di data store. Le tabelle seguenti elencano e spiegano le proprietà restituite dall'utilità describedatastore:
Proprietà generali
I valori di queste proprietà sono gli stessi per tutti i tipi di data store installati sul computer.
| Proprietà | Descrizione |
|---|---|
Versione ArcGIS Data Store | Il numero di versione del software per l'installazione ArcGIS Data Store. |
Posizione di archiviazione | Per i data store relazionali e cache tile, la posizione di archiviazione è dove ArcGIS Data Store estrae i file di backup compressi prima di ripristinare il data store. Se un data store ha una posizione di archiviazione cloud configurata per i backup, i file di backup vengono prima collocati nella posizione di archiviazione per poi essere copiati nella posizione di archiviazione cloud. Per cambiare la posizione di archiviazione, utilizzare l'utilità changestaginglocation. |
Posizione del registro | Directory del file in cui scrivere i file di registro ArcGIS Data Store. Per modificare la posizione del file di registro, utilizzare l'utilità changeloglocation. |
Spazio libero su disco | Quantità di spazio su disco disponibile sul computer in cui è installato ArcGIS Data Store. |
Proprietà comuni
Queste proprietà appaiono per ogni tipo di data store, ma i relativi valori sono specifici del data store per il quale sono elencati.
| Proprietà | Descrizione |
|---|---|
Posizione di backup | Posizione di backup predefinita utilizzata da ogni tipo di data store. |
Pianificazione del backup | Per i backup automatizzati, con quale frequenza viene creato un backup di ciascun tipo di data store. |
Stato del data store | Indica se il data store è in esecuzione. |
URL del sistema proprietario | Il sito di hosting GIS Server presso il quale è registrato il data store. Di solito si tratta dello stesso server di hosting per tutti i data store presenti sul computer; tuttavia, sullo stesso computer è possibile avere data store che vengono utilizzati con installazioni ArcGIS Enterprise diverse. |
URL di Portal for ArcGIS | Di solito si tratta dello stesso URL Portal for ArcGIS per tutti i data store sul computer; tuttavia, sullo stesso computer è possibile avere data store che vengono utilizzati con installazioni ArcGIS Enterprise diverse. |
Computer registrati | Un elenco di tutti i computer del tipo di data store specifico. Questa proprietà elenca tutti i computer, indipendentemente dal relativo stato. |
Proprietà del data store relazionale
Queste proprietà sono specifiche per l'installazione di un data store relazionale.
| Proprietà | Descrizione |
|---|---|
Giorni di conservazione del backup | Il numero di giorni in cui i file di backup del data store relazionale vengono conservati prima che ArcGIS Data Store li elimini. |
È abilitato il ripristino point-in-time | Indica se il data store relazionale è configurato per creare backup incrementali, che consentono di ripristinarlo a un momento specifico. Questa impostazione viene configurata utilizzando l'utilità changedbproperties. |
SSL abilitato | Indica se la comunicazione SSL è abilitata. |
Soglia per la modalità READONLY | La soglia di spazio libero su disco al raggiungimento della quale il data store relazionale sarà posto in modalità di sola lettura. È possibile modificare questo valore per il data store relazionale utilizzando l'utilità changedbproperties. |
Connessioni massime | Indica il numero massimo consentito di connessioni al data store relazionale. |
Numero di connessioni | Il numero di connessioni correnti del feature layer al data store relazionale. |
Modalità data store | Indica se il data store è in modalità di lettura-scrittura o di sola lettura. |
Ultimo failover | Questa proprietà riporta la data e l'ora più recenti in cui il computer primario si è guastato, con conseguente promozione del computer standby al ruolo primario. Questa proprietà non è elencata se il data store non è mai andato in failover. |
Proprietà del data store cache tile
Queste proprietà sono specifiche per l'installazione di un data store cache tile.
| Proprietà | Descrizione |
|---|---|
Computer membri | Se il data store cache tile è installato in modalità cluster, questa proprietà fornisce un elenco dei computer attivi e disponibili nel cluster. |
Ultimo failover | Per i data store cache tile che funzionano in modalità primaria-standby, questa proprietà riporta la data e l'ora più recenti in cui il computer primario si è guastato, con conseguente promozione del computer standby al ruolo primario. Questa proprietà non è elencata se il data store non è mai andato in failover. |
Modalità di installazione | Indica se il data store cache tile è in esecuzione in modalità primaria-standby o cluster. |
SSL abilitato | Indica se la comunicazione SSL è abilitata. |
Proprietà del big data store spaziotemporale
Queste proprietà sono specifiche di un'installazione dei big data store spaziotemporale.
| Proprietà | Descrizione |
|---|---|
Il cluster è finalizzato | Indica se il cluster contiene il numero minimo richiesto di computer coordinatori e dati. |
Ribilanciamento automatico | Se il valore di questa proprietà è impostato su on, il big data store spaziotemporale distribuisce i dati ad altri computer se uno di essi non è disponibile. Se il valore di questa proprietà è impostato su off, i dati non saranno ridistribuiti se un computer non è disponibile. Questa impostazione viene modificata utilizzando l'utilità changedbproperties. |
Tempo massimo di ribilanciamento | Quando si disabilita il ribilanciamento (in tal caso, il valore della proprietà Ribilanciamento automatico verrà impostato su off), lo stesso è disabilitato solo per il numero di minuti indicato da questa proprietà. Al termine di questo periodo di tempo, il valore della proprietà Ribilanciamento automatico verrà impostato su on. Questa impostazione viene modificata utilizzando l'utilità changedbproperties. |
Soglia per la modalità READONLY | Soglia di spazio libero su disco al raggiungimento della quale il big data store spaziotemporale sarà posto in modalità di sola lettura. |
Computer membri | Un elenco dei computer attivi e disponibili nel cluster del big data store spaziotemporale. |
Modalità data store | Indica se il data store è in modalità di lettura-scrittura o di sola lettura. |
Computer coordinatore corrente nel cluster | Computer nel big data store spaziotemporale che al momento funge da coordinatore di tutti i computer del cluster. |
Computer candidati coordinatori in un cluster spaziotemporale | Computer nel big data store spaziotemporale che hanno il ruolo di coordinatore assegnato e, quindi, possono assumere il ruolo di coordinatore corrente. |
Computer di dati in cluster spaziotemporali | Computer nel big data store spaziotemporale a cui è stato assegnato il ruolo dati. |
Proprietà dell'archivio grafici
Queste proprietà sono specifiche per l'installazione di un archivio grafici.
| Proprietà | Descrizione |
|---|---|
Modalità di installazione | Indica se il data store è stato installato in modalità istanza singola o cluster. |
Ultimo failover | Questa proprietà riporta la data e l'ora più recenti in cui il computer primario si è guastato, con conseguente promozione del computer standby al ruolo primario. Questa proprietà non è elencata se il data store non è mai andato in failover. |
Proprietà dell'archivio oggetti
Queste proprietà sono specifiche per l'installazione di un archivio oggetti.
| Proprietà | Descrizione |
|---|---|
Modalità di installazione | Indica se il data store è stato installato in modalità istanza singola o cluster. Gli archivi oggetti creati prima del ArcGIS Data Store 11.1 segnaleranno la modalità primaria-standby, ma possono contenere solo un computer. |
Sintassi
describedatastore
Esempio
L'utilità describedatastore restituisce informazioni generali valide per tutti i Data Store in un computer, nonché sezioni distinte contenenti informazioni specifiche relative a ogni tipo di Data Store.
Si potrebbero avere diversi Data Store su diversi computer, ma per consentire la visualizzazioni delle informazioni restituite per ciascun tipo, il seguente output fa riferimento a un computer contenente tutti i tipi diArcGIS Data Store sullo stesso computer. Le prime due sezioni (ArcGIS Data Store disponibili e Informazioni generali) vengono sempre restituite. Le sezioni del data store restituite da describedatastore variano a seconda del tipo di data store presente sul computer in cui si esegue l'utilità.
describedatastore
Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.3.0.1234
Staging location.............C:\arcgisdatastore\staging
Log location.................C:\arcgisdatastore\logs
Free disk space..............174.00GB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location..............\\nwshare\dsbackups
Backup schedule..............{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained.........31
Data store status............Started
SSL enabled..................true
Last failover................20150130190334005
Threshold for READONLY mode..2048MB
Registered machines..........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections..........150
Owning system URL............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL........https://portal_webadaptor.domain.com/portal
Number of connections........8 connection(s) to managed database
Data store mode..............READWRITE
Is point-in-time recovery enabled...No
Information for tile cache data store ds_wztxj7um
==============================================================
Data location..............C:\arcgisdatastore\nosqldata
Data store status..........Started
Backup location............\\mybackups\scenebackup
Backup schedule............{"schedule-starttime":"01:00:00","schedule-frequency":"Every 1 DAYS"}
Deployment mode............cluster
SSL enabled................true
Member machines............MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines........MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL..........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL......https://portal_webadaptor.domain.com/portal
Information for spatiotemporal data store ds_qpko99Cl
==============================================================
Is cluster finalized................Yes
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Threshold for READONLY mode.........1024MB
Backup location.....................\\nwshare2\sbds_bu
Backup schedule.....................{"schedule-starttime":"02:00:00","schedule-frequency":"Every 2 DAYS"}
Member machines.....................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Coordinator candidate machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator machine in cluster......MACHINE1.DOMAIN.COM
Data machines in spatiotemporal cluster.....MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered machines.................MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data store mode.....................READWRITE
Information for graph store x2b7s0n
==============================================================
Deployment mode.............primaryStandby
Backup location.............\\nwshare3\graphbu
Backup schedule.............{"schedule-starttime":"03:00:00","schedule-frequency":"Every 3 DAYS"}
Registered machines.........MACHINE1.DOMAIN.COM
Owning system URL...........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL.......https://portal_webadaptor.domain.com/portal
Information for object store w1tiknx
==============================================================
Deployment mode.............singleInstance
Backup location.............\\nwshare4\myfiles\ods_bu
Backup schedule.............{"schedule-starttime":"04:00:00","schedule-frequency":"Every 2 DAYS"}
Registered machines.........MACHINE1.DOMAIN.COM
Owning system URL...........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.......https://portal_webadaptor.domain.com/portaldiskcleanup
Questa utilità viene utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.
L'utilità diskcleanup rimuove i file temporanei lasciati da operazioni come il restoreatastore e l'aggiornamento ArcGIS Data Store. Dopo l'aggiornamento vengono conservati alcuni file che ti permetterebbero di risolvere i problemi di un aggiornamento o di un'operazione di ripristino non riuscita. Una volta confermata l'operazione di aggiornamento o ripristino e se il sistema funziona come previsto, è possibile eseguire questo strumento per rimuovere i file temporanei e recuperare spazio libero su disco sui computer di data store.
Questa utility ripulisce lo spazio su disco su un computer alla volta. Se hai bisogno di pulire i file su più di un computer nello stesso archivio dati, devi eseguire lo strumento su ciascun computer.
Sintassi
diskcleanup
Esempio
Per eseguire l'utilità diskcleanup, devi confermare che vuoi procedere.
diskcleanup
You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?
listadminusers
Questa utilità viene utilizzata con tutti i tipi di Data Store.
L'utilità listadminusers restituisce i nomi utente e le password dell'amministratore, del proprietario della replica e dell'amministratore del geodatabase di un Data Store relazionale. Restituisce le credenziali dell'amministratore per tutti gli altri tipi di data store.
Sintassi
listadminusers
Esempi
In questo esempio, listadminusers viene eseguito su un computer in cui è installato solo un Data Store relazionale.
listadminusers
Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
In questo esempio, listadminusers viene eseguito su un computer in cui è installato solo uno Spatiotemporal Big Data Store.
listadminusers
Admin users for spatiotemporal big data store bds_abcd1234 ================================================= Store admin user.... els_321ret / B1as70fF1
In questo esempio, listadminusers viene eseguito su un computer dove è installato solo un archivio grafico.
listadminusers
Admin users for graph store s2t0ic1 ================================================= Store admin user....root / ypz5kx2c5tk4fequ
In questo esempio, listadminusers viene eseguito su un computer in cui è installato solo un archivio oggetti.
listadminusers
Admin users for object store w1tiknx ================================================= Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4
listbackups
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Quando viene eseguita per i Data store relazionali, l'utilità listbackups funziona solo sul computer primario del Data store.
Eseguire l'utilità listbackups per stabilire:
- L'ora di avvio di un'operazione di backup
- Se un backup è terminato o è ancora in esecuzione
- Se il backup è stato creato con l'utilità backupdatastore o automaticamente da ArcGIS Data Store
- Quali sono i file di backup utilizzabili. Se il file di backup non viene restituito dall'utilità listbackups, non potrà essere utilizzato per ripristinare il data store. Per esempio, i file di backup creati con una versione precedente ArcGIS Data Store potrebbero non funzionare per ripristinare il data store.
- Il numero di file di backup presenti per stabilire se occorre eliminarne qualcuno
- Verificare i nomi dei file di backup prima di eseguire l'utilità deletebackup
Quando si esegue l'utilità listbackups, specificare il percorso di backup per il quale si desidera visualizzare l'elenco di file di backup. Se non si specifica una posizione, l'utilità listbackups restituisce i backup per la posizione di backup predefinita.
Sintassi
listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location "<location_arguments>"]
Se non si specifica un tipo di data store (--store), l'utilità si imposta su relational e restituisce i backup per il data store relazionale in esecuzione su quel computer. Se il data store relazionale non è presente nel computer in cui si esegue l'utilità, quest'ultima restituirà un messaggio di errore.
Utilizzare l'opzione --location per scoprire le informazioni sui backup in una specifica posizione di backup registrata. Se non si specifica una posizione, vengono restituite le informazioni relative alla posizione di backup predefinita. Fornire uno dei seguenti argomenti con l'opzione --location:
| Argomento | Descrizione |
|---|---|
name= | Fornire il nome della posizione di backup. Si è specificato questo nome quando è stata configurata la posizione di backup o, se non si è specificato un nome, ArcGIS Data Store ha assegnato un nome predefinito. |
location= | Specificare il percorso della directory di file condivisa, bucket S3 o contenitore di archiviazione Blob registrati come posizione di backup. |
Esempi
In questo esempio vengono elencati i backup per la posizione di backup predefinita di un data store relazionale:
listbackups --store relational
Backup_Name Status Backup_Time Mode ======================================================================= phase1proj_bu BackupComplete 2023-03-08 14:12 manual phase2proj_bu BackupComplete 2023-02-21 11:43 manual ds_gdt1omh-2023020130 BackupComplete 2023-02-01 03:00 scheduled Backups located at: '\\myserver.net.com\dsbackups'
In questo esempio, vengono elencati i backup dello Spatiotemporal Big Data Store per la posizione di backup denominata sbdsbu:
listbackups --store spatiotemporal --location "name=sbdsbu"
Backup_Name Status Backup_Time Mode ================================================================== backup1 BackupComplete 2023-07-11 09:47 manual Backups located at: '\\myserver.net.com\spatiotemporal'
listdatasources
Questa utilità viene utilizzata con Spatiotemporal Big Data Store.
A causa di un bug in 10.8.1, ArcGIS GeoEvent Server i map service che utilizzano l'aggregazione quadrata o esagonale non vengono renderizzati dopo il potenziamento alla versione 10.9 o superiore. Per correggere questo, è possibile eseguire l'utilità listdatasources per ottenere i nomi dei GeoEvent Server map service, e utilizzare i nomi dei servizi che restituisce con l'utilità upgradedatasource per aggiornare i dati per servizi individuali.
L'utilità listdatasources può essere eseguita su qualsiasi dispositivo nello spatiotemporal big data store.
Sintassi
listdatasources
Esempio
Eseguire l'utilità listdatasources presso un prompt di comando per produrre una lista di GeoEvent Server map service.
listdatasources
listmanageduser
Questa utilità viene utilizzata con tutti i tipi di Data Store.
L'utilità listmanageduser restituisce il nome utente e la password dell'account proprietario dei dati dei Feature Layer hosted nei Data Store relazionali e negli Spatiotemporal Big Data Store. Questa utilità restituisce anche il nome utente e la password del proprietario della cache delle scene per i data store cache tile, il proprietario dei grafici nell'archivio grafici e il proprietario dei video nell'archivio oggetti.
Sintassi
listmanageduser
Esempi
Nell'esempio seguente, l'utilità listmanageduser viene eseguita su un computer contenente un Data store relazionale e un Tile Cache Data store. Il computer è il Data store relazionale primario.
listmanageduser
Managed user for relational data store ds_abcd1234 =================================================== UserName Password Database gwi_n2Te0 4cXddhZhve=Y db_qv5e1 Managed user for tile cache data store tcs_e41f0rj2 =================================================== UserName Password usr_n8778 y47ccno913
In questo esempio, l'utilità listmanageduser viene eseguita sul computer dello Spatiotemporal Big Data Store.
listmanageduser
Managed user for spatiotemporal big data store bds_6udbx4321 ============================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
Nell'esempio seguente, listmanageduser viene eseguito su un computer archivio grafici.
listmanageduser
Managed user for graph store s2t0ic1 ================================================ UserName Password mu_vwmp8c6 m5c2so76y3b0qczf
Nell'esempio che segue, l'utilità listmanageduser viene eseguita sul computer dell'archivio oggetti.
listmanageduser
Managed user for object store w1tiknx ============================================================= Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4
registerdatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Il data store conserva le informazioni sui nomi dei computer del sito di hostingGIS Server. Se si trasferisce il sito di hosting GIS Server a nuovi computer (ad esempio, se è stato acquisito un nuovo hardware o se i computer esistenti GIS Server si sono guastati), è necessario annullare la registrazione del data store dal sito GIS Server per rimuovere queste informazioni. Dopo aver configurato GIS Server su un nuovo computer (o più computer), registrare il data store con il sito GIS Server utilizzando l'utilità registerdatastore.
Nota:
L'utilità registerdatastore viene utilizzata per registrare il data store nello stesso sito GIS Server in cui era registrato in precedenza. Il Data Store contiene i dati relativi ai Feature Layer hosted sul Site di GIS Server esistente. Se lo si registra in un sito GIS Server diverso, i layer ospitati non vengono ricreati.
L'utilità registerdatastore può essere eseguita sul computer primario del data store relazionale o dell'archivio grafici, oppure sul computer primario di un data store cache tile che funziona in modalità primaria-standby. Può essere eseguito su qualsiasi computer in un data store tile cache oppure magazzino oggetti che funziona in modalità cluster o qualsiasi computer in spatiotemporal big data store.
Sintassi
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}
Anche se non è una procedura consigliata, se sono presenti diversi tipi di Data Store installati sullo stesso computer, è possibile registrarli contemporaneamente specificando i vari tipi di Data Store separandoli con una virgola (senza spazi). Ad esempio, immettere --stores relational,tileCache.
Esempio
In questo esempio, viene registrato un Data Store relazionale in un Site di GIS Server il cui URL è https://gisserver.domain.com:6443. Il ArcGIS Server nome utente dell'amministratore principale del Site di è agsadmin e la password è Tan$p0n.
registerdatastore https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational
removemachine
Questa utility è usata con archivi relazionali, tile cache, big data spazio-temporali e archivi di grafici.
Utilizzare l'utilità removemachine per rimuovere un computer da un Data store che contiene più di un computer. L'utilità removemachine viene utilizzata nelle seguenti situazioni:
- Rimuovere un computer di standby da un data store relazionale o da un archivio grafici. L'utilità può essere eseguita su computer standby o sul computer primario se il computer standby non è disponibile.
- Rimuovere un computer da un Tile Cache Data store. È possibile eseguire questa utilità su qualsiasi computer nel Tile Cache Data store, ma non è possibile eseguire removemachine su un Tile Cache Data Store composto da un solo computer.
- Rimuovere un computer da un Spatiotemporal Big Data Store. È possibile eseguire questa utilità su qualsiasi computer nello Spatiotemporal Big Data store, ma non è possibile eseguire removemachine su uno Spatiotemporal Big Data store composto da un solo computer.
Se si esegue questa utilità sul computer coordinatore corrente, uno dei restanti computer eleggibili a manager nel cluster deve assumere il ruolo di coordinatore corrente. Affinché ciò avvenga, devono essere presenti almeno altri due computer nel cluster a cui è stato assegnato il ruolo manager. Prima di rimuovere un computer, eseguire l'utilità describedatastore per identificare quale computer è il coordinatore corrente e quali sono eleggibili a coordinatore.
Sintassi
removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]
È necessario fornire il nome del computer e il tipo di data store.
Specificare true con l'opzione --force solo se il sito registrato ArcGIS Server non è disponibile.
Per impostazione predefinita, verrà richiesto di confermare l'esecuzione dell'utilità. Se non si desidera confermare l'azione, specificare no con l'opzione --prompt.
Esempi
In questo esempio, il computer Spatiotemporal Big Data Store, gefour, viene rimosso dal Data Store.
removemachine gefour --store spatiotemporal --prompt no
In questo esempio, il Site del server di hosting non è disponibile e il computer del Data Store relazionale, fsdata, viene rimosso dal Data Store.
removemachine fsdata --store relational --force true --prompt no
replacesslcertificate
Questa utilità viene utilizzata con tutti i tipi di Data Store.
È possibile sostituire il certificato autofirmato ArcGIS Data Store utilizzato dal server web per autenticare la comunicazione tra il server di hosting e il data store e tra i computer del data store con un certificato verificato e firmato da un'autorità di certificazione (CA) o un certificato di dominio. È inoltre possibile sostituire il certificato autofirmato utilizzato per comunicare tra i computer tramite le porte per i seguenti tipi di data store:
- Data Store relazionali
- Data Store cache tile
- Archivio grafici
- Archivio oggetti
Questa utilità finirà per sostituire l'utilità updatesslcertificate.
Per ulteriori informazioni, vedere Sostituire il certificato SSL di ArcGIS Data Store.
Sintassi
replacesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate> --option <webserver | relational | graph | object | tileCache>
Esempi
Nel seguente esempio, il certificato autofirmato utilizzato per l'autenticazione del server web viene sostituito con un file di certificato firmato da una CA (mysignedcert.pfx).
replacesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" "mycacert" --option webserver
Nell'esempio successivo, il certificato autofirmato utilizzato per la comunicazione con il data store relazionale tramite le porte viene sostituito con un certificato firmato da una CA (mysecondsignedcert.pfx).
replacesslcertificate C:\myfiles\mysecondsignedcert.pfx "ps4mycert" "relcacert" --option relational
restoredatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Se si perde l'accesso ai dati utilizzati dai feature layer ospitati, utilizzare i file di backup e l'utilità restoredatastore per recuperare il data store.
Se non è possibile recuperare il data store, installare ArcGIS Data Store in un nuovo computer, non configurare il data store e ripristinare l'ultimo backup completo nel nuovo computer.
Se si utilizza un Data Store relazionale e si desidera ripristinare i dati dei feature layer ospitati ad un momento specifico nel passato, eseguire il ripristino sul Data Store esistente.
Nota:
Il data store relazionale deve essere configurato per supportare il ripristino point-in-time ed è possibile ripristinare solo lo stato precedente del data store relazionale per il quale sono disponibili i file di backup. Ad esempio, se si conservano i backup solo per cinque giorni, è possibile ripristinare l'archivio dati esclusivamente ad un momento compreso in questo intervallo di cinque giorni.
Se si ha bisogno di sostituire uno dei computer in un data store cache tile a più computer, probabilmente sarà necessario riequilibrare le cache dei scene layer attraverso il data store cache tile. Parte di questo processo richiede di ripristinare il Data Store cache tile, impostando l'opzione replicatedata su true. Per istruzioni, consultare Ripristinare un Data Store.
L'utilità restoredatastore deve essere eseguita sul computer primario del data store relazionale. È possibile eseguire l'utilità su uno qualsiasi dei computer di un data store di cache, big data store spaziotemporale, archivio grafici o archivio oggetti.
Nota:
Per scoprire quali file di backup possono essere utilizzati per il ripristino, eseguire l'utilità listbackups.
Sintassi
restoredatastore [options]
La tabella seguente elenca le opzioni supportate:
| Opzione | Descrizione |
|---|---|
--store | Indica il tipo di data store da ripristinare. I valori validi sono relational, tileCache, spatiotemporal, graph o object. |
--target | I valori validi sono most-recent, il timestamp del file di backup nel formato <yyy-mm-dd-hh:mm:ss> o il nome del file di backup. Tutti i tipi di data store supportano il nome del file di backup con l'opzione target. Un timestamp e most-recent sono supportati solo per i data store relazionali. Quando si esegue il ripristino dopo un arresto anomalo o per spostare il data store relazionale, specificare--target most-recent. Se si esegue il ripristino di un data store relazionale a un momento preciso - cosa che richiede la configurazione del data store relazionale per consentire il ripristino point-in-time - è necessario specificare la data e l'ora (in UTC) a cui si desidera ripristinare il data store. Nel caso in cui si disponga invece di un file di backup specifico, fornire il nome di tale file di backup. Se non si specifica nulla, verrà ripristinato l'ultimo backup. |
--source-loc | Questa è la directory di primo livello in cui si trovano i file di backup che si desidera utilizzare per ripristinare il data store. Sarà il percorso di un percorso di condivisione file o il nome di un percorso di backup Amazon S3 o Azure o di un percorso di backup di archiviazione Blob. Suggerimento:Per ottenere le posizioni delle origini di backup, è possibile eseguire l'utilità configurebackuplocation con l'opzione --operation impostata su list. Se non è possibile eseguire l'utilità configurebackuplocation, ad esempio in caso di arresto anomalo del computer del data store mentre si esegue il ripristino in un nuovo computer per recuperare il data store, è possibile identificare la posizione della fonte di backup dalla presenza di un file denominato agsds_backup_sig. |
--bound | I valori validi sono true o false. L'opzione --bound è supportata solo con i data store relazionali. Per impostazione predefinita, si presume che si stia ripristinando il data store relazionale per lavorare con lo stesso sito GIS Server con cui si era registrati al momento della creazione del backup. Specificare solo --bound false per ripristinare il data store senza mantenere l'associazione con il sito del data store GIS Server. Se i servizi in hosting sono stati trasferiti in un altro GIS Server, è possibile impostare l'opzione --bound su falso e specificare l'URL del nuovo sito GIS Server con l'opzione --server-url al momento del ripristino. È inoltre possibile ripristinare il data store relazionale non vincolato dal proprio GIS Server come ultimo tentativo se il sitoGIS Server è stato perso e non è stato possibile recuperarlo; è possibile ripristinare il data store non vincolato e configurarlo con un nuovo sito federato GIS Server. In tal caso, però, i layer che utilizzavano i dati del Data Store non esisterebbero più. Sarebbe quindi necessario connettersi al database dell'archivio dati per estrarre i dati in un altro formato e ripubblicarli in ArcGIS Enterprise. |
--data-dir | Questa è la directory ArcGIS Data Store sul computer in cui si sta ripristinando il database. Utilizzare --data-dir solo se si effettua il ripristino del data store su un nuovo computer. Quando si effettua il ripristino del data store su un nuovo computer, è anche necessario specificare l'opzione --source-loc. |
--server-url | Se si specifica --bound true (o si omette l'opzione --bound) per mantenere il data store registrato con lo stesso sito GIS Server con cui era registrato quando è stato creato il backup, specificare l'URL di tale sitoGIS Server. Se si specifica --bound true e i servizi sono stati trasferiti in un nuovo Site di GIS Server, utilizzare l'opzione --server-url per specificare l'URL del nuovo Site di GIS Server. Se si specifica un nuovo URL del sito e non sono stati trasferiti i servizi su questo nuovo server, i dati del data store non saranno accessibili. |
--server-admin | Questa opzione è obbligatoria se si specifica --bound true o non si specifica l'opzione --bound. Fornire il nome utente dell' ArcGIS Server amministratore. |
--server-password | Questa opzione è obbligatoria se si specifica --bound true o non si specifica l'opzione --bound. Fornire la password per l'amministratore di ArcGIS Server. |
--loaddata | Supportato con i big data store cache tile e spaziotemporali e con gli archivi grafici e di oggetti. I valori validi sono true o false. Impostare questa opzione su false quando occorre ripristinare il Data store in un nuovo insieme di computer, ma i dati non possono essere contenuti nel primo computer. Questo consente di ripristinare lo schema del Data store, aggiungere altri computer al Data store per contenere tutti i dati, quindi eseguire nuovamente l'utilità restoredatastore con --loaddata impostato su true per ripristinare i dati. Per impostazione predefinita, questa opzione è impostata su true. |
--replicatedata | Supportato con i data store cache tile. I valori validi sono true o false. Impostare questa opzione su true quando è necessario riequilibrare i dati cache della scena dopo aver aggiunto un computer al Data Store cache tile. |
--mode | I valori validi sono primaryStandby o cluster. Quando si ripristina un data store cache tile su un nuovo computer, specificare se si desidera un data store cache tile a due computer per l'alta disponibilità (primaryStandby) o un data store cache tile multi-computer scalabile (cluster). |
--prompt | I valori validi sono yes o no. quando si esegue questa utilità, viene chiesto di confermare l'azione specificata. Se si automatizza l'uso di questa utilità, impostare l'opzione --prompt su no; altrimenti, lo script non procederà fino a quando non si risponderà al prompt. |
Esempi
In questo esempio, il backup più recente è una posizione di backup chiamata rdsbackups e verrà ripristinato nel Data Store esistente. Dal momento che il default store è di tipo relazionale, e rimane associato per impostazione predefinita al sitoGIS Server in cui è stato registrato, non è necessario specificare --store relational o --bound true. Tuttavia, è necessario specificare l'URL di GIS Server e le credenziali amministratore.
restoredatastore --target most-recent --source-loc rdsbackups --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
In questo esempio, un Data Store relazionale con abilitato il ripristino punto temporale viene ripristinato dal percorso di backup del Data Store relazionale predefinito su una condivisione di rete nello stato in cui si trovava alle ore 14.30 (UTC) del 17 luglio 2014.
restoredatastore --target 2014-07-17-14:30:00 --source-loc \\sharedserver\entbackups\relds --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
In questo esempio, il Data Store relazionale viene ripristinato su un nuovo computer utilizzando un file di backup denominato movedatastore. Quando si effettua il ripristino su un nuovo computer, è necessario specificare il percorso del file di backup e il percorso della nuova directory dei dati ArcGIS Data Store. Dal momento che i feature service hosted sono ancora in esecuzione sullo stesso sito GIS Server con cui è registrato il data store relazionale, --bound true non è necessario, ma l' URL di GIS Server e le credenziali di amministratore sono necessari.
restoredatastore --target movedatastore --source-loc \\buserver\data\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Nel seguente esempio, il Data Store cache tile viene ripristinato in un nuovo computer. Quando si effettua il ripristino su un nuovo computer, è necessario specificare il percorso del file di backup e il percorso della nuova directory dei dati ArcGIS Data Store. Poiché gli scene service sono ancora in esecuzione sullo stesso sito di GIS Servercon cui è registrato il Data Store cache tile, --bound true non è necessario, ma l'URL di GIS Server e le credenziali di amministratore sono necessari.
restoredatastore --store tilecache --source-loc \\buserver\scenedata\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $SAup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
In questo esempio, il Data Store cache tile viene ripristinato da un file chiamato mybackupfilename per riequilibrare i dati cache della scena dopo che un nuovo computer è stata aggiunto al Data Store cache tile.
restoredatastore --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Nel seguente esempio, si ripristina un file di backup di uno Spatiotemporal Big Data Store (bds1) da una posizione di backup denominata (awsloc).
restoredatastore --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
Per passaggi ed esempi di ripristino di uno Spatiotemporal Big Data Store dopo un guasto hardware, vedere Ripristinare un Data Store.
revokeconnection
Questa utilità viene utilizzata con i Data Store relazionali.
Se l'utilità allowconnection è stata utilizzata per consentire ad un altro client di connettersi direttamente al Data Store relazionale per un tempo limitato, è possibile revocare tale facoltà eseguendo l'utilità revokeconnection.
L'utilità revokeconnection può essere eseguita solo nel computer primario del Data Store relazionale.
Sintassi
revokeconnection <host name> <username> [<database>]
Esempio
In questo esempio l'archivio dati non accetterà ulteriori connessioni del computer workcom se l'utente che ha effettuato l'accesso al computer è hqo.n_1E7.
revokeconnection workcom hqo.n_1E7
unregisterdatastore
Questa utilità viene utilizzata con tutti i tipi di Data Store.
È possibile utilizzare l'utilità unregisterdatastore per effettuare le seguenti operazioni:
- Annullare la registrazione di un data store mono-computer di qualsiasi tipo dal sito di hosting GIS Server.
È necessario riavviare il server di hosting dopo aver annullato la registrazione di un archivio oggetti.
- Nei data store che funzionano in modalità primaria-standby, è possibile annullare la registrazione del computer primario dopo aver rimosso il computer in standby.
- Per i big data store spaziotemporali e i data store cache tile in esecuzione in modalità cluster, è possibile annullare la registrazione dell'ultimo computer dopo aver rimosso tutti gli altri computer del cluster.
Nota:
Se si annulla la registrazione del data store per rimuoverlo definitivamente dall'installazione, eliminare i layer in hosting che utilizzano i dati prima di annullare la registrazione del data store. Ad esempio, se i membri dell'organizzazione stavano testando i GeoAnalytics Tools e utilizzando il big data store spaziotemporale per i layer creati dagli strumenti, ma hanno stabilito che i layer avrebbero potuto essere archiviati nel data store relazionale, eliminare i feature layer spaziotemporali in hosting per il test prima di annullare la registrazione del big data store spaziotemporale. In caso contrario, rimarranno layer non utilizzabili nel portale e servizi non utilizzabili in esecuzione sul server di hosting.
Quando si annulla la registrazione di un computer dal data store, il sito di hosting GIS Server (o il sito Knowledge server di ArcGIS nel caso dei grafici conoscenza) non sarà più possibile connettersi a tale computer, e tutti i servizi che contenevano dati dal data store non registrato non funzioneranno più. Questa utilità, tuttavia, non elimina i dati; se il data store è ancora necessario, è possibile utilizzare l'utilità registerdatastore o configuredatastore per riaggiungerlo.
Sintassi
unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--prompt {yes | no}]
Se sono presenti più tipi di Data Store installati sullo stesso computer e si desidera annullare la registrazione di più di un Data Store alla volta, specificare ogni tipo di Data Store da eliminare separandoli con una virgola (senza spazi). Ad esempio, per annullare la registrazione di un Data Store relazionale e un Tile Cache Data Store, immettere --stores relational,tileCache.
Esempio
In questo caso, l'utilità unregisterdatastore viene eseguita per annullare la registrazione del Data Store relazionale e del Tile Cache Data Store nel Site di GIS Server. Viene restituito un prompt. Si tratta del funzionamento predefinito. Per eliminare il prompt specificare --prompt No.
unregisterdatastore --stores relational,tileCache You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
Questa utilità viene utilizzata con i Data Store relazionali.
ArcGIS Data Store mantiene i file di backup del Data Store relazione per sette giorni per impostazione predefinita. È possibile modificare la frequenza con cui i file di backup vengono rimossi dalla directory di backup eseguendo l'utilità updatebackupretaindays.
L'utilità updatebackupretaindays può essere eseguita solo nel computer primario del Data Store relazionale.
Sintassi
updatebackupretaindays <number of days>
Esempio
Nell'esempio seguente l'intervallo di conservazione dei file di backup viene modificato in 10 giorni:
updatebackupretaindays 10
updatebackupschedule
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Per impostazione predefinita, ArcGIS Data Store crea un backup completo del Data Store relazionale ogni quattro giorni. È possibile modificare la frequenza con cui i backup completi vengono creati eseguendo l'utilità updatebackupschedule.
Non ci sono backup automatici predefiniti per la tile cache o gli archivi di big data spazio-temporali o gli archivi di grafici. Per impostare una pianificazione dei backup automatici per uno Spatiotemporal Big Data Store, è prima necessario impostare un percorso di backup valido.
Specificare l'ora di inizio utilizzando il formato orario di 24 ore: ad esempio; 00:00:00 per la mezzanotte e 13:00:00 per le ore 13. Utilizzare l'opzione frequency per specificare il numero di giorni tra i backup. Per disattivare i backup automatici, impostare la frequenza su 0. Se si disattivano i backup automatici, accertarsi di eseguire l'utilità backupdatastore per creare i backup manualmente.
È possibile eseguire l'utilità updatebackupschedule sul computer primario del Data store relazionale. Lo strumento può essere eseguito in qualsiasi computer Tile Cache o Spatiotemporal Big Data store.
Per maggiori informazioni sui backup ArcGIS Data Store, vedere Gestisci ArcGIS Data Store backup.
Sintassi
updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--starttime <local server time>] --frequency <number of days>
Se non si specifica una nuova ora di inizio, l'impostazione dell'ora di inizio esistente non cambia. Se non si specifica un tipo di Data Store, si presume un Data Store relazionale.
Esempi
In questo esempio i backup completi di un Data Store relazionale verranno eseguiti alle 23 (ora del server locale) ogni 10 giorni:
updatebackupschedule --starttime 23:00:00 --frequency 10
In questo esempio, viene impostata una pianificazione dei backup per un Tile Cache Data Store. Dopo aver eseguito la copia di backup iniziale di tutti i database dei Data Store cache tile, ArcGIS Data Store copia i nuovi database dei Data Store creati nella posizione specificata mediante l'utilità configurebackuplocation ogni 14 giorni.
updatebackupschedule --store tileCache --frequency 14
updatesslcertificate
Questa utilità viene utilizzata con tutti i tipi di Data Store.
Questa utilità è deprecata in questa versione. Si consiglia di utilizzare invece l'utilità replacesslcertificate.
È possibile sostituire il certificato autofirmato utilizzato dal server web per autenticare la comunicazione tra il server di hosting e il data store e tra i computer del data store con un certificato verificato e firmato da un'autorità di certificazione (CA) o un certificato di dominio.
Questa utilità non sostituisce il certificato utilizzato per autenticare la comunicazione tramite le porte.
Sintassi
updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>
Esempio
Dopo aver ricevuto un file di certificato firmato dalla CA, eseguire updatesslcertificate per sostituire il certificato autofirmato ArcGIS Data Store utilizzato per la comunicazione con il server web.
updatesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" "mycacert"
upgradedatasource
Questa utilità viene utilizzata con Spatiotemporal Big Data Store.
A causa di un bug in 10.8.1, ArcGIS GeoEvent Server i map service che utilizzano l'aggregazione quadrata o esagonale non vengono renderizzati dopo il potenziamento alla versione 10.9 o superiore. Per correggere questo, eseguire l'utilità upgradedatasource per potenziare gli indici associati con i dati alla sorgente per questi GeoEvent Server servizi map.
Nessuno può accedere al map service durante l'aggiornamento degli indici.
L'utilità upgradedatasources può essere eseguita su qualsiasi dispositivo nello spatiotemporal big data store.
Sintassi
upgradedatasource [<service name>]
Esempi
In questo esempio, tutte le fonti delle GeoEvent Server map service sono aggiornati:
upgradedatasource
In questo esempio, l'utilità upgradedatasource aggiornerà gli indici utilizzati dalla GeoEvent Server ricognizione del map service. Il nome del servizio è stato determinato utilizzando l'utilità listdatasources.
upgradedatasource recon