Het gereedschap VLT gebruiken how-to-use-the-vlt-tool

Het hulpmiddel van FileVault van het Jasrabbit (VLT) is een hulpmiddel dat door wordt ontwikkeld de Stichting Apachedie de inhoud van een instantie Jackrabbit/AEM aan uw dossiersysteem in kaart brengt. 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, en configuratieopties voor flexibele vertegenwoordiging van de projectinhoud verstrekt.

U voert het gereedschap VLT uit vanaf de opdrachtregel. Dit document beschrijft hoe te om het hulpmiddel te gebruiken, met inbegrip van hoe te begonnen worden en hulp krijgen, en een lijst van alle bevelenen beschikbare opties.

Concepten en architectuur concepts-and-architecture

Zie het Overzicht FileVaulten vault fspagina van de officiële Apache documentatie van het Dossier van het Jasje van het Dossiervoor een grondig overzicht van de concepten en de structuur van het hulpmiddel FileVault.

Aan de slag met VLT getting-started-with-vlt

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

Het gereedschap VLT installeren installing-the-vlt-tool

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.

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 teken voor regeleinde configureren configuring-the-end-of-line-character

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

Om ervoor te zorgen dat de VLT- en SVN-configuratie overeenkomen, moet u de eigenschap svn:eol-style instellen op 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

Bewaarplaats uitchecken checking-out-the-repository

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 opslagplaats synchronizing-with-the-repository

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

Testen of de synchronisatie is uitgevoerd testing-whether-the-synchronization-worked

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:

Hulp krijgen met het Hulpmiddel VLT getting-help-with-the-vlt-tool

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 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 common-tasks-performed-in-vlt

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

Een substructuur uitchecken checking-out-a-subtree

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

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.

Een gefilterde uitchecking uitvoeren performing-a-filtered-checkout

Als u een bestaand werkruimtefilter hebt en u het voor controle wilt gebruiken, kunt u of eerst tot de META-INF/vault folder leiden 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 in plaats van .vlt-besturingselement gebruiken using-import-export-instead-of-vlt-control

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:

VLT gebruiken using-vlt

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.

Globale opties voor VLT vlt-global-options

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

VLT-opdrachten vlt-commands

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

Exporteren export

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 syntax

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

Opties options

Voorbeelden examples

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

Importeren import

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 is opgegeven, worden de geïmporteerde bestanden automatisch onder controle gehouden.

Syntaxis syntax-1

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

Opties options-1

Voorbeelden examples-1

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

Afhandeling (co) checkout-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. Workspace-filters kunnen worden opgegeven die naar de map META-INF worden gekopieerd.

Syntaxis syntax-2

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

Opties options-2

Voorbeelden examples-2

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 analyze

Hiermee analyseert u pakketten.

Syntaxis syntax-3

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

Opties options-3

Status status

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

Als --show-update is opgegeven, wordt elk bestand gecontroleerd op de externe versie. De tweede letter geeft vervolgens aan welke actie door een updatebewerking wordt uitgevoerd.

Syntaxis syntax-4

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

Opties options-4

Bijwerken update

Hiermee worden wijzigingen van de opslagplaats naar de werkkopie gekopieerd.

Syntaxis syntax-5

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

Opties options-5

Info info

Geeft informatie weer over een lokaal bestand.

Syntaxis syntax-6

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

Opties options-6

Vastleggen commit

Hiermee verzendt u wijzigingen van uw werkkopie naar de opslagplaats.

Syntaxis syntax-7

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

Opties options-7

Vorige versie revert

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

Syntaxis syntax-8

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

Opties options-8

Opgelost resolved

Verwijdert conflicteerde staat op het werken van exemplaardossiers of folders.

Syntaxis syntax-9

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

Opties options-9

Propget propget

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

Syntaxis syntax-10

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

Opties options-10

Proplist proplist

Hiermee worden de eigenschappen afgedrukt op bestanden of mappen.

Syntaxis syntax-11

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

Opties options-11

Propset propset

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

Syntaxis syntax-12

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

Opties options-12

Toevoegen add

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

Syntaxis syntax-13

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

Opties options-13

Verwijderen delete

Hiermee verwijdert u bestanden en mappen uit versiebeheer.

Syntaxis syntax-14

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

Opties options-14

Diff diff

Hiermee geeft u de verschillen tussen twee paden weer.

Syntaxis syntax-15

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

Opties options-15

Console console

Hiermee wordt een interactieve console uitgevoerd.

Syntaxis syntax-16

console -F <file>

Opties options-16

Rcp rcp

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.

Syntaxis syntax-17

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

Opties options-17

Voorbeelden examples-3

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

Sync sync

Hiermee kunt u de vault sync-service beheren. Zonder argumenten probeert deze opdracht de huidige werkmap onder synchronisatiecontrole te zetten. Indien uitgevoerd binnen een vlt-uitchecking, worden het desbetreffende filter en de respectievelijke host gebruikt om de synchronisatie te configureren. Als deze map buiten een volledig uitchecken wordt uitgevoerd, wordt de huidige map alleen voor synchronisatie geregistreerd als de map leeg is.

Syntaxis syntax-18

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

Opties options-18

Statuscodes status-codes

De statuscodes die door VLT worden gebruikt zijn:

FileVault-synchronisatie instellen setting-up-filevault-sync

De vault sync-service wordt gebruikt om inhoud in de opslagplaats te synchroniseren met een lokale bestandssysteemweergave en omgekeerd. 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 installing-the-service-using-vlt

U kunt de opdracht vlt sync install gebruiken om de bundel en configuratie van de kluissynchronisatieservice automatisch te 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 via de opgegeven uri.

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

De servicestatus weergeven displaying-the-service-status

U kunt de opdracht status 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.

Een synchronisatiemap toevoegen adding-a-sync-folder

De opdracht register wordt gebruikt om een map toe te voegen die moet worden gesynchroniseerd 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 removing-a-sync-folder

Met de opdracht unregister verwijdert u een map die u wilt synchroniseren uit de configuratie.

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

Synchronisatie configureren configuring-synchronization

Serviceconfiguratie service-configuration

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

Mapconfiguratie synchroniseren sync-folder-configuration

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

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

gehandicapte draait de synchronisatie of weg. Deze parameter is standaard ingesteld op false om synchronisatie toe te staan.

synchronisatie-eens als het niet lege volgende aftasten de omslag in de bepaalde richting zal synchroniseren, dan zal de parameter worden ontruimd. Er worden twee waarden ondersteund:

synchronisatie-logboek bepaalt logboekfilename. De standaardwaarde is .vlt-sync.log

VLT-sync gebruiken voor ontwikkeling using-vlt-sync-for-development

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

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