AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.
Het Jackrabbit FileVault-hulpprogramma (VLT) is een hulpprogramma dat is ontwikkeld door De Apache Foundation die de inhoud van een instantie Jackrabbit/AEM aan uw bestandssysteem toewijst. 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 verstrekt.
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 beschikbaar opties.
Zie de Overzicht van FileVult en Vault FS pagina van de ambtenaar Apache Jackrabbit FileVult-documentatie voor een grondig overzicht van de concepten en de structuur van het hulpmiddel FileVult.
Als u VLT wilt gaan gebruiken, moet u het volgende doen:
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.
Download het archiefbestand FileVault van de Opslagplaats voor vervormingen.
De bron van het gereedschap VLT is beschikbaar op GitHub.
Toevoegen <archive-dir>/vault-cli-<version>/bin
naar uw omgeving PATH
zodat de opdrachtbestanden vlt
of vlt.bat
indien van toepassing toegankelijk zijn. Bijvoorbeeld:
<aem-installation-dir>/crx-quickstart/opt/helpers/vault-cli-3.1.16/bin>
Een opdrachtregelshell openen en uitvoeren vlt --help
. 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
VLT verwerkt automatisch het einde van regel (EOF) volgens de volgende regels:
CRLF
LF
LF
Om ervoor te zorgen dat VLT en de configuratie SVN aanpassen, zou u opstelling moeten zijn svn:eol-style
eigenschap aan native
voor de extensie van de bestanden die in de opslagplaats zijn 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
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
U moet het bestand synchroniseren met de opslagplaats. Dit doet u als volgt:
Navigeer op de opdrachtregel naar content/jcr_root
.
Ontdek de opslagplaats door het volgende te typen (vervang uw poortnummer door 4502 en uw beheerderswachtwoorden):
vlt --credentials admin:admin co --force http://localhost:4502/crx
De referenties hoeven slechts eenmaal te worden opgegeven bij het eerste afrekenen. Zij zullen dan in uw huisfolder binnen worden opgeslagen .vault/auth.xml
.
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 en controleer of uw wijzigingen worden doorgevoerd nadat u de wijzigingen hebt doorgevoerd.
De synchronisatie testen:
.../jcr_content/libs/foundation/components/text
.text.jsp
.vlt st
vlt diff text.jsp
vlt ci test.jsp
.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
Hier volgen enkele algemene taken die in VLT worden uitgevoerd. Voor gedetailleerde informatie over elk bevel zie individueel opdrachten.
Als u bijvoorbeeld alleen een substructuur van de repository wilt uitchecken, /apps/geometrixx
, kunt u dit doen door het volgende te typen:
vlt co http://localhost:4502/crx/-/jcr:root/apps/geometrixx geo
Hiermee maakt u een nieuwe exportbasis geo
met een META-INF
en jcr_root
en plaatst alle bestanden hieronder /apps/geometrixx
in geo/jcr_root
.
Als u een bestaand werkruimtefilter hebt en u het voor controle wilt gebruiken, kunt u of eerst creëren META-INF/vault
en plaats het filter daar, of specificeer het 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>
U kunt inhoud importeren en exporteren tussen een JCR-opslagplaats en het lokale bestandssysteem zonder besturingsbestanden te gebruiken.
Inhoud importeren en exporteren zonder deze te gebruiken .vlt
besturingselement:
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
Wijzig de externe kopie en werk de JCR bij:
$ cd /projects/geometrixx
$ vlt -v import http://localhost:4502/crx . /
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
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.
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 |
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 of 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. |
Hiermee wordt het Vault-bestandssysteem geëxporteerd dat is gemonteerd op <uri> naar het lokale bestandssysteem op <local-path>. Een optioneel <jcr-path> kan worden opgegeven om alleen een subboomstructuur te exporteren.
export -v|-t <arg>|-p <uri> <jcr-path> <local-path>
-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 |
vlt export http://localhost:4502/crx /apps/geometrixx myproject
Hiermee wordt het lokale bestandssysteem geïmporteerd (vanaf <local-path>
naar het vault-bestandssysteem op <uri>
. U kunt een <jcr-path>
als importbasis. Indien --sync
worden opgegeven, worden de geïmporteerde bestanden automatisch onder controle van de vault geplaatst.
import -v|-s <uri> <local-path> <jcr-path>
-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 |
vlt import http://localhost:4502/crx . /
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 om een submap van de externe boomstructuur uit te checken. Werkruimtefilters kunnen worden opgegeven die naar de map META-INF worden gekopieerd.
checkout --force|-v|-q|-f <file> <uri> <jcrPath> <localPath>
--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 |
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
Hiermee analyseert u pakketten.
analyze -l <format>|-v|-q <localPaths1> [<localPaths2> ...]
-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 |
Hiermee wordt de status van bestanden en mappen met werkkopieën afgedrukt.
Indien --show-update
wordt opgegeven, wordt elk bestand gecontroleerd op basis van de externe versie. De tweede letter geeft vervolgens aan welke actie door een updatebewerking wordt uitgevoerd.
status -v|-q|-u|-N <file1> [<file2> ...]
-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 |
Hiermee worden wijzigingen van de opslagplaats naar de werkkopie gekopieerd.
update -v|-q|--force|-N <file1> [<file2> ...]
-v (--verbose) |
uitgebreide uitvoer |
-q (--quiet) |
zo weinig mogelijk afdrukken |
--force |
overschrijven van lokale bestanden forceren |
-N (--non-recursive) |
werkt op één directory |
<file> [<file> ...] |
bestand of map dat moet worden bijgewerkt |
Geeft informatie weer over een lokaal bestand.
info -v|-q|-R <file1> [<file2> ...]
-v (--verbose) |
uitgebreide uitvoer |
-q (--quiet) |
zo weinig mogelijk afdrukken |
-R (--recursive) |
recursief |
<file> [<file> ...] |
bestand of map om informatie weer te geven |
Hiermee verzendt u wijzigingen van uw werkkopie naar de opslagplaats.
commit -v|-q|--force|-N <file1> [<file2> ...]
-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 |
Hiermee herstelt u het bestand met de werkkopie naar de oorspronkelijke staat en maakt u de meeste lokale bewerkingen ongedaan.
revert -q|-R <file1> [<file2> ...]
-q (--quiet) |
zo weinig mogelijk afdrukken |
-R (--recursive) |
recursief afneemt |
<file> [<file> ...] |
bestand of map om vast te leggen |
Verwijderen tegenstrijdig status van het werken van kopieerbestanden of -mappen.
Met deze opdracht worden conflicten niet semantisch opgelost of worden conflictiemarkeringen verwijderd. het verwijdert alleen de conflicterende artefactbestanden en staat toe dat PATH opnieuw wordt toegewezen.
resolved -q|-R|--force <file1> [<file2> ...]
-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 |
Hiermee wordt de waarde van een eigenschap afgedrukt op bestanden of mappen.
propget -q|-R <propname> <file1> [<file2> ...]
-q (--quiet) |
zo weinig mogelijk afdrukken |
-R (--recursive) |
recursief afneemt |
<propname> |
de eigenschapsnaam |
<file> [<file> ...] |
bestand of map om de eigenschap op te halen |
Hiermee worden de eigenschappen afgedrukt op bestanden of mappen.
proplist -q|-R <file1> [<file2> ...]
-q (--quiet) |
zo weinig mogelijk afdrukken |
-R (--recursive) |
recursief afneemt |
<file> [<file> ...] |
bestand of map om de eigenschappen van |
Hiermee wordt de waarde van een eigenschap voor bestanden of mappen ingesteld.
VLT herkent de volgende speciale versioned eigenschappen:
vlt:mime-type
Het mimetype van het bestand. Wordt gebruikt om te bepalen of het bestand moet worden samengevoegd. Een mimetype dat begint met 'text/' (of een afwezig mimetype) wordt behandeld als tekst. Al het andere wordt als binair beschouwd.
propset -q|-R <propname> <propval> <file1> [<file2> ...]
-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 |
Hiermee plaatst u bestanden en mappen onder versiebeheer, zodat deze naast de opslagplaats worden gepland. Deze worden toegevoegd bij volgende commit.
add -v|-q|-N|--force <file1> [<file2> ...]
-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 |
Hiermee verwijdert u bestanden en mappen uit versiebeheer.
delete -v|-q|--force <file1> [<file2> ...]
-v (--verbose) |
uitgebreide uitvoer |
-q (--quiet) |
zo weinig mogelijk afdrukken |
--force |
de operatie moet worden uitgevoerd |
<file> [<file> ...] |
lokaal te verwijderen bestand of map |
Hiermee geeft u de verschillen tussen twee paden weer.
diff -N <file1> [<file2> ...]
-N (--non-recursive) |
werkt op één directory |
<file> [<file> ...] |
bestand of map om de verschillen weer te geven |
Hiermee wordt een interactieve console uitgevoerd.
console -F <file>
-F (--console-settings) <file> |
geeft het bestand met consolemontages aan. Het standaardbestand is console.properties. |
Kopieert een knooppuntenstructuur van de ene externe opslagplaats naar een andere. <src>
verwijst naar het bronknooppunt en <dst>
Geeft het doelpad aan, waar het bovenliggende knooppunt moet bestaan. Rcp verwerkt de knopen door de gegevens te stromen.
rcp -q|-r|-b <size>|-t <seconds>|-u|-n|-e <arg1> [<arg2> ...] <src> <dst>
-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. |
vlt rcp http://localhost:4502/crx/-/jcr:root/content https://admin:admin@localhost:4503/crx/-/jcr:root/content_copy
De --exclude
de opties moeten door een andere optie worden gevolgd alvorens <src>
en <dst>
argumenten. Bijvoorbeeld:
vlt rcp -e ".*\.txt" -r
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.
sync -v|--force|-u <uri> <command> <localPath>
-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. |
De statuscodes die door VLT worden gebruikt zijn:
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 vault sync-service is een ontwikkelingsprogramma en het is zeer ontmoedigend om het op een productief systeem te gebruiken. Merk ook op dat de dienst slechts met het lokale filesystem kan synchroniseren en niet voor verre ontwikkeling kan worden gebruikt.
De vlt sync install
kunt u gebruiken om de bundel en configuratie van de vault sync-service automatisch te installeren.
De bundel wordt hieronder geïnstalleerd /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 status
kunt u gebruiken 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.
De status
bevel haalt geen levende gegevens van de dienst maar eerder leest de configuratie bij /libs/crx/vault/com.day.jcr.sync.impl.VaultSyncServiceImpl
.
De register
wordt gebruikt om een omslag toe te voegen om aan de configuratie te synchroniseren.
$ vlt sync register
Connecting via JCR remoting to http://localhost:4502/crx/server
Added new sync directory: /tmp/workspace/vltsync/jcr_root
De register
het bevel brengt geen synchronisatie teweeg tot u vormt sync-once
configuratie.
De unregister
wordt gebruikt om een omslag te verwijderen om uit de configuratie te synchroniseren.
$ vlt sync unregister
Connecting via JCR remoting to http://localhost:4502/crx/server
Removed sync directory: /tmp/workspace/vltsync/jcr_root
U moet de registratie van een synchronisatiemap ongedaan maken voordat u de map zelf verwijdert.
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.
De dienst kan met de console van het Web of a worden gevormd sling:OsgiConfig
node (met de naam com.day.jcr.sync.impl.VaultSyncServiceImpl
) in de opslagplaats.
Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie OSGi configureren voor volledige informatie.
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 door de Een gefilterde uitchecking uitvoeren sectie.
De .vlt-sync-config.properties
kunt u de volgende eigenschappen configureren:
uitgeschakeld Hiermee schakelt u de synchronisatie in of uit. Deze parameter is standaard ingesteld op false om synchronisatie toe te staan.
sync-once Als de volgende scan niet leeg is, wordt de map in de opgegeven richting gesynchroniseerd, 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-log Definieert de bestandsnaam van het logbestand. De standaardwaarde is .vlt-sync.log
Ga als volgt te werk als u een ontwikkelomgeving wilt instellen op basis van een synchronisatiemap:
De gegevensopslagruimte uitchecken via de opdrachtregel voor vlt:
$ vlt --credentials admin:admin co --force http://localhost:4502/crx dev
Met filters kunt u alleen de juiste paden uitchecken. Zie de Een gefilterde uitchecking uitvoeren voor meer informatie.
Ga naar de hoofdmap van uw werkkopie:
$ cd dev/jcr_root/
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
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.
Bewerk de .vlt-sync-config.properties
Verborgen bestand en synchronisatie configureren om de inhoud van uw opslagplaats te synchroniseren:
sync-once=JCR2FS
Deze stap downloadt de hele opslagplaats volgens uw filterconfiguratie.
Logbestand controleren .vlt-sync.log
de vorderingen 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.
De functie VLT-synchronisatie ondersteunt alleen eenvoudige bestanden en mappen, maar detecteert speciale geserialiseerde bestanden (.content.xml, dialog.xml, enz.) met vault en negeert deze op ongemerkt. Het is dus mogelijk om vault sync te gebruiken bij een standaard vlt-afhandeling.