Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Wagon: Deploying sitegen to repository
  • Loading branch information
FuseSource CI committed Aug 13, 2013
1 parent abc67ed commit 43d1954
Show file tree
Hide file tree
Showing 4 changed files with 36 additions and 8 deletions.
28 changes: 28 additions & 0 deletions faq/index.html
Expand Up @@ -84,6 +84,34 @@ <h4 id = "How_do_I_disable_security_">How do I disable security?</h4>

<p>Here's how to <a href="https://github.com/hawtio/hawtio/blob/master/doc/Configuration.md#configuring-or-disabling-security-in-karaf-servicemix-fuse">disable security</a> if you wish to remove the need to login to hawtio.</p>

<h4 id = "How_do_I_connect_to_my_remote_JVM_">How do I connect to my remote JVM?</h4>

<p>All thats required for hawtio to connect to any remove JVM is that a <a href="http://jolokia.org/agent.html">jolokia agent</a> can be added to it. This can be done in various ways.</p>

<p>Firstly if you are using <a href="http://www.jboss.org/products/fuse">Fuse</a> or <a href="http://activemq.apache.org/">Apache ActiveMQ 5.9.x or later</a> then you already have jolokia enabled by default.</p>

<p>If a JVM has no jolokia agent, you can use the <strong>Local</strong> tab of the <strong>Connect</strong> menu (in 1.2.x or later of <strong>hawtio-default.war</strong>). The Local tab lists all local Java processes on the same machine (just like JConsole does).</p>

<p>For JVMs not running a jolokia agent already, there's a start button (on the right) which will dynamically add the <a href="http://jolokia.org/agent/jvm.html">jolokia JVM agent</a> into the selected JVM process. You can then click on the Agent URL link to connect into it.</p>

<p>Note that the Local plugin only works when the JVM running hawtio has the <strong>hawtio-local-jvm-mbean</strong> plugin installed (which depends on the JVM finding the com.sun.tools.attach.VirtualMachine API that jconsole uses and is included in the hawtio-default.war). BTW if you don't see a <strong>Local</strong> tab inside the <strong>Conect</strong> menu in your hawtio application; check the log of your hawtio JVM; there might be a warning around com.sun.tools.attach.VirtualMachine not being available on the classpath).</p>

<p>Note also that the <strong>Local</strong> tab only works when the process is on the same machine as the JVM running hawtio. So a safer option is just to make sure there's a jolokia agent running in each JVM you want to manage with hawtio.</p>

<p>There are a <a href="http://jolokia.org/agent.html">few different agents you can use</a>:</p>

<ul>
<li><a href="http://jolokia.org/agent/war.html">WAR agent</a> if you are using a servlet / EE container</li>
<li><a href="http://jolokia.org/agent/osgi.html">OSGi agent</a> if you are using OSGi (note that Jolokia is enabled by default in <a href="http://www.jboss.org/products/fuse">Fuse</a> so you don't have to worry)</li>
<li><a href="http://jolokia.org/agent/jvm.html">JVM agent</a> if you are using a stand alone Java process</li>
</ul>

<p>So once you've got a jolokia agent in your JVM you can test it by accessing http://host:port/jolokia in a browser to see if you can view the JSON returned for the version information of the jolokia agent.</p>

<p>Assuming you have jolokia working in your JVM, then you can use the <strong>Remote</strong> tab on the <strong>Connect</strong> menu in hawtio to connect; just enter the host, port, jolokia path and user/password.</p>

<p>After trying the above if you have problems connecting to your JVM, please <a href="http://hawt.io/community/index.html">let us know</a> by <a href="https://github.com/hawtio/hawtio/issues?state=open">raising an issue</a> and we'll try to help.</p>

<h4 id = "What_has_changed_lately_">What has changed lately?</h4>

<p>Try have a look at the <a href="http://hawt.io/changelog.html">change log</a> to see the latest changes in hawtio!</p>
Expand Down
12 changes: 6 additions & 6 deletions getstarted/index.html
Expand Up @@ -69,10 +69,10 @@ <h2 id = "Using_a_Servlet_Engine_or_Application_Server">Using a Servlet Engine o
<table class="buttonTable">
<tr>
<td>
<a class="btn btn-large btn-primary" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-default/1.2-M3/hawtio-default-1.2-M3.war">Download hawtio-default.war</a>
<a class="btn btn-large btn-primary" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-default/1.2-M4/hawtio-default-1.2-M4.war">Download hawtio-default.war</a>
</td>
<td>
<a class="btn btn-large btn-primary" href="https://oss.sonatype.org/content/repositories/public/io/hawt/sample/1.2-M3/sample-1.2-M3.war">Download sample.war</a>
<a class="btn btn-large btn-primary" href="https://oss.sonatype.org/content/repositories/public/io/hawt/sample/1.2-M4/sample-1.2-M4.war">Download sample.war</a>
</td>
</tr>
<tr>
Expand All @@ -90,12 +90,12 @@ <h2 id = "Using_a_Servlet_Engine_or_Application_Server">Using a Servlet Engine o

<p>If you rename the downloaded file to <em>hawtio.war</em> then drop it into your deploy directory then open <a href="http://localhost:8080/hawtio/">http://localhost:8080/hawtio/</a> and you should have your hawtio console to play with.</p>

<p>Otherwise you will need to use either <a href="http://localhost:8080/hawtio-default-1.2-M3/">http://localhost:8080/hawtio-default-1.2-M3/</a> or <a href="http://localhost:8080/sample-1.2-M3/">http://localhost:8080/sample-1.2-M3/</a> depending on the file name you downloaded.</p>
<p>Otherwise you will need to use either <a href="http://localhost:8080/hawtio-default-1.2-M4/">http://localhost:8080/hawtio-default-1.2-M4/</a> or <a href="http://localhost:8080/sample-1.2-M4/">http://localhost:8080/sample-1.2-M4/</a> depending on the file name you downloaded.</p>

<p>Please check <a href="http://hawt.io/configuration/index.html">the configuration guide</a> to see how to configure things; in particular security.</p>

<p>If you are working offline and have no access to the internet on the machines you want to use with hawtio then you may wish to
<a class="btn" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-default-offline/1.2-M3/hawtio-default-offline-1.2-M3.war">Download hawtio-default-offline.war</a> which avoids some pesky errors appearing in your log on startup (as the default behaviour is to clone a git repo on startup for some default wiki and dashboard content).</p>
<a class="btn" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-default-offline/1.2-M4/hawtio-default-offline-1.2-M4.war">Download hawtio-default-offline.war</a> which avoids some pesky errors appearing in your log on startup (as the default behaviour is to clone a git repo on startup for some default wiki and dashboard content).</p>

<p>To see whats changed lately check out the <a href="http://hawt.io/changelog.html">change log</a>.</p>

Expand All @@ -109,7 +109,7 @@ <h2 id = "Using_Fuse__Apache_Karaf_or_Apache_Servicemix">Using Fuse, Apache Kara

<p>Otherwise if you are using 6.0 or earlier of <a href="http://www.jboss.org/products/fuse">Fuse</a> or a vanilla <a href="http://karaf.apache.org/">Apache Karaf</a> or <a href="http://servicemix.apache.org/">Apache ServiceMix</a> then try the following:</p>

<pre><code>features:addurl mvn:io.hawt/hawtio-karaf/1.2-M3/xml/features
<pre><code>features:addurl mvn:io.hawt/hawtio-karaf/1.2-M4/xml/features
features:install hawtio</code></pre>

<p>The hawtio console can then be viewed at <a href="http://localhost:8181/hawtio/">http://localhost:8181/hawtio/</a>.</p>
Expand Down Expand Up @@ -148,7 +148,7 @@ <h3 id = "If_you_use_JBoss_AS_6_x">If you use JBoss AS 6.x</h3>

<p>If you use JBoss AS 7.x or later or use EAP 6.x or later the above should just work.</p>

<p>However for JBoss AS 6.x or earlier there is <a href="http://totalprogus.blogspot.co.uk/2011/06/javalanglinkageerror-loader-constraint.html">an issue with using newer versions of slf4j</a> so you must use <a class="btn" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-no-slf4j/1.2-M3/hawtio-no-slf4j-1.2-M3.war">Download hawtio-no-slf4j.war</a>.</p>
<p>However for JBoss AS 6.x or earlier there is <a href="http://totalprogus.blogspot.co.uk/2011/06/javalanglinkageerror-loader-constraint.html">an issue with using newer versions of slf4j</a> so you must use <a class="btn" href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-no-slf4j/1.2-M4/hawtio-no-slf4j-1.2-M4.war">Download hawtio-no-slf4j.war</a>.</p>

<p>To disable security <a href="http://www.mastertheboss.com/jboss-configuration/how-to-inject-system-properties-into-jboss">configure the system properties</a> by adding the following to your <strong>jboss-as/server/default/deploy/properties-service.xml</strong> file (which probably has the mbean definition already but commented out):</p>

Expand Down
2 changes: 1 addition & 1 deletion plugins/howPluginsWork.html
Expand Up @@ -60,7 +60,7 @@ <h1>How Plugins Work</h1>

<p>Currently hawtio uses JMX to discover which MBeans are present and then dynamically updates the navigation bars and tabs based on what it finds. The UI is updated whenever hawtio reloads the mbeans JSON; which it does periodically or a plugin can trigger explicitly.</p>

<p>So you can deploy the standard <a href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-web/1.2-M3/hawtio-web-1.2-M3.war">hawtio-web.war</a>; then as you deploy more services to your container, hawtio will update itself to reflect the suitable plugins in the UI.</p>
<p>So you can deploy the standard <a href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-web/1.2-M4/hawtio-web-1.2-M4.war">hawtio-web.war</a>; then as you deploy more services to your container, hawtio will update itself to reflect the suitable plugins in the UI.</p>

<p>Relying on JMX for discovery doesn't mean though that plugins can only interact with JMX; they can do anything at all that a browser can. e.g. a plugin could use REST to discover UI capabilities and other plugins.</p>

Expand Down
2 changes: 1 addition & 1 deletion plugins/index.html
Expand Up @@ -61,7 +61,7 @@ <h1 id = "hawtio_Plugins">hawtio Plugins</h1>

<h2 id = "Included_Plugins">Included Plugins</h2>

<p>The following plugins are all included by default in the <a href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-web/1.2-M3/hawtio-web-1.2-M3.war">hawtio-web.war</a> distro. You can see the <a href="https://github.com/hawtio/hawtio/tree/master/hawtio-web/src/main/webapp/app">source for the all default plugins here</a>.</p>
<p>The following plugins are all included by default in the <a href="https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-web/1.2-M4/hawtio-web-1.2-M4.war">hawtio-web.war</a> distro. You can see the <a href="https://github.com/hawtio/hawtio/tree/master/hawtio-web/src/main/webapp/app">source for the all default plugins here</a>.</p>

<table class="table">
<tr>
Expand Down

0 comments on commit 43d1954

Please sign in to comment.