如何使用VLT工具

Jackrabbit FileVault工具(VLT)是由Apache Foundation開發的工具，可將Jackrabbit/AEM例項的內容對應至您的檔案系統。 VLT工具具有與源控制系統客戶端(如Subversion(SVN)客戶端)類似的功能，提供正常的簽入、簽出和管理操作，以及用於靈活呈現項目內容的配置選項。

從命令行運行VLT工具。本檔案說明如何使用此工具，包括如何開始和取得說明，以及所有命令和可用選項的清單。

概念與架構

請參閱官方Apache Jackrabbit Filevault檔案中的檔案概述和金庫FS頁面，以取得Filevault工具概念與結構的完整概觀。

VLT快速入門

若要開始使用VLT，您必須執行下列動作：

安裝VLT、更新環境變數和更新全局忽略的subversion檔案。
設定AEM存放庫（如果您尚未這麼做）。
查看AEM存放庫。
與儲存庫同步。
測試同步是否有效。

安裝VLT工具

若要使用VLT工具，您必須先安裝它。由於它是額外的工具，因此預設不會安裝它。此外，您還需要設定系統的環境變數。

從Maven對象儲存庫下載FileVault存檔檔案。

注意

VLT工具的原始碼可在GitHub上使用。
解壓縮檔案。
將<archive-dir>/vault-cli-<version>/bin添加到您的環境PATH中，以便根據需要訪問命令檔案vlt或vlt.bat。例如：

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

開啟命令行shell並執行vlt --help。請確定輸出類似下列說明畫面：

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

安裝後，您需要更新全局忽略的subversion檔案。編輯svn設定並新增下列項目：

[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會根據下列規則自動處理行尾(EOF):

在Windows上以CRLF結尾簽出的檔案行
在Linux/Unix上以LF結尾簽出的檔案行
儲存庫的檔案行以LF結尾

為確保VLT和SVN配置匹配，應將svn:eol-style屬性設定為native ，以擴展儲存在儲存庫中的檔案。編輯svn設定並新增下列項目：

[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

簽出儲存庫

使用源控制系統簽出儲存庫。例如，在svn中鍵入以下內容（用儲存庫替換URI和路徑）:

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

與儲存庫同步

您需要將檔案與儲存庫同步。要執行此操作：

在命令行中，導航至content/jcr_root。
通過鍵入以下內容（將埠號替換為4502和管理員密碼）來檢查儲存庫：
```
vlt --credentials admin:admin co --force http://localhost:4502/crx
```
注意

初次結帳時，必須只指定一次認證。然後，它們將儲存在.vault/auth.xml內的您的主目錄中。

測試同步是否工作

簽出儲存庫並同步後，您應進行測試，以確保所有操作都正常運行。要做到這一點，一個簡單的方法是編輯.jsp檔案，並查看提交更改後是否反映了您的更改。

要測試同步，請執行以下操作：

導航到 .../jcr_content/libs/foundation/components/text.
在text.jsp中編輯內容。
鍵入vlt st查看修改過的檔案
鍵入vlt diff text.jsp查看更改
提交更改：vlt ci test.jsp。
重新載入包含文字元件的頁面，並查看您的變更是否存在。

取得VLT工具的幫助

安裝VLT工具後，可從命令行訪問其幫助檔案：

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

有關特定命令的幫助，請鍵入help命令，後跟命令的名稱。例如：

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

在VLT中執行的常見任務

以下是在VLT中執行的一些常見任務。有關每個命令的詳細資訊，請參見單個命令。

檢出子樹

如果只想簽出儲存庫的子樹（例如/apps/geometrixx），則可以通過鍵入以下內容來執行此操作：

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

這樣做會建立一個新的導出根geo，其中包含META-INF和jcr_root目錄，並將所有檔案放在/apps/geometrixx的geo/jcr_root下。

執行已過濾的檢出

如果您有現有的工作區篩選器，但想將其用於簽出，則可以先建立META-INF/vault目錄並將篩選器放在該目錄，或者按如下方式在命令行中指定該篩選器：

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

範例篩選：

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

使用「匯入／匯出」而非。vlt控制

您可以在JCR儲存庫和本地檔案系統之間導入和導出內容，而無需使用控制檔案。

若要匯入和匯出內容而不使用.vlt控制項：

初始設定儲存庫：

$ 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

更改遠程拷貝並更新JCR:

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

更改遠程副本並更新檔案伺服器：

$ 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

要在VLT中發出命令，請在命令行中鍵入以下命令：

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

以下各節將詳細說明選項和命令。

VLT全局選項

以下是VLT選項清單，這些選項可用於所有命令。有關其他可用選項的資訊，請參見各個命令。


選項	說明
`-Xjcrlog <arg>`	擴充的JcrLog選項
`-Xdavex <arg>`	擴充的JCR遠端選項
`--credentials <arg>`	要使用的預設憑據
`--config <arg>`	要使用的JcrFs組態
`-v (--verbose)`	詳細輸出
`-q (--quiet)`	盡可能少地打印
`--version`	列印版本資訊並退出VLT
`--log-level <level>`	指示日誌級別，例如log4j日誌級別。
`-h (--help) <command>`	列印該特定命令的說明

VLT命令

下表說明所有可用的VLT命令。有關語法、可用選項和示例的詳細資訊，請參見各個命令。


命令	縮寫命令	說明
`export`		從JCR儲存庫（Vault檔案系統）導出到本地檔案系統，而無控制檔案。
`import`		將本地檔案系統導入JCR儲存庫（Vault檔案系統）。
`checkout`	`co`	檢出Vault檔案系統。將它用於本地檔案系統的初始JCR儲存庫。 (注意：您必須先在subversion中籤出儲存庫。)
`analyze`		分析包。
`status`	`st`	打印工作副本檔案和目錄的狀態。
`update`	`up`	將更改從儲存庫導入工作副本。
`info`		顯示有關本機檔案的資訊。
`commit`	`ci`	將工作副本中的更改發送到儲存庫。
`revert`	`rev`	將工作副本檔案還原為原始狀態，並取消大部分的本機編輯。
`resolved`	`res`	刪除工作副本檔案或目錄上的衝突狀態。
`propget`	`pg`	在檔案或目錄上打印屬性的值。
`proplist`	`pl`	在檔案或目錄上打印屬性。
`propset`	`ps`	在檔案或目錄上設定屬性的值。
`add`		將檔案和目錄置於版本控制之下。
`delete`	`del` 或 `rm`	從版本控制中移除檔案和目錄。
`diff`	`di`	顯示兩個路徑之間的差異。
`console`		執行互動式主控台。
`rcp`		將一個節點樹從一個遠程儲存庫複製到另一個遠程儲存庫。
`sync`		允許控制保險儲存同步服務。

匯出

將裝載在<uri>的Vault檔案系統導出到位於<local-path>的本地檔案系統。可以指定可選<jcr-path>，以便僅導出子樹。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-t (--type) <arg>`	指定導出類型，平台或jar。
`-p (--prune-missing)`	指定是否應刪除缺少的本地檔案
`<uri>`	mountpoint uri
`<jcrPath>`	JCR路徑
`<localPath>`	本地路徑

範例

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

匯入

將本地檔案系統（從<local-path>開始）導入<uri>的電子倉庫檔案系統。您可以指定<jcr-path>作為導入根目錄。如果指定--sync，則導入的檔案將自動置於電子倉庫控制下。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-s (-- sync)`	將本地檔案置於保險儲存控制之下
`<uri>`	mountpoint uri
`<jcrPath>`	JCR路徑
`<localPath>`	本地路徑

範例

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

結帳(co)

從JCR儲存庫對本地檔案系統執行初始簽出，從<uri>開始，對<local-path>的本地檔案系統執行初始簽出。您也可以添加<jcrPath>參數來檢出遠程樹的子目錄。可以指定將其複製到META-INF目錄中的工作區篩選器。

語法

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

選項


`--force`	強制簽出以覆蓋本地檔案（如果檔案已存在）
`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`-f (--filter) <file>`	指定如果未定義自動篩選
`<uri>`	mountpoint uri
`<jcrPath>`	（可選）遠程路徑
`<localPath>`	（可選）本機路徑

範例

使用JCR Remoting:

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

使用預設工作區：

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

如果URI不完整，則將展開它：

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

分析

分析包。

語法

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

選項


`-l (--linkFormat) <format>`	修補程式連結的printf格式（名稱、id），例如`[CQ520_HF_%s\|%s]`
`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`<localPaths> [<localPaths> ...]`	本地路徑

狀態

打印工作副本檔案和目錄的狀態。

如果指定--show-update，則會根據遠程版本檢查每個檔案。然後，第二字母指定更新操作將執行哪些操作。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`-u (--show-update)`	顯示更新資訊
`-N (--non-recursive)`	在單個目錄上運行
`<file> [<file> ...]`	顯示狀態的檔案或目錄

更新

將更改從儲存庫複製到工作副本中。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`--force`	強制覆寫本機檔案
`-N (--non-recursive)`	在單個目錄上運行
`<file> [<file> ...]`	要更新的檔案或目錄

資訊

顯示有關本機檔案的資訊。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	運算遞歸
`<file> [<file> ...]`	顯示資訊的檔案或目錄

提交

將工作副本中的更改發送到儲存庫。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`--force`	即使修改了遠程副本，也強制提交
`-N (--non-recursive)`	在單個目錄上運行
`<file> [<file> ...]`	提交檔案或目錄

回復

將工作副本檔案還原為原始狀態，並取消大部分的本機編輯。

語法

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

選項


`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	遞歸降階
`<file> [<file> ...]`	提交檔案或目錄

已解決

移除工作副本檔案或目錄上的衝突狀態。

注意

該命令不會在語義上解決衝突或刪除衝突標籤；它只會刪除與衝突相關的對象檔案，並允許再次提交PATH。

語法

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

選項


`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	遞歸降階
`--force`	解析，即使有衝突標籤
`<file> [<file> ...]`	解析檔案或目錄

Propget

在檔案或目錄上打印屬性的值。

語法

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

選項


`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	遞歸降階
`<propname>`	屬性名稱
`<file> [<file> ...]`	檔案或目錄，以從

Proplist

在檔案或目錄上打印屬性。

語法

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

選項


`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	遞歸降階
`<file> [<file> ...]`	檔案或目錄，以列出

Propset

在檔案或目錄上設定屬性的值。

注意

VLT可識別下列特殊版本控制屬性：

vlt:mime-type

檔案的mimetype。用於確定是否合併檔案。以'text/'（或缺少的mimetype）開頭的mimetype會視為文字。其他任何項目則視為二進位。

語法

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

選項


`-q (--quiet)`	打印盡可能少
`-R (--recursive)`	遞歸降階
`<propname>`	屬性名稱
`<propval>`	屬性值
`<file> [<file> ...]`	檔案或目錄，將屬性設定為

新增

將檔案和目錄置於版本控制之下，並安排它們以添加到儲存庫。將在下次提交時添加它們。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`-N (--non-recursive)`	在單個目錄上運行
`--force`	迫使行動進行
`<file> [<file> ...]`	添加本地檔案或目錄

刪除

從版本控制中移除檔案和目錄。

語法

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

選項


`-v (--verbose)`	詳細輸出
`-q (--quiet)`	打印盡可能少
`--force`	迫使行動進行
`<file> [<file> ...]`	刪除本地檔案或目錄

差異

顯示兩個路徑之間的差異。

語法

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

選項


`-N (--non-recursive)`	在單個目錄上運行
`<file> [<file> ...]`	顯示

主控台

執行互動式主控台。

語法

console -F <file>

選項


`-F (--console-settings) <file>`	指定控制台設定檔案。預設檔案為console.properties。

Rcp

將一個節點樹從一個遠程儲存庫複製到另一個遠程儲存庫。 <src> 指向源節點並指 <dst> 定父節點必須存在的目標路徑。Rcp通過流化資料來處理節點。

語法

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

選項


`-q (--quiet)`	盡可能少地打印。
`-r (--recursive)`	遞歸降。
`-b (--batchSize) <size>`	中間保存前要處理的節點數。
`-t (--throttle) <seconds>`	中間儲存後要等待的秒數。
`-u (--update)`	覆寫／刪除現有節點。
`-n (--newer)`	請遵守lastModified屬性以進行更新。
`-e (--exclude) <arg> [<arg> ...]`	排除的源路徑的Regexp。
`<src>`	源樹的儲存庫地址。
`<dst>`	目標節點的儲存庫地址。

範例

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

注意

--exclude選項後面必須跟在<src>和<dst>引數之前的另一個選項。例如：

vlt rcp -e ".*\.txt" -r

同步

允許控制保險儲存同步服務。如果沒有任何引數，此命令將嘗試將當前工作目錄置於同步控制下。如果在vlt結帳中執行，則會使用各自的篩選器和主機來設定同步。如果在vlt檢出外執行，則僅當目錄為空時，才會註冊當前資料夾以進行同步。

語法

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

選項


`-v (--verbose)`	詳細輸出。
`--force`	強制執行某些命令。
`-u (--uri) <uri>`	指定同步主機的URI。
`<command>`	sync命令執行。
`<localPath>`	要同步的本機資料夾。

狀態代碼

VLT使用的狀態代碼為：

' '無修改
已新增'A'
'C'衝突
'D'已刪除
'I'已忽略
'M'已修改
'R'已取代
'?' 項目不在版本控制之下
'!' 項目遺失（由非svn命令移除）或不完整
「~」版本項被不同類型的某個項目阻擋

設定FileVault同步

儲存庫同步服務用於將儲存庫內容與本地檔案系統表示同步，反之亦然。這是通過安裝OSGi服務來實現的，該服務將監聽儲存庫更改並將定期掃描檔案系統內容。它使用與儲存庫相同的序列化格式將儲存庫內容映射到磁碟。

注意

保險儲存同步服務是一種開發工具，非常不鼓勵在生產系統上使用它。另請注意，服務只能與本地檔案系統同步，不能用於遠程開發。

使用vlt安裝服務

vlt sync install命令可用於自動安裝保險儲存同步服務包和配置。

此包安裝在/libs/crx/vault/install下方，配置節點建立在/libs/crx/vault/com.day.jcr.sync.impl.VaultSyncServiceImpl上。服務最初是啟用的，但未配置同步根。

下面的示例將同步服務安裝到給定URI可訪問的CRX實例。

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

顯示服務狀態

status命令可用於顯示有關正在運行的同步服務的資訊。"

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

注意

status命令不會從服務中讀取任何即時資料，而是讀取/libs/crx/vault/com.day.jcr.sync.impl.VaultSyncServiceImpl中的配置。

添加同步資料夾

register命令用於添加要與配置同步的資料夾。

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

注意

在配置sync-once配置之前，register命令不會觸發同步。

刪除同步資料夾

unregister命令用於刪除要從配置中同步的資料夾。

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

注意

您必須先註銷同步資料夾，然後才能刪除該資料夾本身。

配置同步

服務配置

在服務運行後，可以使用以下參數對其進行配置：

vault.sync.syncroots:定義同步根的一個或多個本地檔案系統路徑。
vault.sync.fscheckinterval:應掃描其檔案系統以進行更改的頻率（以秒為單位）。預設值為5秒。
vault.sync.enabled:啟用／禁用服務的常規標誌。

注意

服務可以在儲存庫中配置Web控制台或sling:OsgiConfig節點（名稱為com.day.jcr.sync.impl.VaultSyncServiceImpl）。

使用AEM時，有幾種方法可管理此類服務的組態設定；如需詳細資訊，請參閱設定OSGi。

同步資料夾配置

每個同步資料夾都將配置和狀態儲存在三個檔案中：

.vlt-sync-config.properties:配置檔案。
.vlt-sync.log:包含同步期間所執行操作相關資訊的記錄檔。
.vlt-sync-filter.xml:篩選器，用於定義同步的儲存庫的哪些部分。該檔案的格式由執行過濾簽出部分描述。

.vlt-sync-config.properties檔案允許您配置以下屬性：

禁用開啟或關閉同步。預設情況下，此參數設定為false以允許同步。

sync- once如果非空，則下次掃描將按給定方向同步資料夾，然後將清除該參數。支援兩個值：

JCR2FS:將JCR儲存庫中的所有內容導出並寫入本地磁碟。
FS2JCR:將所有內容從磁碟導入JCR儲存庫。

sync- log定義日誌檔案名。依預設，值為。vlt-sync.log

使用VLT同步進行開發

要根據同步資料夾設定開發環境，請按如下步驟操作：

使用vlt命令行簽出儲存庫：
```
$ vlt --credentials admin:admin co --force http://localhost:4502/crx dev
```
注意

您可以使用篩選器來僅結帳適當的路徑。有關資訊，請參見執行過濾結帳部分。
轉至工作副本的根資料夾：
```
$ cd dev/jcr_root/
```

將同步服務安裝到您的儲存庫：

$ 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

初始化同步服務：

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

編輯.vlt-sync-config.properties隱藏檔案並配置同步以同步儲存庫的內容：
```
sync-once=JCR2FS
```
注意

此步驟會根據您的篩選器配置下載整個儲存庫。

檢查日誌檔案.vlt-sync.log以查看進度：

***
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
***

您的本地資料夾現在與儲存庫同步。同步是雙向的，因此從儲存庫進行的修改將應用於本地同步資料夾，反之亦然。

注意

VLT同步功能僅支援簡單檔案和資料夾，但檢測特殊的電子倉庫序列化檔案（.content.xml、dialog.xml等），並以無提示方式忽略它們。因此，可在預設vlt結帳時使用vault同步。

adobe.com 上的資源

Multichannel Communication Auto Text Summarization Embedded Charts Responsive Forms Document Generation Web Content Management