Skip To Content

ArcGIS Data Store riferimento utilità di comando

Le utilità di comando, installate insieme a ArcGIS Data Store, forniscono all'amministratore del Data Store gli strumenti necessari per gestire i Data Store. Questo argomento descrive le utilità, fornendone la sintassi ed alcuni esempi.

Tutte le utilità devono essere eseguite nel computer ArcGIS Data Store. Le utilità si trovano nella directory <ArcGIS Data Store installation directory>/datastore/tools.

Per ottenere un aiuto sulla sintassi, è possibile digitare il nome dell'utilità seguito da --help.

allowconnection

Utilità utilizzata con i Data Store relazionali.

Per impostazione predefinita, tutte le connessioni al Data Store vengono effettuate tramite il Site di GIS Server per motivi di sicurezza. Se si desidera aprire un Data Store relazionale per connettersi da un altro computer, è possibile utilizzare l'utilità di comando allowconnection.

L'utilità allowconnection può essere eseguita solo nel computer primario del Data Store relazionale.

Sintassi

allowconnection <host name> <user name> [<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.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio si autorizzano le connessioni al Data Store relazionale effettuate dall'utente gestito hqo.n_1E7 dal computer workcom.

./allowconnection.sh workcom hqo.n_1E7

backupdatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Qualora sia necessario creare manualmente un backup del Data Store relazionale tra due orari di backup pianificati, utilizzare l'utilità backupdatastore. Utilizzare questa utilità per creare manualmente un backup completo prima di aggiornare il Data Store o prima apportare un numero elevato di modifiche al Data Store.

La prima volta che si esegue l'utilità backupdatastore per un Tile Cache Data Store, 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à.

Quando viene eseguita l'utilità backupdatastore per uno Spatiotemporal Big Data Store per la prima volta, viene creato un backup completo. Dal momento che le dimensioni degli Spatiotemporal Big Data Store possono essere considerevoli, il successivo utilizzo dell'utilità backupdatastore crea un file di backup contenente solo le modifiche apportate successivamente al backup completo iniziale.

L'utilità backupdatastore può essere eseguita nel computer primario del Data Store relazionale o del Tile Cache Data Store. Questa utilità può essere eseguita da qualsiasi computer membro dello Spatiotemporal Big Data Store.

In ogni caso, assicurarsi che la posizione del backup sia abbastanza grande da contenere il volume dei dati. Per modificare le posizioni di backup dei Data Store, utilizzare l'utilità configurebackuplocation.

Sintassi

backupdatastore [<backup name>] [--store {relational|tileCache|spatiotemporal}] [--location <backup_arguments>] [--prompt <yes | no>]

Il parametro --location è supportato per Spatiotemporal Big Data Store e Data Store relazionali. Gli argomenti per questo parametro sono i seguenti e devono essere separati da punto e virgola (;):

  • type=: tipi validi sono fs (condivisione file), s3 (bucket S3 AWS) o azure (contenitore di archiviazione Azure Blob).
  • name=: se sono stati assegnati nomi alle posizioni di backup configurate per lo Spatiotemporal Big Data Store, è possibile usare il nome della posizione per specificare dove creare i file di backup quando si esegue l'utilità backupdatastore.
  • location=: se non si è specificato un nome per il percorso di backup, è necessario specificare type e location di backup. 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.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio viene creato un file di backup completo denominato project1bu nel percorso di backup specificato per il Data Store mediante l'utilità configurebackuplocation. Per impostazione predefinita, i backup vengono creati per i Data Store relazionali. Pertanto, nell'esempio seguente viene creato il backup per un Data Store relazionale.

./backupdatastore.sh project1bu
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 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.sh tcbu5 --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.sh 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

changebackuplocation

Utilità utilizzata con i Data Store relazionali.

Legacy:

L'utilità changebackuplocation è stata deprecata da Esri. È ancora presente per continuare a utilizzare gli script esistenti, ma è necessario iniziare a utilizzare l'utilità configurebackuplocation.

Per impostazione predefinita, i file di backup dei Data Store relazionali vengono memorizzati nello stesso computer che ospita il Data Store. È consigliabile trasferire i file di backup in un computer distinto per essere certi di potervi accedere se non è possibile accedere al computer in cui ArcGIS Data Store è installato.

Assicurarsi che l'account di accesso che esegue l'utilità changebackuplocation disponga delle autorizzazioni di lettura e scrittura per la directory condivisa.

L'utilità changebackuplocation si applica solo ai backup creati per un Data Store relazionale.

Sintassi

changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]

Specificare "true" per --is-shared-folder se il percorso di backup è un computer di rete condiviso. Per trasferire i file di backup esistenti nel nuovo percorso, specificare "vero" per --keep-old-backups.

changedatastoremode

Utilità utilizzata con i Data Store relazionali.

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.

L'utilità changedatastoremode può essere eseguita solo nel computer primario del Data Store relazionale.

Nota:

Se ArcGIS Data Store ha impostato la modalità di sola lettura per il Data Store relazionale in uso a causa dello spazio su disco insufficiente, anche i backup automatici vengono disabilitati per evitare un ulteriore utilizzo dello spazio. Pertanto, sarà necessario reimpostare la pianificazione dei backup automatici tramite l'utilità updatebackupschedule dopo aver reimpostato il Data Store relazionale sulla modalità di lettura/scrittura.

Sintassi

changedatastoremode readonly|readwrite [--prompt <yes|no>]

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, il Data Store viene reimpostato sulla modalità di lettura/scrittura, ovvero i client potranno riprendere ad eseguire attività quali, ad esempio, la pubblicazione di Feature Layer hosted nel portale, la modifica dei dati tramite un Feature Layer hosted oppure l'aggiunta di file CSV al Map Viewer.

./changedatastoremode.sh readwrite --prompt no

changedbproperties

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

L'utilità changedbproperties consente di modificare proprietà diverse in base al tipo di Data Store rispetto al quale viene eseguita.

Sintassi

changedbproperties --store <relational | tileCache | spatiotemporal> [configuration options]

Opzioni di configurazione supportate:

  • disk-threshold-readonly: questa impostazione controlla quando un Data Store relazionale viene impostato in modalità di sola lettura per evitare la perdita dei dati quando lo spazio su disco è insufficiente. Il valore predefinito per lo spazio su disco è pari a 1024 MB. Specificare le dimensioni in MB.
  • 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. È possibile utilizzare la proprietà --max-connections con l'utilità changedbproperties per modificare il numero di connessioni consentite. Al momento di stabilire quante connessioni richiede il proprio Data Store, è opportuno ricordare che possono essere necessarie fino a cinque connessioni per i processi interni di ArcGIS Data Store. Occorre inoltre considerare quante connessioni simultanee possono essere accettate dal computer che ospita ArcGIS Data Store senza diminuire le prestazioni. 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. Questo parametro non è supportato per Spatiotemporal Big Data Store o Tile Cache Data Store.

  • pitr: questa impostazione indica se ArcGIS Data Store creerà backup incrementali del Data Store relazionale, consentendo pertanto all'utente di ripristinare il Data Store relazionale ad un momento specifico. Input possibili per questa opzione sono enable o disable. Il ripristino punto temporale è disabilitato per impostazione predefinita.
    Nota:

    Abilitare il ripristino punto temporale se si utilizzerà l'utilità webgisdr per creare backup dell'installazione ArcGIS Enterprise.

  • enablessl: questo parametro controlla l’utilizzo del protocollo di protezione utilizzato quando si compila il Data Store tile cache. Il protocollo di protezione è stato modificato a partire da ArcGIS Data Store 10.6.1.

    ArcGIS Data Store 10.6.1 utilizza il protocollo Transport Layer Security (TLS) quando si compila il Data Store tile cache.

    Le opzioni supportate per il parametro enablessl a partire dalla versione 10.6.1 sono le seguenti:

    • admin: questa è l'opzione predefinita. Specificare admin per utilizzare Transport Layer Security quando si crea il contenitore per il Data Store tile cache.
    • data: specificare data per utilizzare Transport Layer Security quando si scrivono dati dello Scene layer nel Data Store tile cache.
    • admin,data: specificare admin,data per utilizzare Transport Layer Security quando si creano e scrivono dati nel Data Store tile cache.
    • none: specificare none per utilizzare la comunicazione HTTP dal server di hosting quando si crea o scrive sul Tile Cache Data Store.

    ArcGIS Data Store 10.6 utilizza il protocollo di protezione SSLv3 quando si compila il Data Store tile cache. Per utilizzare crittografia SSLv3, i computer presenti nel server di hosting deve disporre di SSLv3 abilitato. La maggior parte dei computer non dispongono di questa opzione abilitata, quindi è possibile configurare il Tile Cache Data Store per utilizzare la comunicazione HTTP con il server di hosting e, pertanto, non richiede che SSLv3 sia abilitato sui computer del server di hosting.

    Le opzioni supportate per il parametro enablessl a partire dalla versione 10.6 sono le seguenti:

    • admin: specificare admin per utilizzare la protezione SSLv3 quando si crea il contenitore per il Tile Cache Data Store. Ciò richiede che i computer del server di hosting dispongano di SSLv3 abilitato. Contattare l’amministratore o l’amministratore IT di ArcGIS Server per scoprire se questo protocollo è abilitato sui computer. Se l’amministratore desidera abilitare SSLv3 sui computer del server di hosting, indirizzarlo alle istruzioni di Problemi comuni e relative soluzioni nella Guida di ArcGIS Server.
    • data: specificare data per utilizzare la protezione SSLv3 quando si scrivono dati dello Scene layer nel Tile Cache Data Store. Ciò richiede che i computer del server di hosting dispongano di SSLv3 abilitato.
    • admin,data: specificare admin,data per utilizzare la protezione SSLv3 quando si creano e scrivono dati sul Tile Cache Data Store. Ciò richiede che i computer del server di hosting dispongano di SSLv3 abilitato.
    • none: specificare none per utilizzare la comunicazione HTTP dal server di hosting quando si crea o scrive sul Tile Cache Data Store. Utilizzare questa impostazione se viene visualizzato il messaggio Lo strumento di pubblicazione non è in grado di connettersi al Tile Cache Data Store. Ciò potrebbe essere dovuto a impostazioni di protezione che influiscono sulla comunicazione del server di hosting con il Tile Cache Data Store. nei registri dei server di hosting oppure se l’utente sa che i protocolli di protezione sul sito non consentono l'uso della sicurezza SSLv3.
  • 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 quando viene avviato. Questo parametro non è supportato per Data Store relazionali o cache tile.
  • rebalance: per impostazione predefinita, questo parametro è impostato su true. Questo significa che i dati in uno Spatiotemporal Big Data Store distribuiscono dati in altri computer se uno dei computer non è disponibile. Se occorre eseguire operazioni di manutenzione sul computer di uno Spatiotemporal Big Data Store, ad esempio l'aggiornamento, è possibile disattivare temporaneamente il ribilanciamento impostando questo parametro su false. Il ribilanciamento verrà sospeso per il periodo di tempo impostato per il parametro max-rebalance-off. Questo parametro si applica solo a Spatiotemporal Big Data Store.
    Legacy:

    In ArcGIS 10.4.x, questa opzione è reallocation.

  • max-rebalance-off: l'impostazione per questo parametro viene utilizzata quando si imposta il parametro rebalance su false. 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. Questo parametro si applica solo a Spatiotemporal Big Data Store.
    Legacy:

    In ArcGIS 10.4.x, questa opzione è max-allocation-off.

  • prompt: quando si esegue questa utilità, viene chiesto di confermare l'azione specificata. Se l'uso di questa utilità viene reso automatico, impostare il parametro prompt su false; in caso contrario, lo script non continuerà finché non si risponde alla richiesta.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, il numero massimo di connessioni consentite a un Data Store relazione è impostato su 100:

./changedbproperties.sh --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)?Yes

In questo esempio, viene utilizzata l'opzione max-rebalance-off per impostare su 15 il numero di minuti trascorsi i quali lo Spatiotemporal Big Data Store modificherà automaticamente rebalance su true.

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 15

In questo esempio, il parametro enablessl viene usato per configurare il Data Store tile cache per utilizzare Transport Layer Security quando viene creato il contenitore e quando si scrivono dati sul Data Store tile cache 10.6.1.

./changedbproperties.sh --store tileCache --enablessl admin,data

In questo esempio, il parametro enablessl viene utilizzato per abilitare la comunicazione HTTP con il server di hosting quando si compila il Data Store tile cache 10.6, consentendo agli utenti di pubblicare Scene Layer senza chiedere all'amministratore di ArcGIS Server di abilitare SSLv3 sui computer del server di hosting.

./changedbproperties.sh --store tileCache --enablessl none

changeloglocation

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Se non si desidera che il Data Store utilizzi il percorso predefinito del file di log degli errori di <ArcGIS Data Store installation directory>\arcgisdatastore\logs, è possibile eseguire l'utilità changeloglocation per creare i file di log degli errori in una directory diversa.

Sintassi

changeloglocation <directory path>

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, i file di log verranno creati nella directory locale, ../datastorefiles/logs.

./changeloglocation.sh '../datastorefiles/logs'

changenosqldslocation

Utilità 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.

Se si spostano i dati in una directory condivisa, è necessario concedere autorizzazioni di lettura e scrittura per la directory all'utente che esegue il processo (Linux) o il servizio (Windows) di ArcGIS Data Store.

Sintassi

changenosqldslocation <path> [--prompt {yes | no}]

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, i database che memorizzano le cache degli Scene Layer verranno creati in una directory condivisa denominata dstorecache sul computer server2.

changenosqldslocation /net/server2/dstorecache

changepassword

Utilità utilizzata con i Data Store relazionali.

ArcGIS Data Store genera in modo casuale nomi utente e password per gli account di database utilizzati per Data Store relazionali. Se il Site richiede l'impostazione di password personali, ottenere le password degli account di Data Store ed eseguire changepassword per reimpostare le password.

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 può essere eseguita solo nel computer primario del Data Store relazionale.

Sintassi

changepassword <user name> <new password> [--prompt {yes | no}]

Suggerimento:

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

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio la password dell'utente gwi_n2Te0 viene modificata in Phfl4mp!.

./changepassword.sh gwi_n2Te0 Phfl4mp
You are going to change the password for user gwi_n2Te0.
Do you want to continue (Yes or No)?Yes

changestaginglocation

Utilità utilizzata con i Data Store relazionali.

Quando si ripristina il Data Store relazionale, ArcGIS Data Store estrae i file di backup compressi in un percorso di archiviazione temporanea. Questo significa che è necessario disporre di un percorso di archiviazione temporanea per ospitare i dati non compressi. Se il Data Store relazionale contiene molti dati, è preferibile configurare un percorso di archiviazione temporanea separato e specificarlo per il ripristino.

Sintassi

changestaginglocation <directory path>

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, il percorso di archiviazione temporanea specificato è /net/sanmarcos/stage.

./changestaginglocation.sh /net/sanmarcos/stage

configurebackuplocation

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

L’utilità configurebackuplocation consente di specificare il percorso in cui ArcGIS Data Store scrive file di backup per backup programmati e backup creati con l’utilità backupdatastore. Questo comando consente inoltre di rimuovere la posizione di backup se i backup di ArcGIS Data Store non sono più necessari.

I Data Store relazionali e i Tile Cache Data Store vengono creati utilizzando una posizione di backup locale predefinita. Utilizzare l'opzione change per specificare un percorso di backup più sicuro in una directory condivisa remota per questi Data Store.

Gli Spatiotemporal Big Data Store non vengono creati utilizzando una posizione predefinita. Prima di iniziare a creare backup, è necessario eseguire 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 Azure Blob di Microsoft per questi backup. Non è possibile usare un'unità locale per i file di backup dello Spatiotemporal Big Data Store.

Per Spatiotemporal Big Data Store e Data Store relazionali, è possibile registrare un secondo percorso di backup per archiviare i backup completi creati con 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.

Sintassi

configurebackuplocation --location '<backup_location_arguments>' [options]

Le opzioni supportate sono le seguenti:

  • --location 'type=fs|s3|azure location=<backup_location> [name=<backup_location_name>] [username=<AWS_or_Azure_login>] [password=<AWS_or_Azure_account_password>]': Specificare la posizione in cui si desidera che ArcGIS Data Store archivi i file di backup. Per gli Spatiotemporal Big Data Store o per registrare un secondo percorso di backup per un Data Store relazionale, specificare i seguenti argomenti separati da un punto e virgola (;) e racchiudere l'intera stringa dell'argomento tra virgolette singole ('):
    • type=: Specificare che tipo di posizione usare per i backup. È possibile specificare s3 per archiviare i backup in un bucket Amazon S3, azure per archiviare i backup in un contenitore di archiviazione Azure Blob o fs per archiviare i backup in una condivisione di file (opzione predefinita).
    • location=: Per le condivisioni di file, specificare il percorso del file. Per bucket S3, specificare il nome 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 del backup è un percorso di file, come \\sharedserver_sharedfolders_datastorebackups, è possibile specificare un nome per questa posizione, come dsbackups. Quando si esegue l'utilità backupdatastore, listbackups o restoredatastore, è possibile fornire questo nome invece del percorso completo.

      Se non si fornisce un nome quando si configura la posizione del backup del Data Store, ArcGIS Data Store assegna un nome predefinito.

    • username=: richiesto se la posizione del backup è un bucket S3 o un contenitore di archiviazione Blob. Per i bucket S3, fornire l'ID della chiave di accesso per l'account AWS. Per i contenitori di archiviazione Azure Blob, fornire il nome utente di accesso per l'account di archiviazione Azure di Microsoft che può accedere al contenitore di archiviazione Blob.
    • password=: richiesto se la posizione del backup è un bucket S3 o un contenitore di archiviazione Blob. Per i bucket S3, fornire la chiave segreta per l'account AWS. Per i contenitori di archiviazione Azure Blob, fornire la password per l'accesso Azure specificato con l'argomento username.
  • --store relational|tileCache|spatiotemporal: il valore predefinito è relational.
  • --operation change|register|unregister|list|setdefault: il valore predefinito è change. Di seguito viene spiegata ciascuna opzione:
    • change: usarlo con Data Store relazionali e cache tile per specificare una posizione diversa del file condiviso per i file di backup. Il percorso impostato con l’opzione change è sempre il percorso di backup predefinito.
    • register: usarlo con Spatiotemporal Big Data Store per registrare un percorso del file di backup. La prima posizione del file di backup che si definisce viene impostata come posizione di backup predefinita. A partire dalla versione 10.6.1, utilizzare con Data Store relazionale per registrare un secondo percorso di backup per i backup manuali.
    • unregister: usarlo per annullare la registrazione di una posizione di backup per uno Spatiotemporal Big Data Store. A partire dalla versione 10.6.1, utilizzare per rimuovere un secondo percorso di backup da un Data Store relazionale.
    • list: elenca tutte le posizioni di backup registrate per uno Spatiotemporal Big Data Store. A partire dalla versione 10.6.1, elenca anche tutti i percorsi di backup per un Data Store relazionale.
    • setdefault: se si dispone di più posizioni di backup per uno Spatiotemporal Big Data Store, è possibile usare setdefault per specificare 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.
  • --prompt yes | no: il valore predefinito è yes.

A partire dalla versione 10.6, è possibile utilizzare le opzioni register, unregister, list e setdefault solo con Spatiotemporal Big Data Store. A partire dalla versione 10.6.1, è possibile utilizzare register, unregister e list con Data Store relazionali.

Se l'opzione --store non viene specificata, si presume l'opzione relational.

Nota:

L'opzione location è richiesta se si specifica l'opzione register o change.

Esempi

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.sh --operation change --store relational 
--location /net/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

In questo esempio, viene registrato un secondo percorso di backup su Azure per lo stesso Spatiotemporal Big Data Store.

./configurebackuplocation.sh --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

In questo esempio, viene registrata una posizione di backup in un'unità di rete per uno Spatiotemporal Big Data Store. Si assegna un nome, fshare, alla posizione di backup.

./configurebackuplocation.sh --operation register --store spatiotemporal 
--location 'type=fs;location=/net/sharedmachine/ge_bu;name=fshare'

In questo esempio, viene specificata una seconda posizione di backup su AWS per lo stesso Spatiotemporal Big Data Store. 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'

In questo esempio, viene specificata una terza posizione di backup su Azure per lo Spatiotemporal Big Data Store.

configurebackuplocation --operation register --store spatiotemporal 
--location 'type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount'

In questo esempio, il bucket S3 viene impostato come posizione di backup predefinita per lo Spatiotemporal Big Data Store.

configurebackuplocation --operation setdefault --store spatiotemporal 
--location 'name=awsloc'

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       /net/sharedmachine/ge_bu     false awsloc              s3       mybucket                     true
mazloc              azure    myblobs                      false

configuredatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Dopo l'installazione di ArcGIS Data Store, è possibile eseguire l'utilità configuredatastore per creare un Data Store e registrarlo in un site di GIS Server. È possibile creare i seguenti tipi di Data Store utilizzando questo comando:

  • Un Data Store per i dati dei Feature Layer hosted (Data Store relazionale)
  • Un Data Store per gli Scene Layer hosted (Tile Cache Data Store)
  • Un Data Store per i dati creati quando viene eseguito Strumenti GeoAnalytics o un Data Store per archiviare i dati di osservazione da un'istanza di ArcGIS GeoEvent Server (Spatiotemporal Big Data Store)

È anche possibile eseguire l'utilità configuredatastore per riconfigurare un Data Store dopo l'aggiornamento.

Sintassi

configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational|tileCache|spatiotemporal>] [--nosql-only true|false]

Il formato dell'URL di amministrazione di ArcGIS Server è https://gisserver.domain.com:6443. Anche se il site di GIS Server utilizza un Web Adaptor, è necessario specificare l'URL nel formato sopra indicato.

Specificare il nome utente e la password di un utente predefinito (non aziendale) che disponga dei privilegi di amministratore nel Site di GIS Server.

La directory dei dati è il percorso del computer locale in cui si desidera che vengano creati i file dell'archivio dati.

Anche se non è una procedura consigliata, è possibile configurare più di un tipo di Data Store sullo stesso computer specificando ogni tipo di Data Store desiderato separato da una virgola (senza spazi). Ad esempio, per configurare Data Store relazionali e Data Store tile cache sullo stesso computer con una directory data store condivisa, specificare --stores relational,tileCache. Esri consiglia di eseguire Spatiotemporal Big Data Store su computer separati da altri Data Store o software.

Legacy:

Nelle versioni precedenti, è necessario impostare l'opzione --nosql-only su true per creare un Data Store solo per i tile degli Scene Layer memorizzati nella cache. Questa opzione è ancora presente, pertanto gli script esistenti possono continuare a funzionare. Tutti i nuovi script devono impostare l’opzione --stores su tileCache.

Configurare un tipo specifico di Data Store

È possibile configurare un ArcGIS Data Store per i dati dei Feature Layer hosted specificando relational con l'opzione --stores.

Per pubblicare uno Scene Layer hosted, è necessario disporre di un Data Store per le cache delle scene e di un Data Store per i dati dei Feature Layer hosted perché ArcGIS crea un Feature Layer hosted, uno Scene Layer hosted e una cache delle scene quando viene pubblicato uno Scene Layer hosted. È possibile specificare relational,tileCache con l'opzione --stores per configurare entrambi i tipi di Data Store oppure specificare solo tileCache con l'opzione --stores e utilizzare il database gestito come Data Store per i dati dei Feature Layer hosted.

Se si utilizza ArcGIS GeoEvent Server e si desidera memorizzare grandi quantità di dati di osservazione che cambiano velocemente, creare uno Spatiotemporal Big Data Store specificando spatiotemporal con l'opzione --stores.

Per ulteriori informazioni sull'utilizzo di Spatiotemporal Big Data Store, vedere la Guida di ArcGIS GeoEvent Server.

Se si desidera utilizzare Strumenti GeoAnalytics nel Map Viewer oppure in ArcGIS Pro, creare uno Spatiotemporal Big Data Store specificando spatiotemporal con l'opzione --stores.

Osservare che se si creano script per la creazione di più computer Spatiotemporal Big Data Store, un computer Spatiotemporal Big Data Store deve essere configurato manualmente con il GIS Server prima di creare script per la creazione di computer Spatiotemporal Big Data Store aggiuntivi.

È possibile creare più di un tipo di Data Store oppure tutti e tre i tipi di Data Store sullo stesso computer. Tuttavia, Esri sconsiglia questa operazione perché i Data Store concorreranno congiuntamente all'uso della memoria e delle altre risorse. Ciò può influenzare negativamente le prestazioni e potrebbe causare l'arresto del funzionamento dei 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 in sostituzione dell'ArcGIS Data Store esistente su ogni computer del Data Store, è possibile accedere al computer del Data Store relazionale o cache tile primario ed eseguire l'utilità configuredatastore per terminare l'aggiornamento dei Data Store. Quando si esegue l'utilità dal computer primario, si aggiorna anche il computer relazionale o cache tile.

Se il computer primario contiene sia un Data Store relazionale sia un Tile Cache Data Store, specificare --stores relational,tileCache quando si esegue l'utilità configuredatastore e si aggiornano i Data Store relazionali e cache tile primari e di standby.

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.

Se non si è installata la nuova versione di ArcGIS Data Store su tutti i computer, non è possibile procedere con la configurazione.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio viene creato un Data Store per i dati dei Feature Layer hosted (Data Store relazionale). L'URL del site di 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 è /dstore/data.

./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational

deletebackup

Utilità utilizzata con i Data Store relazionali.

L'utilità deletebackup consente di eliminare i file di backup creati per i Data Store relazionali. Innanzitutto, eseguire l'utilità listbackups per visualizzare il nome e l'ora di creazione dei backup locali. A questo punto è possibile eseguire l'utilità deletebackup per eliminare i backup manuali di cui non si ha più bisogno.

Si possono eliminare esclusivamente i backup non necessari per ripristinare l'archivio dati. Ad esempio, non è possibile eliminare il backup completo più recente di un Data Store relazionale.

Sintassi

deletebackup <backup name> [--prompt <yes | no>]

Questa funzione è stata aggiunta a partire da 10.1.

./deletebackup.sh featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible.
Do you wish to continue (Yes or No)?yes
Operation completed successfully

describedatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

L'utilità describedatastore consente di visualizzare le seguenti informazioni relative a un'installazione di ArcGIS Data Store:

  • Numero di versione del software per l'installazione di ArcGIS Data Store
  • Il percorso di archiviazione temporanea utilizzato dal Data Store per il ripristino
  • Il percorso dei file di log per il Data Store
  • La quantità di spazio disponibile rimasta sul computer in cui è installato ArcGIS Data Store
  • La soglia dello spazio su disco libero in base alla quale verrà attivata la modalità di sola lettura di un data store relazionale e interrotti data store cache tile e spatiotemporal big data store
  • Percorsi dei backup utilizzati da ogni tipo di Data Store
  • Se il percorso di backup del Data Store relazionale o del Tile Cache Data Store è un'unità di rete
  • Frequenza di creazione di un backup del Data Store (Backup Schedule)
  • Numero di giorni di conservazione dei file di backup del Data Store relazionale
  • Se l'archivio dati è in esecuzione (Stato archivio dati)
  • La data e l'ora in cui il Data Store relazionale di standby o il Tile Cache Data Store di standby diventa il Data Store principale (Last Failover); non viene visualizzato se non si è mai verificato un failover
  • Il nome dei computer che contribuiscono al Data Store relazionale o al Tile Cache Data Store (Member machines)
  • Numero massimo di connessioni consentite a un Data Store relazionale
  • L'URL del Site di GIS Server in cui è registrato il Data Store (Owning System URL)
  • L'URL del portale che utilizza il Site di GIS Server come server di hosting (Portal URL)
  • Il numero di connessioni dei Feature Layer correnti al Data Store relazionale
  • Un elenco di tutti i computer che attualmente partecipano allo Spatiotemporal Big Data Store (Machines in spatiotemporal cluster)
  • Il computer all'interno dello Spatiotemporal Big Data Store attualmente definito come computer master (Current master machine in cluster)
  • Un elenco di tutti i computer inclusi nel cluster di Spatiotemporal Big Data Store (Registered spatiotemporal machines); visualizza tutti i computer inclusi nel cluster indipendentemente dal relativo stato

Sintassi

describedatastore

Questa funzione è stata aggiunta a partire da 10.1.

L'utilità describedatastore restituisce informazioni generali valide per tutti i Data Store in un computer, nonché sezioni distinte specifiche contenenti informazioni specifiche relative a ogni tipo di Data Store.

Anche se è probabile che siano presenti diversi Data Store in diversi computer, il seguente output fa riferimento a un computer contenente tutti e tre i tipi in modo da poter visualizzare le varie sezioni per ogni tipo:

./describedatastore.sh
General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....10.5.0.7777 Staging location............./arcgis/datastore/staging Log location................./arcgis/datastore/logs Free disk space..............174.00GB Threshold for READONLY mode..1024MB
Information for relational data store ds_sthiu0_5T
==============================================================
Backup location.........../net/nwshare/dsbackups Is backup folder shared...true Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31 Data store status.........Started Last failover.............20150130190334005 Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal Number of connections.....8 connection(s) to managed database
Information for tile cache data store ds_wztxj7um
==============================================================
Tile cache location......./arcgis/datastore/nosqldata Data location............./arcgis/datastore/nosqldata Data store status.........Started Last failover.............20150130190334005 Backup location.........../arcgis/datastore/backup Is backup folder shared...false Member machines...........MACHINE1.DOMAIN.COM Owning system URL.........https://gisserver.domain.com:6443/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Max rebalance off time..............60 minutes Automatic rebalance ................On Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM Current master machine in cluster...MACHINE1.DOMAIN.COM Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver.domain.com:6443/arcgis/admin

exportmanageddb

Legacy:

L'utilità exportmanageddb è stata deprecata da Esri alla versione 10.5.1. La funzionalità è stata incorporata nell'utilità backupdatastore. L'utilità exportmanageddb è ancora presente per consentire il funzionamento di script esistenti, ma occorre iniziare a utilizzare l'utilità backupdatastore per creare invece un file di backup, quindi utilizzare l'utilità restoredatastore per ripristinare il Data Store dal file di backup.

Utilità utilizzata con Data Store relazionali e Tile Cache Data Store.

L'utilità exportmanageddb di crea un file di dump del Data Store relazionale, i metadati del Data Store e tutti i database in cui vengono memorizzate le Tile Cache degli Scene Layer hosted. Esportare il Data Store se si desidera effettuare un backup da ripristinare in un'installazione di ArcGIS Data Store che si trova su un computer con un sistema operativo diverso o se la versione di ArcGIS Data Store è differente.

Accertarsi che i Feature Layer non vengano modificati né pubblicati sul portale prima dell'importazione del Data Store nel nuovo computer. Accertarsi inoltre che il percorso in cui esportare il Data Store contenga spazio di archiviazione sufficiente per il file di dump del Data Store relazionale e per le copie di tutti i database di Tile Cache degli Scene Layer hosted.

L'utilità exportmanageddb non esporta Spatiotemporal Big Data Store.

Sintassi

exportmanageddb <output location> <backup name> [options]

Il percorso di output è il percorso su disco in cui verranno creati la cartella (<backup name>) e i file esportati. È necessario disporre dell'accesso in scrittura per questo percorso.

Le opzioni supportate includono quanto segue:

  • [--stores {relational|tileCache}]: indica il tipo di Data Store da esportare. Se i Data Store relazionali e i Tile Cache Data Store vengono eseguiti sullo stesso computer e si desidera esportare entrambi i tipi di Data Store, specificarli entrambi separandoli con una virgola. Ad esempio, immettere --stores relational,tileCache. Se l'opzione --stores non viene specificata, si presume l'opzione relational.
  • [--include-tilecache <true|false>]: questa opzione è disponibile per garantire la compatibilità con le versioni precedenti. Se non si specifica l'opzione --stores oppure si specifica --stores relational, è possibile controllare se il Tile Cache Data Store è stato esportato o meno utilizzando questa opzione.
  • [--prompt {yes|no}]: determina se è necessario rispondere a una richiesta per eseguire l'utilità.

Questa funzione è stata aggiunta a partire da 10.1.

Nel seguente esempio, il file di dump, le copie dei database di cache degli Scene Layer hosted e i file del Data Store associati vengono posizionati in una directory di rete condivisa, denominata movedsfirstexp, su un server denominato backupserver.

./exportmanageddb.sh preupgradeexp /net/backupserver movedsfirstexp --stores relational,tileCache
You are attempting to back up database 'db_e3hsm'. This 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

importmanageddb

Utilità utilizzata con Data Store relazionali e Tile Cache Data Store.

Se è stato esportato un ArcGIS Data Store contenente database di Feature Layer hosted o di cache degli Scene Layer hosted (o entrambi), è possibile utilizzare l'utilità importmanageddb per ripristinare il Data Store. È possibile eseguire il ripristino in un computer ArcGIS Data Store aggiornato o in un'installazione ArcGIS Data Store su un computer con un sistema operativo diverso da quello del ArcGIS Data Store di origine.

Se si desidera registrare ArcGIS Data Store nello stesso Site di GIS Server, specificare --bound true e non specificare --server-url. Tenere presente che l'opzione --bound è impostata su true per default. Accertarsi di riavviare il Site di GIS Server dopo il ripristino.

Se si esegue il ripristino e si desidera registrare il Data Store in un nuovo Site di GIS Server, specificare --server-url quando si importa il Data Store.

Per impostazione predefinita, vengono importati il Data Store relazionale e tutti i database di cache degli Scene Layer hosted che costituiscono il Tile Cache Data Store nel file di esportazione. Se non si desidera includere i database di cache degli Scene layer hosted, impostare l'opzione --include-tilecache su false.

L'utilità importmanageddb non importa gli Spatiotemporal Big Data Store.

Sintassi

importmanageddb <source backup location> <backup name> [options]

Le opzioni supportate includono quanto segue:

  • [--server-url <ArcGIS Server URL registered with data store>] : se si specifica --bound true e i servizi sono già stati trasferiti in un nuovo Site di GIS Server, utilizzare l'opzione --server-url per specificare l'URL del nuovo Site di GIS Server. I dati del Data Store saranno accessibili solo se anche i servizi sono stati trasferiti nel nuovo server.
  • [--server-admin <user name of ArcGIS Server admin>]: questa opzione è richiesta se si specifica --bound true o non si specifica l’opzione --bound. Specificare il nome utente dell’amministratore di ArcGIS Server.
  • [--server-password <password of ArcGIS Server admin>]: questa opzione è richiesta se si specifica --bound true o non si specifica l’opzione --bound. Specificare la password dell'amministratore di ArcGIS Server.
  • [--data-dir <data store data directory>]: la directory ArcGIS Data Store. Per impostazione predefinita, questa è la directory ArcGIS Data Store dei Data Store attualmente registrati.
  • [--stores {relational|tileCache}]: indica il tipo di Data Store da importare. Se i Data Store relazionali e i Tile Cache Data Store vengono eseguiti sullo stesso computer e si desidera importare entrambi i tipi di Data Store, specificarli entrambi separandoli con una virgola. Ad esempio, immettere --stores relational,tileCache. Se l'opzione --stores non viene specificata, si presume l'opzione relational.
  • [--include-tilecache <true|false>]: questa opzione è disponibile per garantire la compatibilità con le versioni precedenti. Se non si specifica l'opzione --stores oppure si specifica --stores relational, è possibile controllare se il Tile Cache Data Store è stato ripristinato o meno utilizzando questa opzione.
  • [--bound {true|false}]
    • Se si specifica --bound true o non si specifica l'opzione --bound, occorre specificare l'URL di un sito di GIS Server con l'opzione --server-url e specificare le credenziali amministratore di ArcGIS Server con le opzioni --server-admin e --server-password. Se si sta eseguendo l'importazione nello stesso site di GIS Server con cui ArcGIS Data Store è stato registrato quando il Data Store è stato esportato, specificare l'URL di tale site di GIS Server e fornire il nome utente e la password dell'amministratore di ArcGIS Server. Per vincolare il Data Store a un nuovo Site di GIS Server, fornire l'URL e le credenziali amministratore di questo nuovo sito.
      Nota:

      Specificare solo le informazioni per un nuovo Site di GIS Server se i Web Service sono già stati spostati in questo nuovo Site di GIS Server.

    • Se il Data Store non utilizzerà più il precedente Site di GIS Server e tutti i servizi non sono ancora stati trasferiti nel nuovo sito di GIS Server, specificare --bound false. È quindi necessario eseguire l'utilità registerdatastore per configurare il Data Store nel nuovo Site di GIS Server dopo aver trasferito i servizi nel nuovo sito.
  • [--prompt {yes|no}]: determina se è necessario rispondere a una richiesta per eseguire l'utilità.

Questa funzione è stata aggiunta a partire da 10.1.

Nel seguente esempio, il Data Store gestito viene ripristinato in una nuova installazione di ArcGIS Data Store. Viene specificata la nuova directory dei dati di ArcGIS Data Store. Il Data Store è sempre vincolato al Site di GIS Server esistente, in modo che i Feature Layer hosted esistenti, gli Scene Layer e il Data Store continueranno a funzionare. Riavviare il Site di GIS Server per consentire ai Feature Layer e agli Scene Layer hosted di essere pubblicati in un nuovo computer.

./importmanageddb.sh /net/backupserver/expdir preupgradeexp --source-loc  --data-dir /usr/arcgis/datastore 
--server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s --bound true

In questo esempio, sia il Site di GIS Server che il Data Store relazionale sono stati trasferiti nei nuovi computer. I Web Service sono già stati trasferiti nel nuovo Site di GIS Server. Pertanto, viene specificato l'URL del nuovo Site assieme all'opzione --server-url. Il nome del backup è movedbexp e il backup viene memorizzato in /net/backupserver/expdir.

./importmanageddb.sh /net/backupserver/expdir movedbexp --data-dir /usr/arcgis/datastore 
--server-admin siteadmin --server-password SAup.4s --stores relational --bound true --server-url https:\\newgisserver.domain.com:6443

In questo esempio, i Web Service non sono stati trasferiti nel nuovo Site di GIS Server. I Data Store cache tile e relazionale funzioneranno solo dopo che i servizi sono stati trasferiti e dopo aver registrato i Data Store nel nuovo Site di GIS Server. Il nome del backup è movedsfirstexp e il backup viene memorizzato in /net/backupserver/expdir/movingexp2.

./importmanageddb.sh /net/backupserver/dbdump/movingexp2 movedsfirstexp --data-dir /usr/arcgis/datastore --stores relational,tileCache --bound false

listadminusers

Utilità utilizzata con i Data Store relazionali.

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.

Sintassi

listadminusers

Questa funzione è stata aggiunta a partire da 10.1.

./listadminusers.sh
Admin users for relational data store ds_abcd1234
=================================================
Database Admin User.... adm_11zyx / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb

listbackups

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store. Quando viene eseguita per i Data Store relazionali e i Tile Cache Data Store, l'utilità listbackups funziona solo sul computer primario del Data Store.

L'utilità listbackups restituisce i nomi dei file di backup e le posizioni nelle quali sono scritti. Restituisce inoltre lo stato del backup (se il backup è completo o meno), l'ora in cui è iniziato e se è stato creato manualmente mediante l'utilità backupdatastore o automaticamente da ArcGIS Data Store.

Quando si esegue l'utilità listbackups per gli Spatiotemporal Big Data Store, specificare la posizione di backup per la 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.

È possibile eseguire listbackups per verificare se un backup è terminato o è ancora in esecuzione e quanti sono i backup manuali presenti o per confermare il nome di un file prima di eseguire l'utilità deletebackup.

Sintassi

listbackups [--store <relational|tileCache|spatiotemporal>] [--location '<location_arguments>']

Se non si specifica un tipo di Data Store, l'utilità restituisce un elenco di backup per tutti i Data Store in esecuzione sul computer quando viene eseguita l'utilità.

Il parametro location è utilizzato con Spatiotemporal Big Data Store e Data Store relazionali. Gli argomenti sono i seguenti:

  • name=: 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=: il percorso alla directory del file condiviso, il nome del bucket S3 o il nome del contenitore di archiviazione Blob.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, vengono elencati i backup dello Spatiotemporal Big Data Store per la posizione di backup denominata sbdsbu:

./listbackups.sh --store spatiotemporal --location 'name=sbdsbu'
Backup_Name                      Status           Backup_Time         Mode
====================================================================================
backup1						                    BackupComplete   2016-07-11 09:47    manual
Backups located at: '/net/myserver.ntw.com/spatiotemporal'

listmanageduser

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big 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 inoltre il nome utente e la password del proprietario dei dati dei Tile Cache Data Store.

Sintassi

listmanageduser

Questa funzione è stata aggiunta a partire da 10.1.

Nell'esempio seguente, l'utilità listmanageduser viene eseguita su un computer primario contenente un Data Store relazionale e un Tile Cache Data Store.

./listmanageduser.sh

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.sh

Managed user for spatiotemporal big data store bds_6udbx4321
=================================================================
UserName     Password fmr_o1He3    5vZggkPbaw+T

registerdatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Il Data Store conserva le informazioni sulla denominazione dei computer che ospitano Site di GIS Server. Se si trasferisce il Site di GIS Server in nuovi computer (ad esempio, in caso di acquisto di nuovo hardware o di errore dei computer GIS Server esistenti), è necessario annullare la registrazione del Data Store nel Site di GIS Server per rimuovere queste informazioni. Dopo aver configurato GIS Server in uno o più computer nuovi, è possibile registrare il Data Store nel Site di GIS Server utilizzando l'utilità da riga di comando registerdatastore.

Tale utilità si utilizza per registrare il Data Store nello stesso Site di GIS Server in cui il Data Store 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 Site di GIS Server diverso, i Feature Layer hosted, le cache degli Scene Layer o gli archivi dati del servizio flusso non vengono ricreati.

L'utilità registerdatastore può essere eseguita nel computer primario del Data Store relazionale o del Tile Cache Data Store. Può essere eseguita in qualsiasi computer dello Spatiotemporal Big Data Store.

Sintassi

registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores <relational|tileCache|spatiotemporal>

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.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, viene registrato un Data Store relazionale in un Site di GIS Server il cui URL è https://gisserver.domain.com:6443. Il nome utente dell'amministratore principale del Site di ArcGIS Server è agsadmin e la password è Tan$p0n.

./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational

removemachine

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Utilizzare l'utilità removemachine per rimuovere uno dei seguenti elementi da un'installazione di ArcGIS Data Store:

  • Rimuovere un computer standby da un Data Store relazionale. Può essere eseguito su computer standby o dal computer primario se il computer standby non è disponibile.
  • Rimuovere un computer standby da un Tile Cache Data Store. Può essere eseguito su computer standby o dal computer primario se il computer standby non è disponibile.
  • Rimuovere un computer da un Spatiotemporal Big Data Store. Tenere presente che non è possibile eseguire removemachine su un Spatiotemporal Big Data Store composto da un solo computer.

Sintassi

removemachine <machine name> --store <relational|tileCache|spatiotemporal> [--force <true | false>] [--prompt <yes | no>]

--force: per impostazione predefinita, è impostato su false. Specificare true con questa opzione solo se il Site ArcGIS Server registrato non è disponibile.

--prompt: per impostazione predefinita, è impostato su yes. Se non si desidera confermare l'azione, specificare no con questa opzione.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio, il computer Spatiotemporal Big Data Store, gefour, viene rimosso dal Data Store.

./removemachine.sh gefour --store spatiotemporal

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.sh fsdata --store relational --force true

removestandbymachine

Legacy:

L'utilità removestandbymachine è stata deprecata da Esri. È ancora presente per continuare a utilizzare gli script esistenti, ma è necessario iniziare a utilizzare l'utilità removemachine.

È possibile utilizzare il comando REST di ArcGIS Server "remove " come amministratore del Site di ArcGIS Server per rimuovere un computer standby da un Data Store relazionale o cache tile. Se però il Site di GIS Server non è accessibile, non sarà possibile effettuare l'accesso come amministratore del Site per eseguire tale operazione. In tal caso, eseguire l'utilità removestandbymachine per rimuovere un computer di standby dall'archivio dati.

L'utilità removestandbymachine può essere eseguita solo sul computer standby di un Data Store relazionale o cache tile.

Sintassi

removestandbymachine <machine name> --store <relational|tileCache> [--prompt <yes | no>]

restoredatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

Qualora non sia più possibile accedere ai dati utilizzati dai Feature Layer hosted, dagli Scene Layer hosted o dai dati in tempo reale archiviati del portale, utilizzare i file di backup e l'utilità da riga di comando restoredatastore per ripristinare il Data Store.

Se non è possibile ripristinare il Data Store, installare ArcGIS Data Store in un nuovo computer, non configurare il Data Store e ripristinare l'ultimo backup nel nuovo computer.

Se si utilizza un Data Store relazionale e si desidera ripristinare i dati dei Feature Layer hosted ad un momento specifico nel passato, eseguire il ripristino sul Data Store esistente. È possibile solo eseguire il ripristino in uno stato del Data Store relazionale precedente per il quale siano disponibili 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.

L'utilità restoredatastore può essere eseguita nel computer primario del Data Store relazionale o del Tile Cache Data Store. Può essere eseguita in qualsiasi computer dello Spatiotemporal Big Data Store.

Sintassi

restoredatastore [options]

Le opzioni supportate sono le seguenti:

  • [--store {relational|tileCache|spatiotemporal}]
  • [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}]: questa opzione è supportata solo per i Data Store relazionali.
  • [--source-loc <location of source backup files>]: per Spatiotemporal Big Data Store, è possibile specificare un nome del percorso di backup o un percorso del bucket S3 o Azure con questa opzione. A partire dalla versione 10.6.1, è inoltre possibile utilizzare questa opzione con Data Store relazionali per specificare una condivisione file o un percorso di backup S3 o Azure. Se si specifica un percorso di backup secondario per il Data Store relazionale anziché il percorso predefinito, l'opzione --target deve essere impostata sul nome del file di backup. Per i Data Store cache tile, è possibile specificare solo il percorso ad una condivisione file e questa opzione è necessaria per i Data Store cache tile solo se si effettua il ripristino su un nuovo computer.
  • [--bound {true | false}]: l’opzione --bound è supportata solo con Data Store relazionali e Data Store tile cache.
  • [--data-dir <new data store directory>]: utilizzare --data-dir se si effettua il ripristino del Data Store su un nuovo computer. Quando si effettua il ripristino del Data Store su un nuovo computer, è necessario specificare l’opzione --source-loc.
  • [--server-url <ArcGIS Server URL registered with data store>]: se si specifica --bound true per mantenere il Data Store registrato con lo stesso Site di GIS Server con cui è stato registrato quando il backup è stato creato, specificare l'URL di tale Site di GIS 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 l’URL del nuovo sito e non si sono spostati i servizi su questo nuovo server, i dati del Data Store non saranno accessibili.
  • [--server-admin <user name of ArcGIS Server admin>]: questa opzione è richiesta se si specifica --bound true o non si specifica l’opzione --bound. Specificare il nome utente dell’amministratore di ArcGIS Server.
  • [--server-password <password of ArcGIS Server admin>]: questa opzione è richiesta se si specifica --bound true o non si specifica l’opzione --bound. Specificare la password dell'amministratore di ArcGIS Server.
  • [--loaddata {true | false}]: supportato solo con Spatiotemporal Big Data Store. Impostare questa opzione su false quando occorre ripristinare lo Spatiotemporal Big 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 allo Spatiotemporal Big 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.
  • [--prompt {yes | no}]

Quando si esegue un'operazione di ripristino dopo un arresto anomalo o allo scopo di trasferire il Data Store relazionale, specificare --target most-recent. In caso di ripristino di un Data Store relazionale ad un dato momento nel passato, specificare la data e l'ora (UTC) di riferimento per il ripristino del 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.

Per impostazione predefinita, il Data Store ripristinato viene associato (collegato) al relativo Site di GIS Server. Specificare solo --bound false se si desidera ripristinare il Data Store senza conservare l'associazione con il relativo Site di GIS Server. È preferibile eseguire questa procedura solo come ultima opzione nel caso in cui il precedente Site di GIS Server sia andato perduto e non sia stato possibile ripristinarlo; si potrebbe quindi ripristinare il Data Store senza conservare l'associazione e configurarlo in un nuovo Site federato di 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 nel portale.

Esempi

In questo esempio, il backup più recente proviene dal percorso di backup del Data Store relazionale predefinito e viene ripristinato nel Data Store esistente. Dal momento che il Data Store è di tipo relazionale e rimane associato per impostazione predefinita al Site di GIS 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.sh --target most-recent --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, un Data Store relazionale con abilitato il ripristino punto temporale viene ripristinato dal percorso di backup del Data Store relazionale predefinito nello stato in cui si trovava alle ore 14.30. del 17 luglio 2014.

./restoredatastore.sh --target 2014-07-17-14:30:00 --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 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. Poiché i feature service hosted sono ancora in esecuzione sullo stesso sito di GIS Server con cui è registrato il Data Store relazionale, --bound true non è necessario, ma l’URL di GIS Server e le credenziali amministratore sono necessari.

./restoredatastore.sh --target movedatastore --source-loc /net/buserver/data/backups --data-dir /usr/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

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 Server con cui è registrato il Data Store cache tile, --bound true non è necessario, ma l’URL di GIS Server e le credenziali amministratore sono necessari.

./restoredatastore.sh --source-loc /net/buserver/scenedata/backups --data-dir /usr/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

Nel seguente esempio, si ripristina un file di backup di uno Spatiotemporal Big Data Store (bds1) da una posizione di backup denominata (awsloc).

./restoredatastore.sh --target bds1 --store spatiotemporal --source-loc 'name=awsloc' 
--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

Per passaggi ed esempi di ripristino di uno Spatiotemporal Big Data Store dopo un guasto hardware, vedere Ripristinare un Data Store.

revokeconnection

Utilità 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> <user name> [<database>]

Questa funzione è stata aggiunta a partire da 10.1.

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.sh workcom bn0_3Wa.m hqo.n_1E7

unregisterdatastore

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big Data Store.

È inoltre possibile utilizzare l'utilità da riga di comando unregisterdatastore per eseguire le seguenti operazioni:

  • Annullare la registrazione del computer primario di un Data Store relazionale o un Tile Cache Data Store dal Site di GIS Server. Eseguire questa operazione solo se sono stati eliminati i Feature Layer, i Tile Layer e gli Scene layer hosted che utilizzano i dati nel Data Store. In caso contrario, rimarranno layer non utilizzabili nel portale e servizi non utilizzabili in esecuzione sul server di hosting.

    Tenere presente che se si dispone di un computer standby, è necessario rimuoverlo dal Data Store per poter annullare la registrazione del computer primario.

  • Annullare la registrazione di un Spatiotemporal Big Data Store su un computer singolo.

Se si decide di non utilizzare un Data Store o i servizi che dipendono da esso in futuro, è preferibile annullarne la registrazione nel Site di GIS Server. Quando si annulla la registrazione di un computer dal Data Store, GIS Server non è più in grado di collegarsi al computer e tutti i servizi che contenevano dati del Data Store non registrato non potranno più essere utilizzati. Questo comando non elimina i dati; se il Data Store è ancora richiesto, è possibile utilizzare l'utilità registerdatastore o configuredatastore per riaggiungerlo.

L'utilità unregisterdatastore può essere eseguita solo sul computer primario del Data Store relazionale o Tile Cache Data Store dopo aver eseguito removemachine per rimuovere il computer standby. L'utilità unregisterdatastore può essere eseguita solo per uno Spatiotemporal Big Data Store quando rimane solo un computer dopo aver eseguito removemachine per rimuovere tutti gli altri computer nello Spatiotemporal Big Data Store.

Sintassi

unregisterdatastore --stores <relational|tileCache|spatiotemporal> [--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.

Questa funzione è stata aggiunta a partire da 10.1.

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.sh --stores relational,tileCache
You are going to unregister the data store.
Do you want to continue (Yes or No)?Yes

updatebackupretaindays

Utilità 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>

Questa funzione è stata aggiunta a partire da 10.1.

Nell'esempio seguente l'intervallo di conservazione dei file di backup viene modificato in 10 giorni:

./updatebackupretaindays.sh 10

updatebackupschedule

Utilità utilizzata con Data Store relazionali, Data Store cache tile e Spatiotemporal Big 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 sono presenti backup automatici predefiniti per i Data Store cache tile o gli Spatiotemporal Big Data Store. Per impostare una pianificazione dei backup automatici per uno Spatiotemporal Big Data Store, è prima necessario impostare un percorso di backup valido.

Specificare l'ora utilizzando il formato orario di 24 ore: ad esempio; 00:00:00 per la mezzanotte e 13:00:00 le ore 13. Utilizzare l'opzione di frequenza 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 nel computer primario del Data Store relazionale o del Tile Cache Data Store. Lo strumento può essere eseguito in qualsiasi computer dello Spatiotemporal Big Data Store.

Sintassi

updatebackupschedule [--store relational|tileCache|spatiotemporal] [--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.

Questa funzione è stata aggiunta a partire da 10.1.

In questo esempio i backup completi di un Data Store relazionale verranno eseguiti alle 23. (ora del server locale) ogni 10 giorni:

./updatebackupschedule.sh --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 Tile Cache Data Store, ArcGIS Data Store copia i nuovi database dei Data Store creati nella posizione specificata mediante l'utilità configurebackuplocation ogni 14 giorni.

./updatebackupschedule.sh --store tileCache --frequency 14

updatelicense

Utilità utilizzata con i Data Store relazionali.

Se la licenza di ArcGIS Server è scaduta, è necessario aggiornarla sul Site ArcGIS Server. Le informazioni sulla licenza vengono archiviate anche nel Data Store relazionale ArcGIS Data Store; pertanto, una volta aggiornata la licenza del sito ArcGIS Server con cui il Data Store è configurato, è necessario aggiornare la licenza nel Data Store. A tal fine, eseguire l'utilità updatelicense dal computer su cui è installata le versione primaria di ArcGIS Data Store. Se si dispone di una versione di standby di ArcGIS Data Store, la licenza aggiornata verrà replicata anche su di essa.

Sintassi

updatelicense

Questa funzione è stata aggiunta a partire da 10.1.

Dopo aver aggiornato la licenza ArcGIS Server, eseguire l'utilità updatelicense per spostare la nuova licenza nel Data Store.

./updatelicense.sh

updatesslcertificate

Utilizzata con tutti i tipi di Data Store.

È possibile sostituire il certificato auto-firmato utilizzato per autenticare la comunicazione tra il server di hosting e il Data Store e tra i computer Data Store con un certificato verificato e firmato da un'autorità di certificazione o certificato di dominio.

Sintassi

updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>

Questa funzione è stata aggiunta a partire da 10.1.

Dopo la ricezione di un file di certificato firmato da un'autorità di certificazione, eseguire updatesslcertificate per sostituire il certificato auto-firmato ArcGIS Data Store.

./updatesslcertificate.sh /usr/files/mysignedcert.pfx ps4mycert dsmachinename