Skip to content

Commit

Permalink
Wagon: Deploying sitegen to repository
Browse files Browse the repository at this point in the history
  • Loading branch information
FuseSource CI committed Aug 1, 2013
1 parent 71cf567 commit 3526586
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 68 deletions.
6 changes: 6 additions & 0 deletions faq/index.html
View file
Expand Up @@ -78,6 +78,12 @@ <h4 id = "How_do_I_configure_hawtio_">How do I configure hawtio?</h4>

<p>Mostly hawtio just works. However, please check out the <a href="http://hawt.io/configuration/index.html">Configuration Guide</a> to see what kinds of things you can configure via system properties, environment variables, web.xml context-params or dependency injection.</p>

<h4 id = "How_do_I_disable_security_">How do I disable security?</h4>

<p>Since 1.2-M2 of hawtio we enable security by default using the underlying application container's security mechanism.</p>

<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 = "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
99 changes: 31 additions & 68 deletions getstarted/index.html
View file
Expand Up @@ -92,80 +92,15 @@ <h2 id = "Using_a_Servlet_Engine_or_Application_Server">Using a Servlet Engine o

<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>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
<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>

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

<p>If you don't see a Tomcat / Jetty / JBoss tab for your container you may need to enable JMX.</p>

<h3 id = "Configuring_Security">Configuring Security</h3>

<p>By default the security in hawtio uses these system properties which you can override:</p>

<table class="buttonTable">
<tr>
<th>Name</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<td>
hawtio.authenticationEnabled
</td>
<td>
true
</td>
<td>
Whether or not security is enabled
</td>
</tr>
<tr>
<td>
hawtio.role
</td>
<td>
admin
</td>
<td>
The user role required to be able to login to the console
</td>
</tr>
<tr>
<td>
hawtio.realm
</td>
<td>
karaf
</td>
<td>
The security realm used to login
</td>
</tr>
</table>

<h3 id = "Enable_JMX_on_Jetty_8_x">Enable JMX on Jetty 8.x</h3>

<p>If you are using Jetty 8.x then JMX may not enabled by default, so make sure the following line is not commented out in <strong>jetty-distribution/start.ini</strong> (you may have to uncomment it to enable JMX).</p>

<pre><code>etc/jetty-jmx.xml</code></pre>

<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>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>

<pre><code>&lt;mbean code="org.jboss.varia.property.SystemPropertiesService"
name="jboss:type=Service,name=SystemProperties"&gt;

&lt;attribute name="Properties"&gt;
hawtio.authenticationEnabled=false
&lt;/attribute&gt;
&lt;/mbean&gt;</code></pre>

<h2 id = "Using_Fuse__Apache_Karaf_or_Apache_Servicemix">Using Fuse, Apache Karaf or Apache Servicemix</h2>

<p>If you are using 6.1 or later of <a href="http://www.jboss.org/products/fuse">JBoss Fuse</a> you can run:</p>
Expand All @@ -179,6 +114,8 @@ <h2 id = "Using_Fuse__Apache_Karaf_or_Apache_Servicemix">Using Fuse, Apache Kara

<p>The hawtio console can then be viewed at <a href="http://localhost:8181/hawtio/">http://localhost:8181/hawtio/</a>.</p>

<p><strong>NOTE</strong> if you are on ServiceMix 4.5 or earlier then hawtio 1.2-M2 or later has security enabled by default. There is a <a href="https://github.com/hawtio/hawtio/issues/438">pending issue with security and ServiceMix</a>; until that is resolved please <a href="https://github.com/hawtio/hawtio/blob/master/doc/Configuration.md#configuring-or-disabling-security-in-karaf-servicemix-fuse">disable security</a></p>

<h3 id = "If_you_use_a_HTTP_proxy">If you use a HTTP proxy</h3>

<p>If you are behind a http proxy; you will need to enable HTTP Proxy support in Fuse / Karaf / ServiceMix to be able to download hawtio from the central maven repository.</p>
Expand All @@ -197,6 +134,32 @@ <h3 id = "If_you_use_a_HTTP_proxy">If you use a HTTP proxy</h3>

<p>If you're still struggling getting your HTTP proxy to work with Fuse, try jump on the <a href="https://community.jboss.org/en/jbossfuse">Fuse Form and ask for more help</a>.</p>

<h2 id = "Other_containers">Other containers</h2>

<p>The following section gives details of other containers</p>

<h3 id = "Enable_JMX_on_Jetty_8_x">Enable JMX on Jetty 8.x</h3>

<p>If you are using Jetty 8.x then JMX may not enabled by default, so make sure the following line is not commented out in <strong>jetty-distribution/start.ini</strong> (you may have to uncomment it to enable JMX).</p>

<pre><code>etc/jetty-jmx.xml</code></pre>

<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>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>

<pre><code>&lt;mbean code="org.jboss.varia.property.SystemPropertiesService"
name="jboss:type=Service,name=SystemProperties"&gt;

&lt;attribute name="Properties"&gt;
hawtio.authenticationEnabled=false
&lt;/attribute&gt;
&lt;/mbean&gt;</code></pre>

<h2 id = "Using_hawtio_inside_a_stand_alone_Java_application">Using hawtio inside a stand alone Java application</h2>

<p>If you do not use a servlet container or application server and wish to embed hawtio inside your process try the following:</p>
Expand Down

0 comments on commit 3526586

Please sign in to comment.