®

Brava! Enterprise
TaskSpace Integration

Installation and Configuration Guide

(ActiveX) Version 6.0

Table of Contents
1.0 Preparing to Install Brava TaskSpace ................................................................................................ 2
1.1 Supported configurations and Hardware Requirements: ............................................................... 2
End-User Machine that Runs the Client Applet .............................................................................. 2
Brava! Server ................................................................................................................................... 2
Recommened Hardware Requirements............................................................................................ 3
2.0 Installing Brava for TaskSpace.......................................................................................................... 3
3.0 Configuring your Installation........................................................................................................... 10
3.1 Uninstalling Brava! TaskSpace Components............................................................................... 12
3.2 Tips and Troubleshooting ............................................................................................................ 12
4.0 Contacting Informative Graphics.................................................................................................... 13

1
1.0 Preparing to Install Brava TaskSpace
This guide is provided for the installation and configuration of the Brava for TaskSpace integration.
In addition, a CoreInstallguide.pdf is provided for advanced Brava TaskSpace users who may wish
to know much more detail about how Brava Enterprise works in general. It is also the initial resource
needed to begin to customize Brava beyond the scope of the TaskSpace integration. For the average
Brava TaskSpace Administrator, this information is a convenience, but not a necessity in the
operation or configuration of Brava for TaskSpace. Some information in the Core guide may appear
to conflict with information provided in this guide. Information presented in this guide will always
take precedence over any information presented in the Core guide.

1.1 Supported configurations and Hardware Requirements:

(See the Documentum TaskSpace Install Guide for TaskSpace supported configurations)

Installing Brava! Enterprise components requires some knowledge of web server/servlet engine
technology.

End-User Machine that Runs the Client Applet

Typically, the end-user machine downloads the Brava ActiveX Control for viewing and
marking up of TIFF, PDF and JPEG files in the TaskSpace environment.

Certified
OS: Windows XP Professional SP2, Windows 2000 Professional SP4
Browser: Internet Explorer 6.0 SP2 and 7.0

Brava! Server
This component consists primarily of a Java application and various Windows dlls. It also
consists of the web server where the Brava! for TaskSpace Client and dependent
components are hosted. A client end-user machine downloads these components the first
time it accesses a Brava! Web page through a TaskSpace link

Certified Operating System

OS: Windows 2003 Server

Certified Java
JRE: 1.5.0_10

Certified Application Servers:

For Windows, Tomcat 5.5 20, Weblogic 9.2.1, and WebSphere 6.1.9

2
 Recommended Hardware Requirements
 At least a Pentium 3 (or equivalent) 1.5GHX with1024MB RAM (1536MB or higher
recommended).
 125MB available hard disk space to install Brava 6.0 for TaskSpace files.

2.0 Installing Brava for TaskSpace

1. Run the Installation CD or double-click on the web package file that you downloaded. A
Demo Shield installation browser launches automatically. Select the Install Brava! for
TaskSpace button.

2. Read the Brava! Enterprise End user License Agreement and select “Yes, I agree” if you
have read, understand and agreed to the terms of the Licensing Agreement.

3
3. From the installation screen, you can launch this install guide. Click the Install Brava! 6.0 for
TaskSpace link to begin the installation.

4. On the Welcome screen, click Next.

4
5. Select a language for Brava Localization. Menus, dialogs, and tooltips will display in the
chosen language. Current localization options include English, French (standard), or German.

6. Select which Brava Enterprise components you would like to install on this machine. You
can install the components on the same or different machines. Click Next.

5
7. Select the setup type of install. The Brava installer will detect and display the Tomcat version
currently installed or you may select “Use different servlet engine”.
If you have elected NOT to use Tomcat (e.g. Weblogic or Websphere), you are prompted to
select a directory to deploy the Brava! Server WAR file from. It’s best to select a common
default location for your application server. With an application server such as BEA
Weblogic, it is recommended that WAR or EAR files be placed in a common, accessible
place such as the C:\bea\user_Projects\Domains directory to ensure that the files (WAR and
EAR) are located in a common default location for deployment. Click Next

6
8. The “Edit Data” screen displays the URL that will be used for communication by the Brava!
Client. The URL is broken down into its parts: The default servlet port to use for Tomcat is
8080. If your application server is not Tomcat, or if you have configured Tomcat to use a
non-default port, enter the application server’s communication port number. Click Next.
URL Prefix: Enter either HTTP:// or HTTPS:// depending on whether the servers are
configured to communicate using SSL and https.
Hostname: Enter the fully qualified domain name of the server that is used for
communicating with the Brava! Server.
Port: Enter the port number that your application server is using (where Brava Server
is running/deployed to).
Examples:
Tomcat (Default): 8080
Weblogic (Default) 7001
Websphere (Default) 9080

7
9. Browse to the location in the deployed TaskSpace from were the Brava Client files are to be
hosted and click Next. The default location will be
“C:\<myservletengine>\webapps\taskspace\wdk\imageviewer\brava”

10. Select an installation location for the Brava! Server files and click Next.

8
11. Click Install to begin the installation.

12. The installation will complete and prompt you to restart the system. You may be prompted to
reboot your system at this time.

9
3.0 Configuring your Installation
After completing the component installation, you will need to configure your installation for your
specific environment.

Required: You must edit or add the correct value to the bravaServerProperties parameter in the
ivf_config.xml file (located in the deployed TaskSpace application at
..\taskspace\wdk\config\imaging\ivf_config.xml)
The value of the parameter may look like this:
http://<localhost:port>/BravaServer/Properties
Replace localhost with the fully qualified domain name of the system that the Brava Server is
running on. Replace port with the port configured for the port the Application Server that the Brava
Server is running in.

Optional: The following table lists the parameters (and possible values) contained in the
ivf_config.xml page that you can customize. Many of these parameters determine which features will
be available to viewers using the Brava! ActiveX Client. You can choose to enable or disable a
feature by setting its value to true or false.

See Optional Brava ActiveX Parameters in the CoreInstallguide.pdf for a detailed list of all the
Brava Enterprise parameters.

Brava TaskSpace Parameters Used in the ivf_config.xml file

Parameter Value Description

ClientLog Valid string values are as This is the Level of Logging that can be
follows: done by the Brava TaskSpace Client.
All or 0 designates all levels With a logging level set to Error only,
of messages are logged. Error and Fatal Messages are logged.

Debug or 1 designates fine-

grained informational events
that are most useful to debug
an application.

Info or 2 designates
informational messages that
highlight the progress of the
application at coarse-grained
level.

Warn or 3 designate
potentially harmful situations.

Error or 4 (default) designates

error events that might still
allow the application to
10
 continue running.

Fatal or 5 designates very

severe error events that will
cause the application to abort.

ClientLogFile Any valid path on the Brava The path the Brava Client will attempt to
Client Systems write the client log file.
%USERPROFILE%/Applicat
ion
Data/BravaTaskspace/Logs/C
lientlog.txt – Default
ConvertOnClient TRUE - Default This setting determines whether the
FALSE Client or Server will convert the native
source file to IGC's display list format
which is required by the Brava Client.
If set to true, the Client converts all
TIFF , PDF and JPG formats by default,
plus any licensed CAD and Office
formats. The default is true, meaning
the Client loads and converts native
files.
Setting this value to true for the
appropriate formats reduces the load on
the server by shifting conversion to the
client.
EnableThumbnails TRUE – Default Turns the Page Thumbnails feature
FALSE on/off.
SecurityOptionsFromServ TRUE Turns on/off getting the CSF security
er FALSE – Default options (the security.xml file) from the
Brava Server and not interactively from the
user.

The following parameters control markup behavior.

EnableMarkup TRUE – Default Turns on/off the Markup option.

MarkupRasterDirectory
EnableMarkupClose
EnableMarkupCloseForRevie
w FALSE
EnableMarkupBurnin
FALSE
Default value is Sets the default path for the Markup Raster tool.
%USERPROFILE%\\ The path must be set using double back slashes
IGC\\StampImages to work properly. It is recommended that you use
a path relative to and within the user’s profile.
The path starting point of “%USERPROFILE%\\
should help to ensure that the user has the proper
permissions to the raster image files.
TRUE – Default Turns on/off the markup menu option to close
FALSE open (for editing) markups.
TRUE – Default Turns on/off the markup menu option to close
markups open for review.
TRUE – Default Turns on or off Brava’s ability Burn-in Markups
FALSE and output a CSF file.

11
EnableMarkupSaveAsDXF TRUE Saves Markups to Docbase as DXF file.
FALSE – Default Currently offers no benefit for TaskSpace users.

The following parameters control markup permissions and default markup permissions for users
with READ access.

EnableMarkupNew TRUE Turns on/off the ability to create a new markup.

FALSE – Default
EnableMarkupReview TRUE Turns on/off the ability to Review a markup.
FALSE – Default
EnableMarkupSaveAs TRUE Turns on/off the ability to Save a markup as…
FALSE – Default
EnableMarkupOpen TRUE Turns on/off the ability to open a markup for edit.
FALSE – Default
EnableMarkupSave TRUE Turns on/off the ability to save a markup without
FALSE – Default giving a markup open for editing a new name.

3.1 Uninstalling Brava! TaskSpace Components

At some point, you may choose to uninstall Brava! TaskSpace. To do this, run the Add or
Remove Programs command from your Control Panel.
Remove:
 Brava! Enterprise

3.2 Tips and Troubleshooting

Tips:
 Ensure that the ivf_config.XML is configured properly
 Ensure that the servlet engine that hosts the Brava! Server war (BravaServer.war) is
restarted when changes are made to the server.properties file. Changes to the
server_precedence.properties or client_precedence.properties do not require this
restart.

Troubleshooting:
 When using multiple instances of Brava! Viewer through TaskSpace, you may
receive the following warning after successfully launching a file in a new Brava!
window:
Warning: Page has Expired. The page you requested was created using
information you submitted in a form. This page is no longer
available. As a security precaution, Internet Explorer does not
automatically resubmit your information for you. To resubmit your
information and view this Web page, click the Refresh button.

12
 This error can be corrected by clearing your temporary internet files through
ToolsInternet Options of your browser window. From the General Tab, click Delete
Files in the Temporary Internet Files section and click OK.

4.0 Contacting Informative Graphics

If you need information on integrating and customizing Brava! Enterprise or if you
experience any problems or have any general inquiries, please feel free to contact us.

Informative Graphics Corp

4835 E. Cactus Road, Suite 445
Scottsdale, Arizona 85254-3548
Phone: (602) 971-6061
E-mail: info@infograph.com
Support: http://www.infograph.com/support/
M - F 5am to 5pm, Arizona time
Brava! Technical Information and Driver Updates:
http://www.infograph.com/support/BravaTechnicalSupport.htm
Web: www.infograph.com
ftp: ftp://ftp.infograph.com/

13