TopBraid Explorer and TopBraid Tagger and AutoClassifier

TopBraid Explorer and TopBraid Tagger and AutoClassifier are optional, separately licensed add-on modules for the EDG product. Each module entails some additional server installation. AutoClassifier has a Maui Indexer webapp, which can either run on the main EDG server or a separate server. Explorer has an EDG-like webapp for viewers, which should run on a separate (app-) server from the main EDG server where the source content is edited.

TopBraid Explorer Server

The Explorer server provides users with read-only access to versions of vocabularies or asset collections that have been published from a separate EDG editor server.

Prerequisite: The Explorer license in both license-files

Please ensure that both the EDG application and the EDG Explorer server are registered with the Explorer license, which means that each server's license file must contain the Explorer license. If either license file lacks the Explorer information, please contact support@topquadrant.com for the correct configuration of license files for your systems environment.

Explorer setup

The Explorer server is installed like any EDG server (see EDG Server Installation) with the following differences.

1. Explorer installation prerequisites (differences)

• Verify database compatibility between the Editor server and the Explorer server according to the Send Project to Another Server administrative function. For example, the Explorer server might require an independent, but compatible, database installation and RDBMS configuration.
• Via either Tomcat or LDAP, assign all Explorer users to a single, read-only role and no other roles.

2. Explorer initial administration (differences)

• (OPTIONAL) Ensure that the Explorer's Repository project name matches that of the editor-source EDG server.
• Configure Explorer's database settings for the published content (vs. the source content).
• In EDG Rights Management, assign the ExplorerGroup permission-group to the read-only security role (from LDAP or Tomcat).
• Configure the Explorer's source Editor server (URL and user login) in the Explorer Parameters section of EDG Administration: EDG Configuration Parameters.

3. Editor (source) EDG administration

Configure the editor-source server's Explorer server (URL and user login) in the Explorer Parameters section of EDG Administration: EDG Configuration Parameters.

Publishing to Explorer

After both servers are installed and configured, authorized users can publish edited source asset collections to the Explorer server and manage viewable versions. For details, see an appropriate asset collection type (e.g., taxonomy, ontology, etc.): Export > Publish [TYPE] for Explorer Users.

Installing the Maui Indexer for Tagger AutoClassifier

The TopBraid Tagger AutoClassifier component requires the Maui Indexer server. Like the TopBraid EDG server, the Maui server is a Java WAR-file application deployed to a Tomcat webapp server. Thus, installation involves copying the maui.war file to the Tomcat webapps directory or using Tomcat Manager to deploy maui.war. It can be installed on the same server where you are running TopBraid EDG.

Once the Tomcat server is restarted, no further configuration of the Maui server is necessary, however, we do recommend explicitly defining the data directory where Maui Server keeps its data. See the  Maui server documentation  for details. Most users should probably define the data directory by setting the MAUI_SERVER_DATA_DIR environment variable.  If the data directory is not explicitly defined, then it will default to the current directory from where the Tomcat webapp server was started, which can be a somewhat   random and undesirable location.

You may also use the servlet container's authentication features to protect the Maui Server web application with a username and password of your choice, using the HTTP Basic Authentication protocol.  In this case, the same credentials need to be specified in the AutoClassifier configuration in EDG.

Finally, an EDG administrator must configure EDG to point to Maui as described in Administration > EDG Configuration > AutoClassifier Configuration Parameters . For example, if you are running both EDG and Maui Server on the  example.com  server at port 8080, the Maui Server URL entered under the AutoClassifier Configuration Parameters section would be:  http://example.com:8080/mauiserver .