Hoe te om het Hulpmiddel te gebruiken VLT

Het hulpprogramma Jackrabbit FileVault (VLT) is een hulpprogramma dat is ontwikkeld door de Apache Foundation🔗 en waarmee de inhoud van een Jackrabbit/AEM-instantie wordt toegewezen aan uw bestandssysteem. Het hulpmiddel VLT heeft gelijkaardige functies zoals de cliënt van het broncontrolesysteem (zoals een cliënt van de Subversion (SVN)), die normale controle, controle en beheersverrichtingen, evenals configuratieopties voor flexibele vertegenwoordiging van de projectinhoud verstrekken.

U voert het gereedschap VLT uit vanaf de opdrachtregel. In dit document wordt beschreven hoe u het gereedschap kunt gebruiken, inclusief hoe u aan de slag kunt en hoe u hulp kunt krijgen, en een lijst met alle opdrachten en beschikbare opties.

Concepten en architectuur

Zie de pagina FileVault Overview en Vault FS van de officiële Apache Jackrabbit FileVault-documentatie voor een uitgebreid overzicht van de concepten en structuur van het FileVault-gereedschap.

Aan de slag met VLT

Als u VLT wilt gaan gebruiken, moet u het volgende doen:

1. Installeer VLT, werk omgevingsvariabelen bij en werk algemene genegeerde subversiebestanden bij.
2. Stel de AEM opslagplaats in (als u dat nog niet hebt gedaan).
3. Bekijk de AEM opslagplaats.
4. Synchroniseren met de repository.
5. Test of de synchronisatie heeft gewerkt.

Het gereedschap VLT installeren

Als u het gereedschap VLT wilt gebruiken, moet u het eerst installeren. Het is niet standaard geïnstalleerd omdat het een aanvullend gereedschap is. Daarnaast moet u de omgevingsvariabele van uw systeem instellen.

1. Download het archiefbestand FileVault van de gegevensopslagruimte voor artefacten.

   OPMERKING

   De bron van het hulpmiddel VLT is beschikbaar op GitHub.

   1. Extraheer het archief.

2. Voeg <archive-dir>/vault-cli-<version>/bin aan uw milieu PATH toe zodat de beveldossiers vlt of vlt.bat worden betreden zoals aangewezen. Bijvoorbeeld:

   <aem-installation-dir>/crx-quickstart/opt/helpers/vault-cli-3.1.16/bin>

3. Open een opdrachtregelshell en voer vlt --help uit. Zorg ervoor de output aan het volgende hulpscherm gelijkaardig is:

   vlt --help
   -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   Jackrabbit FileVault [version 3.1.16] Copyright 2013 by Apache Software Foundation. See LICENSE.txt for more information.
   -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   Usage:
     vlt [options] <command> [arg1 [arg2 [arg3] ..]]
   -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   
   Global options:
   
     -Xjcrlog <arg>           Extended JcrLog options (omit argument for help)
     -Xdavex <arg>            Extended JCR remoting options (omit argument for help)
     --credentials <arg>      The default credentials to use
     --update-credentials     if present the credentials-to-host list is updated in the ~/.vault/auth.xml
     --config <arg>           The JcrFs config to use
     -v (--verbose)           verbose output
     -q (--quiet)             print as little as possible
     --version                print the version information and exit
     --log-level <level>      the log4j log level
     -h (--help) <command>    print this help
   

Nadat u deze hebt geïnstalleerd, moet u algemene genegeerde subversiebestanden bijwerken. Bewerk uw SVN-instellingen en voeg het volgende toe:

[miscellany]
### Set global-ignores to a set of whitespace-delimited globs
### which Subversion will ignore in its 'status' output, and
### while importing or adding files and directories.
global-ignores = .vlt

Het vormen van het Eind van het Karakter van de Lijn

VLT verwerkt automatisch het einde van regel (EOF) volgens de volgende regels:

• lijnen van dossiers die op het eind van Vensters met een CRLF worden gecontroleerd
• Bestandsregels die zijn uitgecheckt aan het Linux/Unix-uiteinde met een LF
• regels bestanden die worden toegewezen aan de repository eindigen met een LF

Om ervoor te zorgen dat VLT en SVN configuratie aanpassen, zou u svn:eol-style bezit aan native voor de uitbreiding van de dossiers moeten plaatsen die in de bewaarplaats worden opgeslagen. Bewerk uw SVN-instellingen en voeg het volgende toe:

[auto-props]
*.css = svn:eol-style=native
*.cnd = svn:eol-style=native
*.java = svn:eol-style=native
*.js = svn:eol-style=native
*.json = svn:eol-style=native
*.xjson = svn:eol-style=native
*.jsp = svn:eol-style=native
*.txt = svn:eol-style=native
*.html = svn:eol-style=native
*.xml = svn:eol-style=native
*.properties = svn:eol-style=native

Bewaarplaats uitchecken

Ontdek de opslagplaats met behulp van het broncontrolesysteem. Typ in svn bijvoorbeeld het volgende (vervang de URI en het pad door de repository):

svn co https://svn.server.com/repos/myproject

Synchroniseren met de gegevensopslagruimte

U moet het bestand synchroniseren met de opslagplaats. Dit doet u als volgt:

1. Navigeer op de opdrachtregel naar content/jcr_root.

2. Ontdek de opslagplaats door het volgende te typen (uw poortnummer te vervangen door 4502 en uw beheerderswachtwoorden):

   vlt --credentials admin:admin co --force http://localhost:4502/crx
   

   OPMERKING

   De referenties hoeven slechts eenmaal te worden opgegeven bij het eerste afrekenen. Zij zullen dan in uw huisfolder binnen .vault/auth.xml worden opgeslagen.

Testen of de synchronisatie heeft gewerkt

Nadat u de opslagplaats hebt uitgecheckt en gesynchroniseerd, moet u testen of alle functies correct werken. Een gemakkelijke manier om dit te doen is een .jsp dossier uit te geven en te zien of uw veranderingen na het bevestigen van de veranderingen worden weerspiegeld.

De synchronisatie testen:

1. Ga naar .../jcr_content/libs/foundation/components/text.
2. Bewerk iets in text.jsp.
3. De gewijzigde bestanden bekijken door vlt st te typen
4. De wijzigingen bekijken door vlt diff text.jsp te typen
5. De wijzigingen vastleggen: vlt ci test.jsp.
6. Laad een pagina met een tekstcomponent opnieuw en controleer of de wijzigingen aanwezig zijn.

Hulp krijgen met het Hulpmiddel VLT

Na het installeren van het hulpmiddel VLT, kunt u tot zijn dossier van de Hulp van de bevellijn toegang hebben:

vlt --help
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Jackrabbit FileVault [version 3.1.16] Copyright 2013 by Apache Software Foundation. See LICENSE.txt for more information.
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Usage:
  vlt [options] <command> [arg1 [arg2 [arg3] ..]]
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Global options:
  -Xjcrlog <arg>           Extended JcrLog options (omit argument for help)
  -Xdavex <arg>            Extended JCR remoting options (omit argument for help)
  --credentials <arg>      The default credentials to use
  --update-credentials     if present the credentials-to-host list is updated in the ~/.vault/auth.xml
  --config <arg>           The JcrFs config to use
  -v (--verbose)           verbose output
  -q (--quiet)             print as little as possible
  --version                print the version information and exit
  --log-level <level>      the log4j log level
  -h (--help) <command>    print this help
Commands:
  export                   Export the Vault filesystem
  import                   Import a Vault filesystem
  checkout (co)            Checkout a Vault file system
  status (st)              Print the status of working copy files and directories.
  update (up)              Bring changes from the repository into the working copy.
  info                     Displays information about a local file.
  commit (ci)              Send changes from your working copy to the repository.
  revert (rev)             Restore pristine working copy file (undo most local edits).
  resolved (res)           Remove 'conflicted' state on working copy files or directories.
  propget (pg)             Print the value of a property on files or directories.
  proplist (pl)            Print the properties on files or directories.
  propset (ps)             Set the value of a property on files or directories.
  add                      Put files and directories under version control.
  delete (del,rm)          Remove files and directories from version control.
  diff (di)                Display the differences between two paths.
  rcp                      Remote copy of repository content.
  sync                     Control vault sync service
  console                  Run an interactive console
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Voor hulp op een bepaald bevel, typ het hulpbevel dat door de naam van het bevel wordt gevolgd. Bijvoorbeeld:

vlt --help export
Usage:
 export -v|-t <arg>|-p <uri> <jcr-path> <local-path>

Description:
  Export the Vault filesystem mounted at <uri> to the local filesystem at <local-path>. An optional <jcr-path> can be specified in order to export just a sub tree.
  Example:
    vlt export http://localhost:4502/crx /apps/geometrixx myproject

Options:
  -v (--verbose)          verbose output
  -t (--type) <arg>       specifies the export type. either 'platform' or 'jar'.
  -p (--prune-missing)    specifies if missing local files should be deleted.
  <uri>                   mountpoint uri
  <jcr-path>              the jcr path
  <local-path>            the local path

Gemeenschappelijke Taken die in VLT worden uitgevoerd

Hier volgen enkele algemene taken die in VLT worden uitgevoerd. Voor gedetailleerde informatie over elk bevel zie individuele commands.

Een substructuur uitchecken

Als u alleen een substructuur van de repository wilt uitchecken, bijvoorbeeld /apps/geometrixx, kunt u dit doen door het volgende te typen:

vlt co http://localhost:4502/crx/-/jcr:root/apps/geometrixx geo

Als u dit doet, wordt er een nieuwe exporthoofdmap geo gemaakt met een map META-INF en jcr_root en worden alle bestanden onder /apps/geometrixx in geo/jcr_root geplaatst.

Uitchecken via filters uitvoeren

Als u een bestaand werkruimtefilter hebt en u het voor controle wilt gebruiken, kunt u of eerst de META-INF/vault folder tot stand brengen en het filter daar plaatsen, of het specificeren op de bevellijn als volgt:

$ vlt co --filter filter.xml http://localhost:4502/crx/-/jcr:root geo

Een voorbeeldfilter:

<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
    <filter root="/etc/designs/geometrixx" />
    <filter root="/apps/geometrixx"/>
</workspaceFilter>

Importeren/exporteren gebruiken in plaats van .vlt-besturingselement

U kunt inhoud importeren en exporteren tussen een JCR-opslagplaats en het lokale bestandssysteem zonder besturingsbestanden te gebruiken.

Inhoud importeren en exporteren zonder .vlt-besturingselement te gebruiken:

1. Stel aanvankelijk de opslagplaats in:

   $ cd /projects
   $ svn mkdir https://svn.server.com/repos/myproject
   $ svn co https://svn.server.com/repos/myproject
   $ vlt export -v http://localhost:4502/crx /apps/geometrixx geometrixx
   $ cd geometrixx/
   $ svn add META-INF/ jcr_root/
   $ svn ci
   

2. Wijzig de externe kopie en werk de JCR bij:

   $ cd /projects/geometrixx
   $ vlt -v import http://localhost:4502/crx . /
   

3. Wijzig de externe kopie en werk de bestandsserver bij:

   $ cd /projects/geometrixx
   $ vlt export -v http://localhost:4502/crx /apps/geometrixx .
   $ svn st
   M      META-INF/vault/properties.xml
   M      jcr_root/apps/geometrixx/components/contentpage/.content.xml
   $ svn ci
   

VLT gebruiken

Om bevelen in VLT uit te geven, typ het volgende bij de bevellijn:

vlt [options] <command> [arg1 [arg2 [arg3] ..]]

Opties en opdrachten worden in de volgende secties uitgebreid beschreven.

Algemene VLT-opties

Hieronder volgt een lijst met VLT-opties, die beschikbaar zijn voor alle opdrachten. Zie de afzonderlijke opdrachten voor meer informatie over extra beschikbare opties.

Optie	Beschrijving
-Xjcrlog <arg>	Uitgebreide JcrLog-opties
-Xdavex <arg>	Uitgebreide opties voor JCR-verwijdering
--credentials <arg>	De standaardreferenties die moeten worden gebruikt
--config <arg>	De JcrFs-configuratie die moet worden gebruikt
-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
--version	Drukt de versieinformatie en uitgang VLT af
--log-level <level>	Geeft het logniveau aan, bijvoorbeeld het logniveau log4j.
-h (--help) <command>	Hiermee wordt de Help voor die opdracht afgedrukt

VLT-opdrachten

In de volgende tabel worden alle beschikbare VLT-opdrachten beschreven. Zie de afzonderlijke opdrachten voor meer informatie over syntaxis, beschikbare opties en voorbeelden.

Opdracht	Afkorting van opdracht	Beschrijving
export		Exporteert van een JCR-opslagplaats (vault file system) naar het lokale bestandssysteem zonder controlebestanden.
import		Hiermee wordt een lokaal bestandssysteem geïmporteerd naar een JCR-opslagplaats (vault file system).
checkout	co	Hiermee wordt een Vault-bestandssysteem uitgecheckt. Gebruik dit voor een eerste JCR-opslagplaats naar het lokale bestandssysteem. (Opmerking: U moet de repository eerst uitchecken in subversion.)
analyze		Hiermee analyseert u pakketten.
status	st	Hiermee wordt de status van bestanden en mappen met werkkopieën afgedrukt.
update	up	Hiermee importeert u wijzigingen uit de opslagplaats in de werkkopie.
info		Geeft informatie weer over een lokaal bestand.
commit	ci	Hiermee verzendt u wijzigingen van uw werkkopie naar de opslagplaats.
revert	rev	Hiermee herstelt u de oorspronkelijke staat van het bestand met de werkkopie en maakt u de meeste lokale bewerkingen ongedaan.
resolved	res	Hiermee verwijdert u een conflicterende status uit werkkopiebestanden of -mappen.
propget	pg	Hiermee wordt de waarde van een eigenschap afgedrukt op bestanden of mappen.
proplist	pl	Hiermee worden de eigenschappen afgedrukt op bestanden of mappen.
propset	ps	Hiermee wordt de waarde van een eigenschap voor bestanden of mappen ingesteld.
add		Hiermee plaatst u bestanden en mappen onder versiebeheer.
delete	del or rm	Hiermee verwijdert u bestanden en mappen uit versiebeheer.
diff	di	Hiermee geeft u de verschillen tussen twee paden weer.
console		Hiermee wordt een interactieve console uitgevoerd.
rcp		Kopieert een knooppuntenstructuur van de ene externe opslagplaats naar een andere.
sync		Hiermee kunt u de vault sync-service besturen.

exporteren

Exporteert het Vault-bestandssysteem dat op <uri> is geïnstalleerd naar het lokale bestandssysteem op <local-path>. U kunt een optionele <jcr-path> opgeven om alleen een substructuur te exporteren.

Syntaxis

export -v|-t <arg>|-p <uri> <jcr-path> <local-path>

Opties

-v (--verbose)	uitgebreide uitvoer
-t (--type) <arg>	Hiermee geeft u het exporttype op: platform of jar.
-p (--prune-missing)	geeft aan of ontbrekende lokale bestanden moeten worden verwijderd
<uri>	uri van het montagepunt
<jcrPath>	JCR-pad
<localPath>	lokaal pad

Voorbeelden

vlt export http://localhost:4502/crx /apps/geometrixx myproject

Importeren

Hiermee wordt het lokale bestandssysteem geïmporteerd (vanaf <local-path> naar het vault-bestandssysteem op <uri>. U kunt een <jcr-path> opgeven als importbasis. Als --sync wordt gespecificeerd, worden de ingevoerde dossiers automatisch gezet onder controle van de kluis.

Syntaxis

import -v|-s <uri> <local-path> <jcr-path>

Opties

-v (--verbose)	uitgebreide uitvoer
-s (-- sync)	plaatst de lokale bestanden onder de vault-controle
<uri>	uri van het montagepunt
<jcrPath>	JCR-pad
<localPath>	lokaal pad

Voorbeelden

vlt import http://localhost:4502/crx . /

Afhandeling (co)

Voert een eerste uitchecking uit van een JCR-opslagplaats naar het lokale bestandssysteem vanaf <uri> naar het lokale bestandssysteem op <local-path>. U kunt ook een <jcrPath>-argument toevoegen om een submap van de externe boomstructuur uit te checken. Werkruimtefilters kunnen worden opgegeven die naar de map META-INF worden gekopieerd.

Syntaxis

checkout --force|-v|-q|-f <file> <uri> <jcrPath> <localPath>

Opties

--force	forceert uitchecken om lokale bestanden te overschrijven als deze al bestaan
-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
-f (--filter) <file>	Hiermee worden automatische filters opgegeven als er geen zijn gedefinieerd
<uri>	uri van het montagepunt
<jcrPath>	(optioneel) extern pad
<localPath>	(optioneel) lokaal pad

Voorbeelden

JCR-verwijdering gebruiken:

vlt --credentials admin:admin co http://localhost:8080/crx/server/crx.default/jcr_root/

Met de standaardwerkruimte:

vlt --credentials admin:admin co http://localhost:8080/crx/server/-/jcr_root/

Als URI onvolledig is, wordt deze uitgebreid:

vlt --credentials admin:admin co http://localhost:8080/crx

analyseren

Hiermee analyseert u pakketten.

Syntaxis

analyze -l <format>|-v|-q <localPaths1> [<localPaths2> ...]

Opties

-l (--linkFormat) <format>	printf-indeling voor hotfix-koppelingen (naam,id), bijvoorbeeld `[CQ520_HF_%s
-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
<localPaths> [<localPaths> ...]	lokaal pad

Status

Hiermee wordt de status van bestanden en mappen met werkkopieën afgedrukt.

Als --show-update wordt gespecificeerd, wordt elk dossier gecontroleerd tegen de verre versie. De tweede letter geeft vervolgens aan welke actie door een updatebewerking wordt uitgevoerd.

Syntaxis

status -v|-q|-u|-N <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
-u (--show-update)	updategegevens weergeven
-N (--non-recursive)	werkt op één directory
<file> [<file> ...]	bestand of map om de status weer te geven

bijwerken

Hiermee worden wijzigingen van de opslagplaats naar de werkkopie gekopieerd.

Syntaxis

update -v|-q|--force|-N <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
--force	forceert het overschrijven van lokale bestanden
-N (--non-recursive)	werkt op één directory
<file> [<file> ...]	bestand of map dat moet worden bijgewerkt

Info

Geeft informatie weer over een lokaal bestand.

Syntaxis

info -v|-q|-R <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief
<file> [<file> ...]	bestand of map om informatie weer te geven

vastleggen

Hiermee verzendt u wijzigingen van uw werkkopie naar de opslagplaats.

Syntaxis

commit -v|-q|--force|-N <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
--force	forceert het toezeggen zelfs als het verre exemplaar wordt gewijzigd
-N (--non-recursive)	werkt op één directory
<file> [<file> ...]	bestand of map om vast te leggen

herstellen

Hiermee herstelt u het bestand met de werkkopie naar de oorspronkelijke staat en maakt u de meeste lokale bewerkingen ongedaan.

Syntaxis

revert -q|-R <file1> [<file2> ...]

Opties

-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief afneemt
<file> [<file> ...]	bestand of map om vast te leggen

Opgelost

Hiermee verwijdert u de status conflicted uit werkkopiebestanden of -mappen.

Syntaxis

resolved -q|-R|--force <file1> [<file2> ...]

Opties

-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief afneemt
--force	lost op, zelfs als er conflicttellers zijn
<file> [<file> ...]	bestand of map om op te lossen

Propget

Hiermee wordt de waarde van een eigenschap afgedrukt op bestanden of mappen.

Syntaxis

propget -q|-R <propname> <file1> [<file2> ...]

Opties

-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief afneemt
<propname>	de eigenschapsnaam
<file> [<file> ...]	bestand of map om de eigenschap op te halen

Proplist

Hiermee worden de eigenschappen afgedrukt op bestanden of mappen.

Syntaxis

proplist -q|-R <file1> [<file2> ...]

Opties

-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief afneemt
<file> [<file> ...]	bestand of map om de eigenschappen van

Propset

Hiermee wordt de waarde van een eigenschap voor bestanden of mappen ingesteld.

Syntaxis

propset -q|-R <propname> <propval> <file1> [<file2> ...]

Opties

-q (--quiet)	zo weinig mogelijk afdrukken
-R (--recursive)	recursief afneemt
<propname>	de eigenschapsnaam
<propval>	de eigenschapswaarde
<file> [<file> ...]	bestand of map waarin de eigenschap moet worden ingesteld

Toevoegen

Hiermee plaatst u bestanden en mappen onder versiebeheer, zodat deze naast de opslagplaats worden gepland. Deze worden toegevoegd bij volgende commit.

Syntaxis

add -v|-q|-N|--force <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
-N (--non-recursive)	werkt op één directory
--force	de operatie moet worden uitgevoerd
<file> [<file> ...]	lokaal bestand of lokale map dat moet worden toegevoegd

Verwijderen

Hiermee verwijdert u bestanden en mappen uit versiebeheer.

Syntaxis

delete -v|-q|--force <file1> [<file2> ...]

Opties

-v (--verbose)	uitgebreide uitvoer
-q (--quiet)	zo weinig mogelijk afdrukken
--force	de operatie moet worden uitgevoerd
<file> [<file> ...]	lokaal te verwijderen bestand of map

Diff

Hiermee geeft u de verschillen tussen twee paden weer.

Syntaxis

diff -N <file1> [<file2> ...]

Opties

-N (--non-recursive)	werkt op één directory
<file> [<file> ...]	bestand of map om de verschillen weer te geven

Console

Hiermee wordt een interactieve console uitgevoerd.

Syntaxis

console -F <file>

Opties

-F (--console-settings) <file>	geeft het bestand met consolemontages aan. Het standaardbestand is console.properties.

Rcp

Kopieert een knooppuntenstructuur van de ene externe opslagplaats naar een andere. <src> wijst naar het bronknooppunt en <dst> geeft het doelpad aan, waar het bovenliggende knooppunt moet bestaan. Rcp verwerkt de knopen door de gegevens te stromen.

Syntaxis

rcp -q|-r|-b <size>|-t <seconds>|-u|-n|-e <arg1> [<arg2> ...] <src> <dst>

Opties

-q (--quiet)	Drukt zo weinig mogelijk af.
-r (--recursive)	Vervalt recursief.
-b (--batchSize) <size>	Aantal knooppunten dat moet worden verwerkt vóór een tussentijdse opslag.
-t (--throttle) <seconds>	Aantal seconden dat moet worden gewacht na een tussentijdse opslag.
-u (--update)	Bestaande knooppunten overschrijven/verwijderen.
-n (--newer)	De eigenschappen lastModified voor update respecteren.
-e (--exclude) <arg> [<arg> ...]	Regexp van uitgesloten bronpaden.
<src>	Het opslagplaats adres van de bronboom.
<dst>	Het opslagplaats adres van de bestemmingsknoop.

Voorbeelden

vlt rcp http://localhost:4502/crx/-/jcr:root/content  https://admin:admin@localhost:4503/crx/-/jcr:root/content_copy

Synchroniseren

Hiermee kunt u de vault sync-service besturen. Zonder argumenten probeert deze opdracht de huidige werkmap onder synchronisatiecontrole te zetten. Indien uitgevoerd binnen een vlt controle, gebruikt het de respectieve filter en gastheer om de synchronisatie te vormen. Als deze buiten een vlt-uitchecking wordt uitgevoerd, wordt de huidige map alleen geregistreerd voor synchronisatie als de map leeg is.

Syntaxis

sync -v|--force|-u <uri> <command> <localPath>

Opties

-v (--verbose)	uitgebreide uitvoer.
--force	bepaalde opdrachten uitvoeren.
-u (--uri) <uri>	geeft de URI van de synchronisatiehost aan.
<command>	uit te voeren synchronisatieopdracht.
<localPath>	lokale map die moet worden gesynchroniseerd.

Statuscodes

De statuscodes die door VLT worden gebruikt zijn:

• ' Geen wijzigingen
• 'A' toegevoegd
• C-conflict
• 'D' Verwijderd
• 'I' genegeerd
• 'M' gewijzigd
• "R" vervangen
• '?' item bevindt zich niet onder versiebeheer
• '!' item ontbreekt (verwijderd door niet-svn-opdracht) of is onvolledig
• '~' versioned item geblokkeerd door een ander item

FileVault-synchronisatie instellen

De vault sync-service wordt gebruikt om inhoud in de opslagplaats te synchroniseren met een lokale bestandssysteemweergave en andersom. Dit wordt bereikt door een OSGi-service te installeren die luistert naar wijzigingen in de opslagplaats en de inhoud van het bestandssysteem periodiek zal scannen. Het gebruikt het zelfde rangschikkingsformaat zoals vault voor het in kaart brengen van de inhoud van de bewaarplaats aan schijf.

De service installeren met vlt

Met de opdracht vlt sync install kunt u de bundel en configuratie van de kluissynchronisatieservice automatisch installeren.

De bundel wordt geïnstalleerd onder /libs/crx/vault/install en de config knoop wordt gecreeerd bij /libs/crx/vault/com.day.jcr.sync.impl.VaultSyncServiceImpl. Aanvankelijk wordt de dienst toegelaten maar geen synchronisatiewortels worden gevormd.

In het volgende voorbeeld wordt de synchronisatieservice geïnstalleerd naar de CRX-instantie die toegankelijk is voor de opgegeven uri.

$ vlt --credentials admin:admin sync --uri http://localhost:4502/crx install

De servicestatus weergeven

De opdracht status kan worden gebruikt om informatie weer te geven over de actieve synchronisatieservice. "

$ vlt sync status --uri http://localhost:4502/crx
Connecting via JCR remoting to http://localhost:4502/crx/server
Listing sync status for http://localhost:4502/crx/server/-/jcr:root
- Sync service is enabled.
- No sync directories configured.

Een synchronisatiemap toevoegen

Met de opdracht register voegt u een map toe die u wilt synchroniseren met de configuratie.

$ vlt sync register
Connecting via JCR remoting to http://localhost:4502/crx/server
Added new sync directory: /tmp/workspace/vltsync/jcr_root

Een synchronisatiemap verwijderen

De opdracht unregister wordt gebruikt om een map te verwijderen die uit de configuratie moet worden gesynchroniseerd.

$  vlt sync unregister
Connecting via JCR remoting to http://localhost:4502/crx/server
Removed sync directory: /tmp/workspace/vltsync/jcr_root

Synchronisatie configureren

Serviceconfiguratie

Zodra de dienst in werking stelt kan het met de volgende parameters worden gevormd:

• vault.sync.syncroots: Een of meer lokale bestandsysteempaden die de synchronisatiebasis definiëren.

• vault.sync.fscheckinterval: Frequentie (in seconden) waarvan het bestandssysteem op wijzigingen moet worden gescand. De standaardwaarde is 5 seconden.

• vault.sync.enabled: Algemene vlag die de dienst toelaat/onbruikbaar maakt.

Configuratie van mappen synchroniseren

In elke synchronisatiemap worden configuratie en status in drie bestanden opgeslagen:

• .vlt-sync-config.properties: configuratiebestand.

• .vlt-sync.log: logbestand dat informatie bevat over de bewerkingen die tijdens het synchroniseren zijn uitgevoerd.

• .vlt-sync-filter.xml: filters die definiëren welke delen van de opslagplaats worden gesynchroniseerd. De indeling van dit bestand wordt beschreven in de sectie Uitchecken via filters uitvoeren.

Met het bestand .vlt-sync-config.properties kunt u de volgende eigenschappen configureren:

​​disabledHiermee schakelt u de synchronisatie in of uit. Deze parameter is standaard ingesteld op false om synchronisatie toe te staan.

sync- onceAls de volgende scan niet leeg is, wordt de map in de gegeven richting gesynchroniseerd, dan wordt de parameter gewist. Twee waarden worden ondersteund:

• JCR2FS: exporteert alle inhoud in de JCR-opslagplaats en schrijft naar de lokale schijf.
• FS2JCR: Hiermee importeert u alle inhoud van de schijf naar de JCR-opslagplaats.

sync- logDefinieert de logbestandsnaam. De standaardwaarde is .vlt-sync.log

VLT-sync gebruiken voor ontwikkeling

Ga als volgt te werk als u een ontwikkelomgeving wilt instellen op basis van een synchronisatiemap:

1. De gegevensopslagruimte uitchecken via de opdrachtregel voor vlt:

   $ vlt --credentials admin:admin co --force http://localhost:4502/crx dev
   

   OPMERKING

   Met filters kunt u alleen de juiste paden uitchecken. Zie de sectie Uitgefilterde uitchecken voor meer informatie.

2. Ga naar de hoofdmap van uw werkkopie:

   $ cd dev/jcr_root/
   

3. Installeer de synchronisatieservice in uw opslagplaats:

   $ vlt sync install
   Connecting via JCR remoting to http://localhost:4502/crx/server
   Preparing to install vault-sync-2.4.24.jar...
   Updated bundle: vault-sync-2.4.24.jar
   Created new config at /libs/crx/vault/config/com.day.jcr.sync.impl.VaultSyncServiceImpl
   

4. De synchronisatieservice initialiseren:

   $ vlt sync
   Connecting via JCR remoting to http://localhost:4502/crx/server
   Starting initialization of sync service in existing vlt checkout /Users/colligno/Applications/cq5/vltsync/sandbox/dev/jcr_root for http://localhost:4502/crx/server/-/jcr:root
   Added new sync directory: /Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root
   
   The directory /Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root is now enabled for syncing.
   You might perform a 'sync-once' by setting the
   appropriate flag in the /Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root/.vlt-sync-config.properties file.
   

5. Bewerk het .vlt-sync-config.properties verborgen bestand en configureer synchronisatie om de inhoud van uw opslagplaats te synchroniseren:

   sync-once=JCR2FS
   

   OPMERKING

   Deze stap downloadt de hele opslagplaats volgens uw filterconfiguratie.

6. Controleer het logbestand .vlt-sync.log om de voortgang te zien:

   ***
   30.04.2017 14:39:10 A file:///Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root/apps/geometrixx-outdoors/src/core/src/main/java/info/geometrixx/outdoors/
   30.04.2017 14:39:10 A file:///Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root/apps/geometrixx-outdoors/src/core/src/main/java/info/geometrixx/outdoors/core/
   30.04.2017 14:39:10 A file:///Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root/apps/geometrixx-outdoors/src/core/src/main/java/info/geometrixx/outdoors/core/product/
   30.04.2017 14:39:10 A file:///Users/trushton/Applications/aem/vltsync/sandbox/dev/jcr_root/apps/geometrixx-outdoors/src/core/src/main/java/info/geometrixx/outdoors/core/product/GeoProduct.java
   ***
   

Uw lokale map is nu gesynchroniseerd met de opslagplaats. De synchronisatie is bidirectioneel, zodat de wijziging van de opslagplaats wordt toegepast op uw lokale synchronisatiemap en andersom.