Vault: Switching storage model for DRP / DRD files

UPDATED: September 26, 2017

Switching storage model for DRP / DRD files
Many of the concepts and parameters mentioned here that do not have detailed explanations can be found in the Vault documentation (i.e. Vault Customizing Guide, Vault User Guide).
The Vault suite of products support storage, display, management and processing of composed
documents in electronic environments. Many of the Vault components are optional so you
should consider the information in this overview in relation to the licenses you actually own.
The Vault is the central document repository and forms the hub of the Vault environment. The
Vault is comprised of two software components: the Vault Server Daemon, which services
incoming index searches and document requests, and the Vault Loader Daemon, which
manages the load or ingestion processes. These software components may be Daemons on
Unix or Linux platforms, or Windows Services.

In order to plan for how much disk storage will be required, the administrator needs to
consider various configuration aspects that are peculiar to their configuration settings. These
configuration settings will affect the storage requirements. Consequently, specific capacity or
performance numbers cannot be universally quoted; they must be made within the context of
the particular installation requirements.
The storage model is used  to change the storage layout of the document data ( DRD, DRP and JRN files).
Storage model
The parameter of StorageModel is a global parameter defined in server.ini. It is a parameter for changing the storage layout of the .drd and .drp files.
General speaking it will be used with StoragePath.
The value of StorageModel can choose below values.
0/1: standard -  drd files stored in docdata, drp, jrn files stored in pagedata
2: year -  drd,drp,jrn files stored in storage\yyyy
3: month - drd,drp,jrn files stored in storage\yyyy\mm
4: day - drd,drp,jrn files stored in storage\yyyy\mm\dd
When an alternate storage model is enabled, data files are stored under the “storage”
directory. Like other Vault paths, “storage” can be redirected from its default location.
For example:
Steps of how to switch
1. Use server to do the switching:
Please be careful about the solution. If choosing this solution, the server stores the data in the data layout defined with StorageModel, which means storing the data under the StoragePath in the directory tree of YYYY or YYYY/MM or YYYY/MM/DD depend on the setting of StorageModel.
If you change the values StorageModel or StoragePath, server will change the way to store or retrieve data. Keep the settings consistent. Otherwise you will get errors of  Cannot Find Out DRD or DRP Files.
The default value for StorageModel is 1 which means storing and retrieving data from <Vault-Installation-Dir>\server\docdata\ and <Vault-Installation-Dir>\server\pagedata\; the default value of StoragePath is <Vault-Installation-Dir>\server\storage\
In server.ini, set up below values
 StoragePath = C:\Vault\Storage
StorageModel = 2 # store / retrieve data from <StoragePath>\YYYY\
StorageModel = 3 # store / retrieve data from <StoragePath>\YYYY\MM\
StorageModel = 4 # store / retrieve data from <StoragePath>\YYYY\MM\DD\
2. Using the script to convert existing default data to a storage model
There is a script named storage-convert.bat from Vault System under Windows platform (see below for the script) you can use to do the storage switching from the default DOCDATA and PAGEDATA directories to the storage directory defined.

Please be careful about the naming convention for the file names (DRD, DRP and JRN) under DOCDATA and PAGEDATA directories. The first 8 chars should be digits (the first 4 chars are for YEAR, the 5th and 6th chars are for MONTH, the 7th and 8th chars for DAY). If the first 8 chars are not number, the script will treat them as digits.
The storage switching process will move the files from the default directories of DOCDATA and PAGEDATA to different ones which means the original files will be deleted. So be careful and make sure that you want to do the process.

  1. Copy the script to <Vault-Installation-Dir>\server\.
  2. Change MODEL setting in the scripts to reflect your storage model, and STORAGE for the different dir used for storing the data.
    1. For MODEL 2, set MODEL=2 and run the script, the DRP/DRD/JRN files will move from <Vault>\server\ pagedata\ and <Vault>\server\docdata\  to <STORAGE>\<YYYY>\;
    2. For MODEL 3, set MODEL=3 and run the script, the DRP/DRD/JRN files will move from <Vault>\server\ pagedata\ and <Vault>\server\docdata\  to <STORAGE>\<YYYY>\<MM>\;
    3. For MODEL 4, set MODEL=4 and run the script, the DRP/DRD/JRN files will move from  <Vault>\server\pagedata\ and <Vault>\server\docdata\  to <STORAGE>\<YYYY>\<MM><DD>\;
The script included below:
Storage switching script (storage-convert.bat):
@echo off
set MODEL=2
set STORAGE=storage
set DOCDATA=docdata
set PAGEDATA=pagedata
if [%MODEL%]==[2] goto :doscan
if [%MODEL%]==[3] goto :doscan
if [%MODEL%]==[4] goto :doscan
goto :EOF
if not exist %STORAGE% md %STORAGE%
for %%i in (%DOCDATA%\*.drd)  do call :dotarget %%~ni %%i
for %%i in (%PAGEDATA%\*.drp) do call :dotarget %%~ni %%i
for %%i in (%PAGEDATA%\*.jrn) do call :dotarget %%~ni %%i
goto :EOF
set BASE=%1
set FILE=%2
set YEAR=%BASE:~0,4%
if [%YEAR%]==[] goto :EOF
if not exist %STORAGE%\%YEAR% md %STORAGE%\%YEAR%
if [%MODEL%]==[2] goto :domove
set MONTH=%BASE:~4,2%
if [%MONTH%]==[] goto :EOF
if not exist %STORAGE%\%YEAR%\%MONTH% md %STORAGE%\%YEAR%\%MONTH%
if [%MODEL%]==[3] goto :domove
set DAY=%BASE:~6,2%
if [%MONTH%]==[] goto :EOF
if not exist %STORAGE%\%YEAR%\%MONTH%\%DAY% md %STORAGE%\%YEAR%\%MONTH%\%DAY%
if [%MODEL%]==[4] goto :domove
goto :EOF
echo move %FILE% %TARGET%
move %FILE% %TARGET%
goto :EOF


  • No Downloads