This page describes how to customize client applications for Variations. There are two types of clients, one for digitizers and the other for end users. The client software is the same in both cases, but it is configured differently, and the digitizer client installer includes some additional programs.
Download and unzip the Variations Client Construction Kit zip file:
Download and unpack the Variations Client Construction Kit gzipped tar file:
The client configuration allows for the integration between the end user (production and customers) software, the server software, and your institutions systems. The configuration of the client is done through the modification of the dml.conf files discussed below.
The file dml.conf will be installed and accessed by the client for the configuration of the End user distribution. The same dml.conf will be installed and accessed by the client for the configuration of the digitizer and catalogers distribution.
Location
Modification Instructions
Property Name |
Example Value(s) |
Description |
---|---|---|
|
<library_name> |
Connecting through RMI to a LibraryApplication server, available in the Client through Client.getLibraryName() |
dml.login.autoFillUsername |
true|false |
Fill in username field with the value in user.name, usually the current system username |
dml.login.useCookie |
true|false |
First attempt to login using stored cookie and save a cookie on login |
dml.login.realm.x |
iu.edu,Indiana University |
Realm used for Kerberos login, x should be replaced with the number of the realm starting with 1 |
|
server1.dlib.indiana.edu |
Hostname of the RMI registry hosting the LibraryApplication servers. This value should be the fully qualified hostname of your Variations Server |
dml.login.loginHandler |
edu.indiana.dml.client.login.CommandLineLoginHandler |
Full class name of the Login Handler to use for client logins |
dml.login.adminMode |
true|false |
Enable Admin Mode by default if permissions allow it. If not present or commented out, user will be prompted to choose admin or end-user mode. |
dml.login.digitizerMode |
true|false |
Enable Digitizer Mode by default if permissions allow it. If not present or commented out, user will be prompted to choose admin or end-user mode. |
Location
Modification Instructions
Property Name |
Example Value(s) |
Description |
---|---|---|
dml.client.preloadClasses |
true|false |
To preload classes before they are used to increase responsiveness if being run over a network |
dml.client.lessonsOn |
true|false |
Determines if the experimental Lesson Editor should be enabled |
dml.qtj.verboseMode |
true|false |
If true, QTJava will output extra debugging info |
|
Path to the user guide which appears when the application fails to load |
For Mac installations there is no digitizer & cataloger client so these values will not be applicable.
Location
Modification Instructions
Property Name |
Example Value(s) |
Description |
---|---|---|
|
Z:\ \ |
The default directory to look for wav files in the audio digitizer panel |
|
D:\ \ |
The default directory to look for a CD for track importation |
|
Z:\ \ |
The default directory to look for tiff files in the score digitizer panel |
dml.digitizer.warnOnEncode |
true|false |
A dialog warning digitizers that encoding may take a long time |
Note that these properties are used by catalogers and digitizers since both need to access the Z39.50 server. These properties do not need to exist for end-users. These properties also need to be in place on the server (in conf/client/dml.conf) in order for bin/generateAccessPage.sh to work properly.
Location
Modification Instruction
Property Name |
Example Value(s) |
Description |
---|---|---|
dml.z3950.Contributor.enabled |
true|false |
Enable Z39.50 Searches on Contibutor records |
dml.z3950.Contributor.host |
es07.uits.indiana.edu |
Hostname for Contributor Z39.50 searches |
dml.z3950.Contributor.port |
12202 |
Port for Contributor Z39.50 searches |
dml.z3950.Contributor.database |
AWRD |
Database for Contributor Z39.50 searches |
dml.z3950.Contributor.field.x.name |
any |
Field to search on in Z39.50 (x can be within 0 to 4) |
dml.z3950.Contributor.field.x.label |
Contributor Name |
Label to be displayed in search window for this field |
dml.z3950.Contributor.field.x.example |
(For example, Beethoven, Bach Sebastian) |
Example to be displayed in search window for this field |
dml.z3950.Container.enabled |
true|false |
Enable Z39.50 Searches on Container records |
dml.z3950.Container.host |
opac.example.edu |
Hostname for Container Z39.50 searches |
dml.z3950.Container.port |
210 |
Port for Container Z39.50 searches |
dml.z3950.Container.database |
INNOPAC |
Database for Container Z39.50 searches |
dml.z3950.Container.field.id.name |
12 |
Field to search on in Z39.50 for a unique id (when non-empty search only on this field) |
dml.z3950.Container.field.id.label |
Variations ID* |
Label to be displayed in search window for this field |
dml.z3950.Container.field.id.example |
(e.g., B1234567) |
Example to be displayed in search window for this field |
dml.z3950.Container.field.x.name |
author |
Field to search on in Z39.50 (x can be within 1 to 4) |
dml.z3950.Container.field.x.label |
Author |
Label to be displayed in search window for this field |
dml.z3950.Container.field.x.example |
(e.g., Beethoven, Bach) |
Example to be displayed in search window for this field |
dml.z3950.Work.enabled |
true|false |
Enable Z39.50 Searches on Work records |
dml.z3950.Work.host |
es07.uits.indiana.edu |
Hostname for Work Z39.50 searches |
dml.z3950.Work.port |
12202 |
Port for Work Z39.50 searches |
dml.z3950.Work.database |
AWRD |
Database for Work Z39.50 searches |
dml.z3950.Work.field.x.name |
author |
Field to search on in Z39.50 (x can be within 0 to 4) |
dml.z3950.Work.field.x.label |
Author |
Label to be displayed in search window for this field |
dml.z3950.Work.field.x.example |
(e.g., Beethoven, Bach) |
Example to be displayed in search window for this field |
Location
Modification Instructions
In both client_console.lcf and client_file.lcf, the RemoteHost property should be set to your Variations server:
log4j.appender.loggingServer.RemoteHost=example.example.edu
Below is a list of text and xml files that can be quickly customized for an institution. Manually set the properties that have a next to them.
Legal Notices
Version Information
Clients have their version numbers stored in VERSION. When attempting to connect to a Variations server, a client will check to make sure that their version number appears in those supported. Servers store the client versions that they support and updates to the version number of a client should be coordinated with the server. A restart of the Variations server is required to pick up on changes to the supported versions file.
About Variations Information
All lines in this file are read and displayed on the splash screen as well as in About Variations
Read Me file
The Read Me file contains general information about Variations and will be displayed after installation.
Example files can be found in data/, data/annotation, data/playlists, and data/timeline.
Currently the Variations team does not support the branding of the Variations client. If you wish to try branding the client for your institution please review the files below. Please contact the Variations team with any questions or difficulties concerning the branding elements.
Branding Elements:
The digitizer tools are used by digitizers to encode and ingest scores and audio into the server. These tools will be linked automatically with the digitizer installation (which you will build in the next step). Please visit the pages linked below and configure the tools for you institutions needs.
After you have completed the client configuration process, you can being building the installer at Building the Client Installer - 6.0.