Introduction #

The document library server can use differents ways to persist documents. Before the 5.x, the technology was JackRabbit (JCR Hook). Now it is the filesystem hook.

Migrate from 4.3 to 5.x #

Under the "data" directory, you can find "jackrabbit", "lucene", "document_library"... Only the data dir is necessary when you migrate from 4.x to 5.x.

For example you work with Liferay 4.3.x and your data directory is "/home/liferay" (by default it is into your account and this could be precised into portal-ext.properties). So you have to recopy "/home/liferay/jackrabbit" directory to "data". Into this dir you can find "repository.xml" and "home" dir (with raw data).

Moreover, you have to add these lines into portal-ext.properties.

    jcr.initialize.on.startup=false
    jcr.workspace.name=liferay
    jcr.node.documentlibrary=documentlibrary
    jcr.jackrabbit.repository.root=${liferay.home}/data/jackrabbit
    jcr.jackrabbit.config.file.path=${jcr.jackrabbit.repository.root}/repository.xml
    jcr.jackrabbit.repository.home=${jcr.jackrabbit.repository.root}/home
    jcr.jackrabbit.credentials.username=none
    jcr.jackrabbit.credentials.password=none
    
    #
    # Set the name of a class that implements
    # com.liferay.documentlibrary.util.Hook. The
    # document library server will use this persist documents.
    #
    # Available hooks are:
    #     com.liferay.documentlibrary.util.FileSystemHook
    #     com.liferay.documentlibrary.util.JCRHook
    #     com.liferay.documentlibrary.util.S3Hook
    #
    #dl.hook.impl=com.liferay.documentlibrary.util.AdvancedFileSystemHook
    #dl.hook.impl=com.liferay.documentlibrary.util.FileSystemHook
    dl.hook.impl=com.liferay.documentlibrary.util.JCRHook
    #dl.hook.impl=com.liferay.documentlibrary.util.S3Hook