IBM Daeja ViewONE Entitlement Tool, Version 1.0.2

This readme document contains information about obtaining and using the IBM Daeja ViewONE Entitlement Tool, Version 1.0.2.

Readme file for:
           IBM Daeja ViewONE
Product or component release:
           Version 1.0.2
Publication date:
           Sep 2015

Product description

The IBM Daeja ViewONE Entitlement tool enables you to add and remove entitlements for IBM Daeja ViewONE Professional or IBM Daeja ViewONE Virtual that is integrated within other IBM products.
For example, the tool can be used to add the redaction entitlement for the IBM Daeja ViewONE Permanent Redaction Module. You can use this module to permanently redact documents by using IBM Daeja ViewONE Professional that is integrated within IBM Content Navigator.

This version of the tool is supported for IBM Daeja ViewONE Professional and IBM Daeja ViewONE Virtual, version 4.1 and later.
If you are enabling the IBM Daeja ViewONE Virtual Permanent Redaction Module for the viewer within IBM Content Navigator, ensure that it is IBM Content Navigator V2.0.3 FP4 or later and the embedded IBM Daeja ViewONE viewer is version 4.1.5 or later.

Download location

To download the IBM Daeja ViewONE Entitlement Tool:

1. Log in to Fix Central.
2. In the Product Group list, select Enterprise Content Management.
3. In the Select from Enterprise Content Management list, select the IBM Daeja ViewONE Entitlement Tool version that you want to download.

You must have a license to download this software.

Prerequisites for IBM Daeja ViewONE Entitlement tool, V1.0.2

Ensure that the Java Runtime Environment (JRE) V7 or later is installed on your system.

Using the IBM Daeja ViewONE Entitlement tool

Arguments
The tool has a number of arguments, some are mandatory and some are optional.
Mandatory arguments are listed enclosed in angle brackets, <>, optional arguments are listed enclosed in square brackets, [].

Mandatory arguments:

    in is used to specify the path to an existing configuration file.
    modules is used to specify the path for a properties file containing updates to be made, for example, office=true.
    entitlement is used to specify the list of entitlements to add to the configuration file, for example, entitlement=office.
    removeentitlement is used to specify the list of entitlements to remove from the configuration file, for example, removeentitlement=office.

Optional arguments:

    out is used to specify the path to the newly generated configuration file. If you do not set this argument, the existing configuration file is overwritten.

Supported entitlements
The entitlements available for IBM Daeja ViewONE Entitlement tool, V1.0.2, are office and redaction which represents the following modules:

• IBM Daeja ViewONE Professional Module for Microsoft Office
• IBM Daeja ViewONE Professional Permanent Redaction Server Module

Adding entitlements
You can use the tool to add entitlements to a configuration file by using the argument entitlement and setting either a single entitlement or a comma-separated list of entitlements.

To add entitlements, run the following command:

java -jar daeja_viewone_entitlement.jar <in=inConfigFile> [out=outConfigFile] <entitlement=office,redaction,...>

Removing entitlements
You can use the tool remove entitlements from a configuration file by using the argument removeentitlement and setting either a single entitlement or a comma separated list of entitlements.

To remove entitlements, run the following command:

java -jar daeja_viewone_entitlement.jar <in=inConfigFile> [out=outConfigFile] <removeentitlement=office,redaction,...>

Using a properties file
An alternative to using the entitlement or removeentitlement arguments, you can use a properties file to specify the entitlements to add or remove.
The properties file contains a list of key-value pairs for each entitlement. Setting the entitlement to true tells the tool to add it to the configuration file. Setting the entitlement to false tells the tool to remove it.

For example, a properties file called entitlements.properties might contain:

office=true
redaction=false


To use the properties file, run the following command:

java -jar daeja_viewone_entitlement.jar <in=inConfigFile> [out=outConfigFile] <modules=propertiesFile>

Adding entitlements to an embedded viewer
To use the tool to update an embedded version of the IBM Daeja ViewONE viewer, see Adding entitlements to an integrated version of IBM Daeja ViewONE, V4.1 or later

Copyright and trademark information

http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

• the Excluded Components are provided on an "AS IS" basis
• IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
• IBM will not be liable to you or indemnify you for any claims related to the Excluded Components
• IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.