Dashboard installation within a runtime environment.
Copy the dashboard directory from the {deployment_location}/hyfinity/design/blueprints directory to the equivalent runtime directory. This will typically be {deployment_location}/hyfinity/runtime/blueprints
Copy the Dashboard webapp from the {deployment_location}/hyfinity/design/tomcat-design/webapps directory to the equivalent runtime directory. This will typically be {deployment_location}/hyfinity/runtime/tomcat-runtime/webapps, but will need to be adjusted accordingly based on your own webserver environment.
Copy the Dashboard_morphyc.xml file from the {deployment_location}/hyfinity/design/morphyc directory to the equivalent runtime directory. This will typically be {deployment_location}/hyfinity/runtime/morphyc
Now edit the web.xml file for the runtime Dashboard webapp to reflect the location of the runtime Dashboard_morphyc.xml file. The web.xml file will typically look like the following:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>Dashboard</servlet-name>
<servlet-class>com.hyfinity.xgate.HTTP2Java</servlet-class>
<init-param>
<param-name>morphyc</param-name>
<param-value>C:/jprogramfiles/hyfinity/runtime/morphyc/Dashboard_morphyc.xml</param-value>
</init-param>
<load-on-startup>10</load-on-startup>
</servlet>
<servlet>
<servlet-name>LogViewer</servlet-name>
<servlet-class>com.hyfinity.xlog.ViewLogServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>LogViewer</servlet-name>
<url-pattern>/viewLogs</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>Dashboard</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>30</session-timeout>
</session-config>
</web-app>
Finally change the Dashboard_morphyc.xml file to indicate the log file locations and also change the blueprints element to reflect the new location of the Dashboard blueprint within the runtime environment. Typically, the Dashboard_morphyc.xml file will look like the listing below. Please note that the xstore project element has been commented out since this is not required within the runtime environment.
<?xml version="1.0" encoding="UTF-8"?>
<morphyc xmlns="http://www.hyfinity.com/xfactory" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xfact="http://www.hyfinity.com/xfactory" xmlns:xg="http://www.hyfinity.com/xgate">
<xplatform mode="on-demand">
<pooling max="5" min="1" pooled="true" />
<platform_logging check_log_overrides="false" log="true">
<log_level>error</log_level>
<log_destination>C:/jprogramfiles/hyfinity/runtime/blueprints/xlog/Dashboard_platform_log.txt</log_destination>
<archive_previous_log>false</archive_previous_log>
</platform_logging>
<development_logging check_log_overrides="false" log="false">
<log_destination>C:/jprogramfiles/hyfinity/runtime/blueprints/xlog/Dashboard_development_log.txt</log_destination>
<archive_previous_log>false</archive_previous_log>
<log_agent_messages>true</log_agent_messages>
<log_rule_messages>true</log_rule_messages>
<log_rule_result_messages>false</log_rule_result_messages>
<log_rule_checking>true</log_rule_checking>
</development_logging>
<administration_logging log="false">
<log_destination>C:/jprogramfiles/hyfinity/runtime/blueprints/xlog/Dashboard_administration_log.txt</log_destination>
<archive_previous_log>false</archive_previous_log>
<log_session_activity>true</log_session_activity>
<log_cache_activity>true</log_cache_activity>
<log_asset_activity>true</log_asset_activity>
<log_engine_activity>true</log_engine_activity>
</administration_logging>
</xplatform>
<xfact:blueprints>
<!--<xfact:project desc="" location="C:/jprogramfiles/hyfinity/runtime/blueprints/xstore/mvc/" name="mvc-xstore" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hy="http://www.hyfinity.com/xengine" />-->
<xfact:project desc="" location="C:/jprogramfiles/hyfinity/runtime/blueprints/dashboard/mvc/" name="mvc-Dashboard" />
</xfact:blueprints>
</morphyc>
Dashboard Startup
Once installed, you can start the Dashboard using the URL http://<server>:<port>/Dashboard/index.html
Selecting the project to monitor
Unlike the design environment, the Dashboard does not know which project to load by default. You can select the project (morphyc file) path by using the browse button on the first screen of the Dashboard. Please note that the browse button will only work if the morphyc file is on the local machine. If a remote location is being used then please type in the correct path directly into the text box.
Refreshing logs
Within the runtime Dashboard you have to use the URL http://<server>:<port>/<webapp>/refresh_logs.do to refresh the logs in order to ensure revised log settings are applied to the running platform. Please remember that normally there is no need to restart the platform.