Created by Iain Ferguson, last modified on Aug 19, 2023

The repositories

This setup section will will focus on what needs to be changed in the configuration to allow new disk locations to be used for the repositories and their backups. The two repositories are the

  • Master repository

  • Derivatives repository

The Master repository is used to store original images so needs to be large enough to contain all your image collection, plus size to grow as new images added.

Derivatives repository is used to store derivatives or versions of your original images. As a bi-produce of editing and saving versions. Initially it will be empty. It will only as you edit images so can be much smaller then the master repository.

The backups

The backups are at least the size of the repository they are covering in case of failure. As these backups are a case of failure it would be prudent to locate them on a different drive so there is not one point of failure.

Setting up the repositories

ImaArchive admin tool (iaadmin.exe) is used to reconfigure the repositories. Two sub-commands can be used, the main one is iaadmin config and iaadmin show is used to verify the setting.

You will need to start a command prompt (cmd.exe) with elevated permissions. To do the you just need to right click on the command prompt menu item then a sub-menu will open. click “Run as Administrator” the command prompt will start in elevated permissions.

Setting up the Master

To begin, To show the configuration as is type:

C:\Users\your name>iaadmin show --setting=master

This will output something like this:

Master Archive

Master Archive Location
C:\ProgramData/IDK-Software/ImgArchive/master

Master Archive Backups
Backup One Enabled: False
Path not Valid: C:\ProgramData\IDK-Software\ImgArchive/backup/MasterBackup1
Backup Two Enabled: False
Path not Valid: C:\ProgramData\IDK-Software\ImgArchive/backup/MasterBackup2

0000:Success

This shows that the master repository path is: “C:\ProgramData/IDK-Software/ImgArchive/master” and both backups are disabled.

Setting up Master path

This sets were the master repository is located ideally the repositories will be on there own dedicated disc. The sub-command iaadmin config is used for setting up the master repository with the “--folders” option.

the syntax will be

iaadmin config --folders MasterPath=<path>

For example, if you master repository is to be located at: “D:\Master” then type:

iaadmin config --folders MasterPath=“D:\Master”<cr>

to verify the path is set correctly type:

iaadmin show --setting master

Setting up Derivative path

This follows the same procedure as the Master. use “iaadmin config --folders” but use the following syntax:

iaadmin config --folders DerivativePath=<path>

For example, if you master repository is to be located at: “D:\Derivative” then type:

iaadmin config --folders DerivativePath=“D:\Derivative”<cr>

to verify the path is set correctly type:

iaadmin show --setting derivative

Setting up the Backups (Master and Derivative)

Both Master and Derivative repository backups are setup in the same way the only difference is the Master uses the option:

iaadmin config--master <Option=Value>

And the Derivative uses the option:

iaadmin config--master <Option=Value>

Each backup has two options that need to be set:

  • Enabling or Disabling the backup

  • The Backups path

Both these options need to be set correctly for the backup to work. The first needs to be set to True for the backup to be enabled and the second needs to contain the path of backups location. There is two backups and they operate independently. As with the main repositories each backup ideally the will be on there own dedicated disc. However both master and Derivative repository can share the same disc for Example Master backup 1 and Derivative backup 1 can share the same disc. That means the Image Vault will take three disks.

Enabling the backup

Taking the master repository and Backup One as the example:

iaadmin config--master BackupOneEnabled=Enabled

Will enable master Backup-One. To enable the other backups use the same process but change the options to suit.

Setting up the Backup path

Again taking the master repository and Backup One as the example and a backup One path as:

E:\MasterBackup1

The syntax is:

iaadmin config--master BackupOne=<path>

type:

iaadmin config--master BackupOne=”E:\MasterBackup1”

This will set master Backup-One’s path to ”E:\MasterBackup1”. To enable the other backups use the same process but change the options to suit.

C:\Users\Iain Ferguson>iaadmin show --setting=derivative

Derivative Archive

Derivative Archive Location
C:\ProgramData/IDK-Software/ImgArchive/derivative

Derivative Archive Backups
Backup One Enabled: True
Path not Valid: C:\temp\derivative\backup_1
Note: This is an Error condition as Derivative backup 1 Path location is not valid?
Backup Two Enabled: False
Path not Valid: C:\ProgramData\IDK-Software\ImgArchive/backup/DerivativeBackup2

0000:Success