![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
1.
2. If H2 database is used, copy H2 driver jar (h2*.jar) to the lib folder of Tomcat (<CATALINA_HOME>/lib).
3. If TIBCO Rendezvous is used as the transport, copy the following JAR to the lib folder of Tomcat (<CATALINA_HOME>/lib):
− RV_HOME/lib/tibrvj.jar
4.
− EMS_HOME/lib/tibrvjms.jar
− EMS_HOME/lib/tibjms.jar
− EMS_HOME/lib/tibcrypt.jar
−
− PATH (Windows)
− LD_LIBRARY_PATH (Linux, Solaris)
− SHLIB_PATH (HP-UX)
− LIBPATH (AIX)
− DYLD_LIBRARY_PATH (MacOS)
The configuration file used to configure the domains is specified in web.xml under the 'main_servlet' definition.This file DomainTransportCfg.xml is available in the HAWK_HOME/webconsole/tomcat/webapps/hawkwebconsole/WEB-INF/conf folder.It follows the XML schema defined as per DomainTransportCfg.xsd. See the examples in the DomainTransportCfg.xml file for information on how to configure Hawk Domains and their respective transports.You can configure the Hawk domain and their respective transport for the Hawk Web Console. One or more Hawk domains can be managed. You require one DomainTransport section per managed domain. You must uncomment and configure the code for the DomainTransport section for the transport that you want to use and comment all other DomainTransport sections.
Configure a security policy for each domain independently using the <hk:SecurityPolicy> as shown in the preceding section. For more Information on Security Configuration, refer to Chapter 4, TIBCO Hawk Security Model.
The security policy of a domain is an optional tag. If the <hk:SecurityPolicy> tag is not present in the Domain configuration or is empty, the domain is initialized with no security policy.The WebConsole Server may or may not be configured to use a database. Persistence mode enabled refers to when a database is used for configuration and storage. The WebConsole Server uses the persistence mode by default. You can disable the persistence mode in web.xml. Depending on the selected mode, different aspects of the web applications are configured differently. The following sections cover these configuration options.The persistence mode can be enabled or disabled in web.xml as shown:<!-- Accepted values are either true or false, default value is true-->
TIBCO Hawk bundles a H2 database (http://www.h2database.com) for data persistence. You may choose to connect to an external database that is JDBC compliant
1. Define database resource in the hawkwebconsole web application's META-INF/context.xml as follows:
2. Define the resource reference in its web.xml as follows:Default auth_type is FILE that is, File based user repository is used.
To use auth_type as DATABASE, make sure persistence mode is enabled and Database configuration is done appropriately.
In the File based configuration, the users and passwords are stored in the hawkusers.xml file. To configure file based authentication:
1.
2. Configure the hawkusers.xml file as follows:Store the Hawk users file in the location HAWK_HOME\webconsole\tomcat\webapps\WEB-INF\conf. It has the following format:<user username="<username>" password="<MD5 hashed password or Plain text password>" roles="<user role>"/>WebConsole uses log4j for application logging. By default, the WebConsole logs are generated under CONFIG_FOLDER/logs/hawkwebconsole.log.You can modify the default log4j config file WEB-INF/conf/log4j_webconsole.properties or use your own properties file.You can configure the location of logs using the log4j.appender.RFileApp.File property in the log4j config file (WEB-INF/conf/log4j_webconsole.properties).By default, Tomcat server logs are generated at HAWK_HOME/webconsole/logs.
• Use a File Path: add the following entry in web.xml under the 'main_servlet' definition.Example of hawk_user_agent_cfg.txt is as follows:
# This file is used by agent running with "COM.TIBCO.hawk.security.trusted.Trusted" security model.
JAVA_HOME\bin\keytool -genkey -alias tomcat -keyalg RSA
3. The .keystore file with the Certificate is created in the same JDK installation folder.
5. Now, browse to the configuration folder of Hawk WebConsole and open server.xml for editing.HAWK_HOME/webconsole/tomcat/conf/server.xml
6. Enter the following information under the Catalina service tag <Service name="Catalina">:keystoreFile="<path of .keystore file>"To verify, type the URL "https://localhost:8443/hawkwebconsole/" in a web browser and press Enter. Web browser should display Hawk WebConsole.If persistence mode is disabled, the agent information is saved in an xml file, which does not require any configuration. By default, the application stores the agent information under <CATALINA_HOME>/AppData/hawk_agents.xml.The following example shows how the depth of alert/subscription caches in the browser (default=1000) can be set in web.xml:heatmap_update_type — Specifies if the heatmap can be updated automatically or at the specified time interval. Set the value to one of the following:
− auto —Updates heatmap automatically for optimal performance
− timer— Gives control to specify the rendering rate using the parameter "heatmap_render_rate"
− heatmap_render_rate— Specifies how often the heatmap is updated. Default value 10 seconds. The minimum value is 5 seconds.By default, the session persistence is disabled for WebConsole application with Tomcat restart. You can enable or disable the session persistence with Tomcat restart for Hawk WebConsole application. It is configurable in tomcat/webapps/hawkwebconsole/META-INF/context.xml.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |