home page

Generalità

Sitecopy è un tool per mantenere sincronizzati tramite protocolli FTP oppureWebDAV uno o più repository di file in remoto con il contenuto presente in locale. L'architettura è mirata a limitare le operazioni di trasferimento locale-> remoto allo stretto necessario. Una tipica applicazione è la manutenzione di siti web.

L'uso dell'utilità richiede la creazione da parte del sistemista di un file di configurazione che descrive i parametri dei siti gestiti. Il file può essere comune a più file. Sitecopy mantiene aggiornato un file xml in locale per ciascun sito, che contiene l'elenco dei file presenti in remoto. Per un corretto funzionamento si presuppone che non ci siano altri soggetti che modifichino il contenuto del sito remoto e che ogni modifica del contenuto in remoto venga fatta sempre attraverso sitecopy. In altre parole, non è adatto in caso di accessi alternativi sul repository remoto. In caso di disallineamenti c'è comunque modo di riaggiornare la lista

La sintassi generale dei comandi è:

sitecopy [options] [operation mode] sitename1 sitename2 ...

Per dettagli sulla sintassi vedere la documentazione dell'applicazione

Segue un esempio di configurazione nella versione Windows

Setup e manutenzione

• Va scelta una directory di lavoro (consigliabile sotto documenti). Può essere anche definita con la variabile globale HOME=… In essa occorre creare:
  • un file di configurazione, che definisce uno o più siti gestiti. Il default sarebbe .sitecopyrc ma non si riesce in Windows. Nell'esempio che segue è sitecopyrc.txt E' possibile, nei singoli comandi, specificare un nome e un percorso diversi relativo alla home con l'opzione --rcfile=<nomefile>. Senza path lo cerca nella direttrice corrente. Nel definire percorso nel file occorrono slash rovesciati e uno alla fine. Se la directory remota è la medesima di login, usare ~/ come specificazione del parametro remote che è necessario per le restanti opzioni vedere sotto al titolo site definition.
  • una cartella per conservare i file con l'elenco dei file dei repository remoti. Indicarla nei comandi come --storepath=
  • i batch dos per l'esecuzione

• All'interno del file di configurazione, ciascun sito gestito deve essere definito con un nome unico con il comando site=<sitename>. Questo nome del sito viene usato come argomento nei comandi. Per fare una operazione su tutti i siti si usa l'opzione –allsites

• Va fatta costruire al programma una lista dei file presenti in remoto. La prima volta o periodicamente si ottiene o si aggiornare la lista interrogando il remoto:

sitecopy --fetch <sitename> Nota: gli autori avvisano che il comando fetch non è del tutto affidabile per FTP. Comunque un eventuale errore del programma non porta perdite di dati in locale ma solo un aggiornamento incorretto sul remoto.

Finora lo scrivente non ha riscontrato casi di errore.

Ad esempio:

"c:\programmi\sitecopy\bin\sitecopy" --fetch --rcfile=sitecopyrc.txt --storepath=liste_remoto digilander_pankaldi

In alternativa, se il fetch non funziona, si può fare l'upload completo e far costruire la lista dei file in remoto prendendo a modello il sito locale con il comando catchup. L'uso di tale comando quindi equivale a dire a Sitecopy che locale e remoto sono allineati.

sitecopy --catchup <sitename>

• Per dire a sitecopy che il repository remoto è vuoto:

sitecopy --init <sitename>

• Per scaricare il contenuto del sito remoto spianando il contenuto del locale:

sitecopy --synch sitename

Attenzione: usare solo in caso di dati locali persi.

Ordinaria amministrazione

• Per allineare il repository remoto con le modifiche in locale:

sitecopy --update <sitename>.

• Per visualizzare le modifiche in locale dall'aggiornamento più recente senza aggiornare il remoto:

sitecopy <sitename>

Tali operazioni e la fetch non danneggiano il contenuto in locale. Se non ci sono modifiche, in fase di upload non si collega neanche.

Siti di riferimento

Il sito ufficiale di sitecopy è http://www.lyra.org/sitecopy/. Il tool con le istruzioni e il linguaggio in versione Windows 32 bit può essere scaricato all'indirizzo http://www.lyra.org/sitecopy/cygwin/index.html

home page