Mercurial > hg > blitz_stable

comparison docs/serviceui.html @ 0:3dc0c5604566

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial checkin of blitz 2.0 fcs - no installer yet.
author Dan Creswell <dan.creswell@gmail.com>
date Sat, 21 Mar 2009 11:00:06 +0000
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:3dc0c5604566
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <head>
4 <title>ServiceUI Support</title>
5 <link rel="stylesheet" type="text/css" href="ssl.css" />
6 </head>
7 <body>
8 <h1>ServiceUI Support</h1>
9
10 <h3>JINI 2.0 vs JINI 2.1</h3>
11
12 <p>
13 All the command line examples below are designed for use with JINI 2.1. To make these command-lines work with JINI 2.0 substitute <code>jsk-platform.jar</code> for <code>jsk-lib.jar</code>
14 </p>
15 <h2>Getting Started</h2>
16
17 <p>Before you can configure and use the support for ServiceUI, you must download the ServiceUI v1.1 binaries (and source if you desire) from <a href="http://www.artima.com/jini/serviceui/CodeAccess.html">here</a> (note that you'll need a JINI.org login account).</p>
18
19 <p>To use the example config files provided in the Blitz distribution, unpack the ServiceUI distribution and copy the serviceui-1.1.jar to &lt;blitz_root&gt;/thirdpartylib where &lt;blitz_root&gt; is the root directory in which you've installed the Blitz distribution.</p>
20
21 <h2>Dashboard</h2>
22
23 <h3>Configuration Changes</h3>
24
25 <p>To use Dashboard as a ServiceUI, we must make additions to classpath and codebase, after which we must modify the initial attributes for the Blitz proxy.</p>
26
27 <p>First we change the codebase in the start <code>.config</code> to add the Blitz ServiceUI <code>.jar</code>:</p>
28
29 <pre>
30 private static codebase = ConfigUtil.concat(new Object[] {
31 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/",
32 "blitz-dl.jar"});
33 </pre>
34
35 <p>to:</p>
36
37 <pre>
38 private static codebase = ConfigUtil.concat(new Object[] {
39 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/",
40 "blitz-dl.jar", " ",
41 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/",
42 "blitzui.jar", " ",
43 "http://", ConfigUtil.getHostName(), ":", codebasePort, "/",
44 "backport-util-concurrent50.jar" // Or the JDK 1.4 version (remove the "50")
45 });
46 </pre>
47
48 <b>NOTE:</b> You will need to ensure the backport <code>.jar</code> is in the directory your codebase server distributes <code>.jar</code>s from.
49
50 <p>Then we modify the classpath to add both the Blitz ServiceUI .jar and the ServiceUI library .jar:</p>
51
52 <pre>
53 static classpath = ConfigUtil.concat(new Object[] {
54 jiniRoot, "jsk-lib.jar",
55 separator, jiniRoot, "sun-util.jar", separator, dbLib,
56 separator, blitzLib, "blitz.jar"});
57
58 </pre>
59
60 <p>to:</p>
61
62 <pre>
63 static classpath = ConfigUtil.concat(new Object[] {
64 jiniRoot, "jsk-lib.jar",
65 separator, jiniRoot, "sun-util.jar", separator, dbLib,
66 separator, blitzLib, "blitz.jar",
67 separator, blitzLib, "blitzui.jar",
68 separator, otherLib, "serviceui-1.1.jar"});
69 </pre>
70
71 <p>The initial registration attributes are set using the <code>initalAttrs</code> configuration variable in the <code>blitz.config</code> file - we must add some imports:</p>
72
73 <pre>
74 import net.jini.core.entry.Entry;
75 import org.dancres.blitz.serviceui.DashboardUI;
76 </pre>
77
78 <p>and the appropriate variable setting:</p>
79
80 <pre>
81 initialAttrs = new Entry[]
82 {org.dancres.blitz.serviceui.DashboardUI.getUIDescriptor()};
83 </pre>
84
85 <h3>Configuration Examples</h3>
86
87 <ul>
88 <li>Example start <a href="../config/serviceui-start21.config">config</a>.</li>
89 <li>Example blitz <a href="../config/blitz-ui.config">config</a>.</li>
90 </ul>
91
92 <h3>Note!</h3>
93
94 <p>For these changes to take effect, you must shutdown the Blitz instance if it's currently running, delete any log and state files (as specified by the <code>logDir</code> and <code>persistDir</code> variables) and then restart Blitz with the changes made as above.</p>
95 </body>
96 </html>