Deploying DBQ Tool

You must deploy a DBQ application to your Java application server before you can start using DBQ Tool. To connect DBQ Tool to the Document Broker repository, an SSSP (StreamServe Service Provider) application must also be deployed to the Java application server.

Deployment in Control Center

You deploy the web application archive (WAR) files for the DBQ and SSSP applications in Control Center. For detailed information, see Deploying a web application in the Control Center documentation.

When you add a DBQ Tool application called <Name> in Control Center, the following WAR files are deployed:

WAR file	Application
<Name>_dbq.war	DBQ application
sssp.war	SSSP application If there is an SSSP application already deployed to the portal root, this SSSP application is automatically reused.

If Control Center is not available, you can deploy the web applications via the command line utilities. For more information, see the Command line utilities documentation.

Multiple application domains

You can link one DBQ Tool application to one or several application domains with StreamServer applications that collect documents. Each application domain can be linked to one single DBQ Tool application.

When the DBQ Tool application is linked to an application domain, and this application domain is linked to a Document Broker repository, the DBQ Tool can run queries against the documents in this Document Broker repository.

Dependencies in webportal.properties file

The dependency between the DBQ application and the SSSP application is defined in a webportal.properties file. The file also contains information about the application domains that the web application is linked to.

The webportal.properties file is generated when you link the DBQ Tool application to an application domain and resides in the following directory:

<Portal root>\<Name>_dbq\WEB-INF\spring\properties

If you update the linking, the webportal.properties file is automatically updated in the \properties folders in the portal root or manual deploy path.

Note:

Updated files in the manual deploy path must be manually copied to the Java application server.

Service gateway in application domain configuration file

The SSSP application uses web services, hosted by a service gateway, to access the Document Broker repository. The service gateway is defined in the application domain configuration file.

When you link the DBQ Tool application to an application domain, the application domain configuration file is automatically copied to the following directory:

<Portal root>\sssp\domains

If you update the application domain configuration, the application domain configuration file is automatically updated in the \domains folder in the portal root or manual deploy path.

Note:

Updated files in the manual deploy path must be manually copied to the Java application server.

Keep customized property files

If you redeploy the WAR files, for example to apply a hotfix, any customizations that you have made to the property files are overwritten.

To keep customizations, you can use an external directory outside the portal root for the property files. For more information, see Keeping customized configuration files in the Control Center documentation.