This blog is an archive. See our new blog at http://blog.mach-ii.com.

Some links may be outdated. Our Trac and SVN have moved:

Making Mach-II development a snap -- download the Dashboard

The dashboard beta is here! Kurt and I worked on the alpha pretty hard over the past few months and think that we've build a pretty handy development tool. A bunch of functionality is available to help you build Mach-II application faster to build and easier to maintain while deployed to production.  It's a quick list of what the dashboard can do for you:

  • Basic authentication (login page)
  • Reload base application or individual modules
  • Reload base ColdSpring bean factory or individual child factories
  • Manage logging include changing logging levels
  • Manage caching including charts of logging statistics
  • Recent exception snapshots for easy debugging
  • Basic server and application configuration information
  • JVM memory usage including charts of memory usage
  • Reload individual listeners, plugins, filters or properties (when using Mach-II 1.8 BER only)

Remember this is at an beta version and might be a few bugs along the way.  Check out the  Dashboard Home for screenshots and additional information.

By the way, the Dashboard requires our latest stable release - Mach-II 1.6.0 or try it with Mach-II 1.8 for event more features.

How to Install

  1. Download the dashboard code from http://www.mach-ii.com.
  1. Unzip the dashboard to your web root.
    1. For example, on Windows the default web root is [DRIVE]:\Inetpub\wwwroot, or if you are using your CFML server's built-in web server, your web root is likely [DRIVE]:\CFusionMX\wwwroot. If you are on a Unix system, your web root will vary.
    2. The end result of this step is that you should have the directory MachIIDashboard (no hyphen) in your web root. Inside this directory you will find the dashboard files.
    3. If you wish to place the core Mach-II Dashboard files in a location that is different from your webroot, just create a mapping called MachIIDashboard in the CFML administrator / control panel that points this mapping to the location where you placed the dashboard files.
  1. Add the dashboard as a module in your Mach-II application configuration file and set the password in the override XML section: 
    <modules>
       <module name="dashboard" file="/MachIIDashboard/config/mach-ii_dashboard.xml">
          <mach-ii>
             <properties>
                <property name="password" value="PLACE YOUR PASSWORD HERE" />
             </properties>
          </mach-ii>
       </module>
    </modules>
  2. Reload your Mach-II application and navigate to: 
    http://www.example.com/index.cfm?event=dashboard:info.index

(You may have to modify this url if you use a different event parameter other than "event")

0 Trackbacks  |  Announcements, Dashboard  |  Send
Posted 2/17/09 @ 6:30 PM by Peter J. Farrell

Comments

The Dashboard Home link is breaking.

Posted by Akbarsait at 2/18/09 3:42 AM

@Akbarsait, the link has been fixed. Leftovers from our SVN/Trac migrations (the new URLs only have an one character difference).

Posted by Peter J. Farrell at 2/18/09 9:29 AM