Skip to content

O
Openfire
Commit a61ed402 authored by Ryan Graham's avatar Ryan Graham Committed by ryan
Browse files
Options

added new page design to the documenation, converted any instance of '2.6.x'... 

added new page design to the documenation, converted any instance of '2.6.x' in the text to '3.0.0' (only occurred on the installation guide page).

git-svn-id: http://svn.igniterealtime.org/svn/repos/wildfire/trunk@4167 b35dd754-fafc-0310-a699-88a17e54d16e
parent 01b8adf5
Expand all Show whitespace changes
Inline Side-by-side
Showing with 750 additions and 237 deletions
documentation/docs/database-guide.html
View file @ a61ed402
This diff is collapsed.
documentation/docs/database.html
View file @ a61ed402
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Wildfire Database Documentation</title> <title>Jive Software - Wildfire: Database Installation Guide</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
</head> </head>
<body> <body>
<h1><a name="introduction">Wildfire Database Setup</a></h1>
<div id="pageContainer">
<a name="top"></a>
<div id="pageHeader">
<div id="logo"></div>
<h1>Database Installation Guide</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<p>Wildfire stores all data in a back-end database. If you choose to not use the embedded <p>Wildfire stores all data in a back-end database. If you choose to not use the embedded
database, you must setup and manage an external database for the application. database, you must setup and manage an external database for the application.
...@@ -310,5 +324,9 @@ Choose your database from the list below for setup details: ...@@ -310,5 +324,9 @@ Choose your database from the list below for setup details:
</ol> </ol>
</ul> </ul>
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/index.html
View file @ a61ed402
...@@ -2,13 +2,21 @@ ...@@ -2,13 +2,21 @@
<html> <html>
<head> <head>
<title>Wildfire: Overview - Jive Software</title> <title>Jive Software - Wildfire: Overview</title>
<link type="text/css" rel="stylesheet" href="style.css"> <link type="text/css" rel="stylesheet" href="style.css">
</head> </head>
<body> <body>
<h1>Wildfire @version@</h1> <div id="pageContainer">
<div id="pageHeader">
<div id="logo"></div>
<h1>Wildfire @version@</h1>
</div>
<div class="navigation">
</div>
<div id="pageBody">
<p> <p>
Wildfire provides comprehensive group chat and instant Wildfire provides comprehensive group chat and instant
...@@ -65,10 +73,16 @@ messaging (IM) services using the XMPP protocol. ...@@ -65,10 +73,16 @@ messaging (IM) services using the XMPP protocol.
</li> </li>
</ul> </ul>
<br>
<p> <p>
An active support community for Wildfire is available at An active support community for Wildfire is available at
<a href="http://www.jivesoftware.org/forums/">http://www.jivesoftware.org/forums/</a>. <a href="http://www.jivesoftware.org/forums/">http://www.jivesoftware.org/forums/</a>.
</p> </p>
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/install-guide.html
View file @ a61ed402
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Jive Software Wildfire Readme</title> <title>Jive Software - Wildfire: Installation Guide</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
</head> </head>
<body> <body>
<h1>Wildfire Installation Guide</h1>
<div id="pageContainer">
<a name="top"></a>
<div id="pageHeader">
<div id="logo"></div>
<h1>Installation Guide</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<p>Wildfire is a powerful instant messaging (IM) and chat <p>Wildfire is a powerful instant messaging (IM) and chat
server that implements the XMPP protocol. This document will guide server that implements the XMPP protocol. This document will guide
...@@ -23,11 +37,12 @@ Run the Wildfire installer. The application will be installed to <tt>c:\Program ...@@ -23,11 +37,12 @@ Run the Wildfire installer. The application will be installed to <tt>c:\Program
Choose either the RPM or tar.gz build. If using the RPM, run it using your package manager to install Wildfire to <tt>/opt/wildfire</tt>: Choose either the RPM or tar.gz build. If using the RPM, run it using your package manager to install Wildfire to <tt>/opt/wildfire</tt>:
<p><tt>rpm -ivh wildfire_2_4_0.rpm</tt></p> <p><tt>rpm -ivh wildfire_3_0_0.rpm</tt></p>
If using the .tar.gz, extract the archive to <tt>/opt</tt> or <tt>/usr/bin</tt>: If using the .tar.gz, extract the archive to <tt>/opt</tt> or <tt>/usr/bin</tt>:
<p><tt>tar -xzvf wildfire_2_4_0.tar.gz<br> <p><tt>tar -xzvf wildfire_3_0_0.tar.gz<br>
mv wildfire /opt</tt></p> mv wildfire /opt</tt></p>
<p><b>Note:</b> the .tar.gz build does not contain a bundled Java runtime (JRE). Therefore, you must have JDK or JRE 1.5.0 (Java 5) or later installed on your system. You can check your java version by typing "java -version" at the command line and (if necessary) upgrade your Java installation by visiting http://java.sun.com.</p> <p><b>Note:</b> the .tar.gz build does not contain a bundled Java runtime (JRE). Therefore, you must have JDK or JRE 1.5.0 (Java 5) or later installed on your system. You can check your java version by typing "java -version" at the command line and (if necessary) upgrade your Java installation by visiting http://java.sun.com.</p>
...@@ -41,6 +56,7 @@ perform each of the following steps: </p> ...@@ -41,6 +56,7 @@ perform each of the following steps: </p>
prepare your database for Wildfire. </li> prepare your database for Wildfire. </li>
<li><a href="#config">Setup</a> - Use the built-in web-based setup <li><a href="#config">Setup</a> - Use the built-in web-based setup
tool to setup and verify the server configuration.</li> tool to setup and verify the server configuration.</li>
<li><a href="#tools">Admin Console</a> - use the web-based admin tool to <li><a href="#tools">Admin Console</a> - use the web-based admin tool to
manage the server.</li> manage the server.</li>
</ol> </ol>
...@@ -50,6 +66,7 @@ manage the server.</li> ...@@ -50,6 +66,7 @@ manage the server.</li>
<ul> <ul>
<li><a href="#windows">Running under Windows</a> <li><a href="#windows">Running under Windows</a>
<li><a href="#unix">Running under Unix/Linux</a> <li><a href="#unix">Running under Unix/Linux</a>
<li><a href="#plugins">Installing and using plugins</a> <li><a href="#plugins">Installing and using plugins</a>
</ul> </ul>
...@@ -73,11 +90,13 @@ sub-directories omitted for brevity): </p> ...@@ -73,11 +90,13 @@ sub-directories omitted for brevity): </p>
<ul> <ul>
<li>The <tt>conf</tt> directory is where Wildfire stores <li>The <tt>conf</tt> directory is where Wildfire stores
configuration files.</li> configuration files.</li>
<li>The <tt>bin</tt> directory contains the server executables. Depending <li>The <tt>bin</tt> directory contains the server executables. Depending
on which distribution you installed, different executables will be available.</li> on which distribution you installed, different executables will be available.</li>
<li>The <tt>jre</tt> directory contains a Java 5 runtime that is bundled with the Windows and RPM versions of Wildfire.</li> <li>The <tt>jre</tt> directory contains a Java 5 runtime that is bundled with the Windows and RPM versions of Wildfire.</li>
<li>The <tt>lib</tt> directory contains libraries necessary for <li>The <tt>lib</tt> directory contains libraries necessary for
running Wildfire.</li> running Wildfire.</li>
<li>The <tt>plugins</tt> directory contains server plugins. By <li>The <tt>plugins</tt> directory contains server plugins. By
default, Wildfire ships with a web-based admin console plugin.</li> default, Wildfire ships with a web-based admin console plugin.</li>
<li>The <tt>resources/database</tt> directory contains SQL schema files to <li>The <tt>resources/database</tt> directory contains SQL schema files to
...@@ -85,6 +104,7 @@ create new Wildfire databases, as well as upgrade scripts for ...@@ -85,6 +104,7 @@ create new Wildfire databases, as well as upgrade scripts for
existing installations. </li> existing installations. </li>
<li>The <tt>resources/security</tt> directory is where Wildfire <li>The <tt>resources/security</tt> directory is where Wildfire
maintains keystores to support SSL connection security.</li> maintains keystores to support SSL connection security.</li>
<li>The <tt>documentation</tt> directory contains server <li>The <tt>documentation</tt> directory contains server
documentation.</li> documentation.</li>
</ul><p> </ul><p>
...@@ -134,6 +154,7 @@ run Wildfire as a standard Windows service after initial setup. ...@@ -134,6 +154,7 @@ run Wildfire as a standard Windows service after initial setup.
If you used the Windows installer, a <tt>wildfire-service.exe</tt> file If you used the Windows installer, a <tt>wildfire-service.exe</tt> file
will be in the <tt>bin</tt> directory of the installation. You can use will be in the <tt>bin</tt> directory of the installation. You can use
this executable to install and control the Wildfire service. this executable to install and control the Wildfire service.
</p> </p>
From a console window, you can run the following commands: From a console window, you can run the following commands:
...@@ -142,6 +163,7 @@ From a console window, you can run the following commands: ...@@ -142,6 +163,7 @@ From a console window, you can run the following commands:
<li><tt>wildfire-service /uninstall</tt> -- uninstalls the service. <li><tt>wildfire-service /uninstall</tt> -- uninstalls the service.
<li><tt>wildfire-service /start</tt> -- starts the service <li><tt>wildfire-service /start</tt> -- starts the service
<li><tt>wildfire-service /stop</tt> -- stops the service. <li><tt>wildfire-service /stop</tt> -- stops the service.
</ul> </ul>
<p> <p>
...@@ -178,6 +200,7 @@ You can start and stop Wildfire using the <tt>bin/wildfire</tt> script in your W ...@@ -178,6 +200,7 @@ You can start and stop Wildfire using the <tt>bin/wildfire</tt> script in your W
<p> <p>
<tt> <tt>
# ./wildfire<br> # ./wildfire<br>
Usage: ./wildfire {start|stop}<br> Usage: ./wildfire {start|stop}<br>
# ./wildfire start<br> # ./wildfire start<br>
Starting wildfire Starting wildfire
...@@ -189,6 +212,7 @@ directory: ...@@ -189,6 +212,7 @@ directory:
<li>redhat-postinstall.sh -- automatically installs Wildfire as a service on Red Hat. It does so by creating a "jive" user and then copying the wildfired script to your init.d directory. This script must be run as root. Please see the comments in the script for additional information.</li> <li>redhat-postinstall.sh -- automatically installs Wildfire as a service on Red Hat. It does so by creating a "jive" user and then copying the wildfired script to your init.d directory. This script must be run as root. Please see the comments in the script for additional information.</li>
<li>wildfired -- script to run Wildfire as a service. You must manually configure this script. See the comments in <li>wildfired -- script to run Wildfire as a service. You must manually configure this script. See the comments in
the script for additional details.</li> the script for additional details.</li>
</ul> </ul>
<h2><a name="plugins">Plugins</a></h2> <h2><a name="plugins">Plugins</a></h2>
...@@ -211,5 +235,9 @@ Plugins can be managed inside the Wildfire admin console. You can also manually ...@@ -211,5 +235,9 @@ Plugins can be managed inside the Wildfire admin console. You can also manually
deleting its JAR file (Wildfire will automatically remove the plugin from memory and delete it's directory when you deleting its JAR file (Wildfire will automatically remove the plugin from memory and delete it's directory when you
do so). do so).
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/ldap-guide.html
View file @ a61ed402
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Wildfire LDAP Guide</title> <title>Jive Software - Wildfire: LDAP Guide</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
</head> </head>
<body> <body>
<div id="pageContainer">
<a name="top"></a> <a name="top"></a>
<h1>Wildfire LDAP Guide</h1> <div id="pageHeader">
<div id="logo"></div>
<h1>LDAP Guide</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<h2>Introduction</h2> <h2>Introduction</h2>
...@@ -31,6 +42,7 @@ ...@@ -31,6 +42,7 @@
such as <a href="http://www.openldap.org/">Open LDAP</a>, such as <a href="http://www.openldap.org/">Open LDAP</a>,
<a href="http://www.microsoft.com/windowsserver2003/technologies/directory/activedirectory/">Active Directory</a>, <a href="http://www.microsoft.com/windowsserver2003/technologies/directory/activedirectory/">Active Directory</a>,
and Novell's <a href="http://www.novell.com/products/edirectory/">eDirectory</a>. and Novell's <a href="http://www.novell.com/products/edirectory/">eDirectory</a>.
</p> </p>
<p> <p>
...@@ -57,6 +69,7 @@ ...@@ -57,6 +69,7 @@
<p> <p>
In order to configure your server to use LDAP: In order to configure your server to use LDAP:
<ol> <ol>
<li> <li>
Stop Wildfire. Stop Wildfire.
</li> </li>
...@@ -67,6 +80,7 @@ ...@@ -67,6 +80,7 @@
Restart Wildfire. Restart Wildfire.
</li> </li>
</ol> </ol>
</p> </p>
<h3>Editing the Config File</h3> <h3>Editing the Config File</h3>
...@@ -79,6 +93,7 @@ ...@@ -79,6 +93,7 @@
must be set. Properties flagged with (<font color="red"><b>**</b></font>) must be set in order must be set. Properties flagged with (<font color="red"><b>**</b></font>) must be set in order
to enable LDAP group to enable LDAP group
support, all other properties are optional: support, all other properties are optional:
</p> </p>
<ul> <ul>
<b>Main Settings</b><br><br> <b>Main Settings</b><br><br>
...@@ -87,6 +102,7 @@ ...@@ -87,6 +102,7 @@
"org.jivesoftware.wildfire.ldap.LdapUserProvider".</li> "org.jivesoftware.wildfire.ldap.LdapUserProvider".</li>
<li>provider.auth.className <font color="red"><b>*</b></font> -- set the value to <li>provider.auth.className <font color="red"><b>*</b></font> -- set the value to
"org.jivesoftware.wildfire.ldap.LdapAuthProvider".</li> "org.jivesoftware.wildfire.ldap.LdapAuthProvider".</li>
<li>ldap.host <font color="red"><b>*</b></font> -- LDAP server host; e.g. localhost or <li>ldap.host <font color="red"><b>*</b></font> -- LDAP server host; e.g. localhost or
machine.example.com, etc. It is possible to use many LDAP servers but all of them machine.example.com, etc. It is possible to use many LDAP servers but all of them
<b>should share the same configuration</b> (e.g. SSL, baseDN, admin account, etc). <b>should share the same configuration</b> (e.g. SSL, baseDN, admin account, etc).
...@@ -97,6 +113,7 @@ ...@@ -97,6 +113,7 @@
will performed with. will performed with.
The entire subtree under the base DN will be searched for user accounts. The entire subtree under the base DN will be searched for user accounts.
</li> </li>
<li>ldap.alternateBaseDN -- a second DN in the directory can optionally be set. If set, the <li>ldap.alternateBaseDN -- a second DN in the directory can optionally be set. If set, the
alternate base DN alternate base DN
will be used for authentication and loading single users, but will not be used to display a will be used for authentication and loading single users, but will not be used to display a
...@@ -117,6 +134,7 @@ ...@@ -117,6 +134,7 @@
<li>ldap.nameField -- the field name that holds the user's name. If this property is not <li>ldap.nameField -- the field name that holds the user's name. If this property is not
set, the default value is <tt>cn</tt>. Active Directory users should use the default value set, the default value is <tt>cn</tt>. Active Directory users should use the default value
<tt>displayName</tt>.</li> <tt>displayName</tt>.</li>
<li>ldap.emailField -- the field name that holds the user's email address. If this property <li>ldap.emailField -- the field name that holds the user's email address. If this property
is not set, the default value is <tt>mail</tt>. Active Directory users should use the is not set, the default value is <tt>mail</tt>. Active Directory users should use the
the default value <tt>mail</tt>.</li> the default value <tt>mail</tt>.</li>
...@@ -130,10 +148,6 @@ ...@@ -130,10 +148,6 @@
<li>ldap.searchFilter -- the search filter that should be used when loading users. If this <li>ldap.searchFilter -- the search filter that should be used when loading users. If this
property is not set, the default search will be for users that have the attribute specified by property is not set, the default search will be for users that have the attribute specified by
ldap.usernameField. ldap.usernameField.
<li>ldap.subTreeSearch -- the value "true" if the entire sub-tree under the base DN should
be included when executing searches (recursive search). If the value "false" is set, only
the first level under the base DN will be searched. The default value is "true", which is the better
option for the majority of directory layouts. Only set the value to "false" if necessary.</li>
<br><br> <br><br>
<b>Group Settings</b><br><br> <b>Group Settings</b><br><br>
...@@ -144,6 +158,7 @@ ...@@ -144,6 +158,7 @@
lookups will be performed on. If this property is not set, the default value is <tt>cn</tt>.</li> lookups will be performed on. If this property is not set, the default value is <tt>cn</tt>.</li>
<li>ldap.groupMemberField -- the field name that holds the members in a group. If this property <li>ldap.groupMemberField -- the field name that holds the members in a group. If this property
is not set, the default value is <tt>member</tt>.</li> is not set, the default value is <tt>member</tt>.</li>
<li>ldap.groupDescriptionField -- the field name that holds the description a group. If this <li>ldap.groupDescriptionField -- the field name that holds the description a group. If this
property is not set, the default value is <tt>description</tt>.</li> property is not set, the default value is <tt>description</tt>.</li>
<li>ldap.posixMode <font color="red"><b>**</b></font> -- a value of "true" means that users are stored within the group by their <li>ldap.posixMode <font color="red"><b>**</b></font> -- a value of "true" means that users are stored within the group by their
...@@ -151,6 +166,7 @@ ...@@ -151,6 +166,7 @@
the group. If this property is not set, the default value is <tt>false</tt>. <b>Note:</b> the group. If this property is not set, the default value is <tt>false</tt>. <b>Note:</b>
the posix mode must be set correctly for your server in order for group integration to the posix mode must be set correctly for your server in order for group integration to
work.</li> work.</li>
<li>ldap.groupSearchFilter -- the search filter that should be used when loading groups. If this <li>ldap.groupSearchFilter -- the search filter that should be used when loading groups. If this
property is not set, the default value is <tt>("ldap.groupNameField"={0})</tt>.</li> property is not set, the default value is <tt>("ldap.groupNameField"={0})</tt>.</li>
...@@ -164,6 +180,7 @@ ...@@ -164,6 +180,7 @@
you you
enable SSL connections, the LDAP server port number most likely should be changed to enable SSL connections, the LDAP server port number most likely should be changed to
636.</li> 636.</li>
<li>ldap.initialContextFactory -- the name of the class that should be used as an initial <li>ldap.initialContextFactory -- the name of the class that should be used as an initial
context context
factory. if this value is not specified, "com.sun.jndi.ldap.LdapCtxFactory" will be used factory. if this value is not specified, "com.sun.jndi.ldap.LdapCtxFactory" will be used
...@@ -183,33 +200,38 @@ ...@@ -183,33 +200,38 @@
<p> <p>
Below is a sample config file section: Below is a sample config file section:
</p> </p>
<pre><code> <pre>
&lt;jive&gt; &lt;jive&gt;
... ...
&lt;ldap&gt; &lt;ldap&gt;
&lt;host&gt;&lt;/host&gt; &lt;host&gt;&lt;/host&gt;
&lt;port>389&lt;/port&gt; &lt;port>389&lt;/port&gt;
&lt;usernameField&gt;uid&lt;/usernameField&gt; &lt;usernameField&gt;uid&lt;/usernameField&gt;
&lt;nameField&gt;cn&lt;/nameField&gt; &lt;nameField&gt;cn&lt;/nameField&gt;
&lt;emailField&gt;mail&lt;/emailField&gt; &lt;emailField&gt;mail&lt;/emailField&gt;
&lt;baseDN&gt;ou=People;dc=example;dc=com&lt;/baseDN&gt; &lt;baseDN&gt;ou=People;dc=example;dc=com&lt;/baseDN&gt;
&lt;adminDN&gt;cn=Directory Administrator&lt;/adminDN&gt; &lt;adminDN&gt;cn=Directory Administrator&lt;/adminDN&gt;
&lt;adminPassword&gt;&lt;/adminPassword&gt; &lt;adminPassword&gt;&lt;/adminPassword&gt;
&lt;/ldap&gt; &lt;/ldap&gt;
&lt;provider&gt; &lt;provider&gt;
&lt;user&gt; &lt;user&gt;
&lt;className&gt;org.jivesoftware.wildfire.ldap.LdapUserProvider&lt;/className&gt; &lt;className&gt;org.jivesoftware.wildfire.ldap.LdapUserProvider&lt;/className&gt;
&lt;/user&gt; &lt;/user&gt;
&lt;auth&gt; &lt;auth&gt;
&lt;className&gt;org.jivesoftware.wildfire.ldap.LdapAuthProvider&lt;/className&gt; &lt;className&gt;org.jivesoftware.wildfire.ldap.LdapAuthProvider&lt;/className&gt;
&lt;/auth&gt; &lt;/auth&gt;
&lt;group&gt; &lt;group&gt;
&lt;className&gt;org.jivesoftware.wildfire.ldap.LdapGroupProvider&lt;/className&gt; &lt;className&gt;org.jivesoftware.wildfire.ldap.LdapGroupProvider&lt;/className&gt;
&lt;/group&gt; &lt;/group&gt;
&lt;/provider&gt; &lt;/provider&gt;
... ...
&lt;/jive&gt; &lt;/jive&gt;
</code></pre> </pre>
<p>You'll most likely want to change which usernames are authorized to login to the <p>You'll most likely want to change which usernames are authorized to login to the
admin console. By default, only the user with username "admin" is allowed to login. However, admin console. By default, only the user with username "admin" is allowed to login. However,
...@@ -217,16 +239,17 @@ ...@@ -217,16 +239,17 @@
list of authorized usernames is controlled via the <tt>admin.authorizedUsernames</tt> list of authorized usernames is controlled via the <tt>admin.authorizedUsernames</tt>
property. For example, to let the usersnames "joe" and "jane" login to the admin console:</p> property. For example, to let the usersnames "joe" and "jane" login to the admin console:</p>
<pre><code> <pre>
&lt;jive&gt; &lt;jive&gt;
... ...
&lt;admin&gt; &lt;admin&gt;
... ...
&lt;authorizedUsernames&gt;joe, jane&lt;/authorizedUsernames&gt; &lt;authorizedUsernames&gt;joe, jane&lt;/authorizedUsernames&gt;
&lt;/admin&gt; &lt;/admin&gt;
... ...
&lt;/jive&gt; &lt;/jive&gt;
</code></pre> </pre>
<p><a name=""><h2>Custom Search Filter</h2></a></p> <p><a name=""><h2>Custom Search Filter</h2></a></p>
...@@ -256,6 +279,7 @@ ...@@ -256,6 +279,7 @@
<p><a name="ctxFactory"><h2>Custom Inital Context Factory</h2></a></p> <p><a name="ctxFactory"><h2>Custom Inital Context Factory</h2></a></p>
<p> <p>
Some LDAP servers or application servers may require that a different LDAP Some LDAP servers or application servers may require that a different LDAP
initial context factory be used rather than the default (com.sun.jndi.ldap.LdapCtxFactory). initial context factory be used rather than the default (com.sun.jndi.ldap.LdapCtxFactory).
You can set a custom initial context factory by adding the following to wildfire.xml: You can set a custom initial context factory by adding the following to wildfire.xml:
...@@ -278,6 +302,7 @@ ...@@ -278,6 +302,7 @@
<pre>&lt;ldap&gt; <pre>&lt;ldap&gt;
... other ldap settings here ... other ldap settings here
&lt;connectionPoolEnabled&gt;false&lt;/connectionPoolEnabled&gt; &lt;connectionPoolEnabled&gt;false&lt;/connectionPoolEnabled&gt;
&lt;/ldap&gt;</pre></p> &lt;/ldap&gt;</pre></p>
<p> <p>
...@@ -304,6 +329,7 @@ clients that support the XMPP vCard extension. First, enable the provider:</p> ...@@ -304,6 +329,7 @@ clients that support the XMPP vCard extension. First, enable the provider:</p>
<pre> <pre>
&lt;provider&gt; &lt;provider&gt;
... ...
&lt;vcard&gt; &lt;vcard&gt;
&lt;className&gt;org.jivesoftware.wildfire.ldap.LdapVCardProvider&lt;/className&gt; &lt;className&gt;org.jivesoftware.wildfire.ldap.LdapVCardProvider&lt;/className&gt;
...@@ -327,39 +353,47 @@ clients that support the XMPP vCard extension. First, enable the provider:</p> ...@@ -327,39 +353,47 @@ clients that support the XMPP vCard extension. First, enable the provider:</p>
<pre> <pre>
&lt;ldap&gt; &lt;ldap&gt;
&lt;vcard-mapping&gt; &lt;vcard-mapping&gt;
&lt;![CDATA[ &lt;![CDATA[
&lt;vCard xmlns='vcard-temp'&gt; &lt;vCard xmlns='vcard-temp'&gt;
&lt;FN attrs=&quot;displayName&quot;&gt;{0}&lt;/FN&gt; &lt;FN attrs=&quot;displayName&quot;&gt;{0}&lt;/FN&gt;
&lt;NICKNAME attrs=&quot;uid&quot;&gt;{0}&lt;/NICKNAME&gt; &lt;NICKNAME attrs=&quot;uid&quot;&gt;{0}&lt;/NICKNAME&gt;
&lt;BDAY attrs=&quot;dob&quot;&gt;{0}&lt;/BDAY&gt; &lt;BDAY attrs=&quot;dob&quot;&gt;{0}&lt;/BDAY&gt;
&lt;ADR&gt; &lt;ADR&gt;
&lt;HOME/&gt; &lt;HOME/&gt;
&lt;EXTADR&gt;Ste 500&lt;/EXTADR&gt; &lt;EXTADR&gt;Ste 500&lt;/EXTADR&gt;
&lt;STREET&gt;317 SW Alder St&lt;/STREET&gt; &lt;STREET&gt;317 SW Alder St&lt;/STREET&gt;
&lt;LOCALITY&gt;Portland&lt;/LOCALITY&gt; &lt;LOCALITY&gt;Portland&lt;/LOCALITY&gt;
&lt;REGION&gt;Oregon&lt;/REGION&gt; &lt;REGION&gt;Oregon&lt;/REGION&gt;
&lt;PCODE&gt;97204&lt;/PCODE&gt; &lt;PCODE&gt;97204&lt;/PCODE&gt;
&lt;CTRY&gt;USA&lt;/CTRY&gt; &lt;CTRY&gt;USA&lt;/CTRY&gt;
&lt;/ADR&gt; &lt;/ADR&gt;
&lt;TEL&gt; &lt;TEL&gt;
&lt;HOME/&gt; &lt;HOME/&gt;
&lt;VOICE/&gt; &lt;VOICE/&gt;
&lt;NUMBER attrs=&quot;telephoneNumber&quot;&gt;{0}&lt;/NUMBER&gt; &lt;NUMBER attrs=&quot;telephoneNumber&quot;&gt;{0}&lt;/NUMBER&gt;
&lt;/TEL&gt; &lt;/TEL&gt;
&lt;EMAIL&gt; &lt;EMAIL&gt;
&lt;INTERNET/&gt; &lt;INTERNET/&gt;
&lt;USERID attrs=&quot;mail&quot;&gt;{0}&lt;/USERID&gt; &lt;USERID attrs=&quot;mail&quot;&gt;{0}&lt;/USERID&gt;
&lt;/EMAIL&gt; &lt;/EMAIL&gt;
&lt;TITLE attrs=&quot;title&quot;&gt;{0}&lt;/TITLE&gt; &lt;TITLE attrs=&quot;title&quot;&gt;{0}&lt;/TITLE&gt;
&lt;ROLE attrs=&quot;&quot;&gt;{0}&lt;/ROLE&gt; &lt;ROLE attrs=&quot;&quot;&gt;{0}&lt;/ROLE&gt;
&lt;ORG&gt; &lt;ORG&gt;
&lt;ORGNAME attrs=&quot;o&quot;&gt;{0}&lt;/ORGNAME&gt; &lt;ORGNAME attrs=&quot;o&quot;&gt;{0}&lt;/ORGNAME&gt;
&lt;ORGUNIT attrs=&quot;&quot;&gt;{0}&lt;/ORGUNIT&gt; &lt;ORGUNIT attrs=&quot;&quot;&gt;{0}&lt;/ORGUNIT&gt;
&lt;/ORG&gt; &lt;/ORG&gt;
&lt;URL attrs=&quot;labeledURI&quot;&gt;{0}&lt;/URL&gt; &lt;URL attrs=&quot;labeledURI&quot;&gt;{0}&lt;/URL&gt;
&lt;DESC attrs=&quot;uidNumber,homeDirectory,loginShell&quot;&gt; &lt;DESC attrs=&quot;uidNumber,homeDirectory,loginShell&quot;&gt;
uid: {0} home: {1} shell: {2} uid: {0} home: {1} shell: {2}
&lt;/DESC&gt; &lt;/DESC&gt;
&lt;/vCard&gt; &lt;/vCard&gt;
]]&gt; ]]&gt;
&lt;/vcard-mapping&gt; &lt;/vcard-mapping&gt;
...@@ -393,10 +427,15 @@ clients that support the XMPP vCard extension. First, enable the provider:</p> ...@@ -393,10 +427,15 @@ clients that support the XMPP vCard extension. First, enable the provider:</p>
</ol> </ol>
You can also enable debugging to get more information from the LDAP module. To You can also enable debugging to get more information from the LDAP module. To
do this, add &lt;log&gt;&lt;debug&gt;&lt;enabled&gt;true&lt;/enabled&gt;&lt;/debug&gt;&lt;/log&gt; do this, add &lt;log&gt;&lt;debug&gt;&lt;enabled&gt;true&lt;/enabled&gt;&lt;/debug&gt;&lt;/log&gt;
to your <tt>conf/wildfire.xml</tt> file. Log statements will be written to your <tt>conf/wildfire.xml</tt> file. Log statements will be written
to the <tt>logs/debug.log</tt> file. to the <tt>logs/debug.log</tt> file.
</ul> </ul>
</div>
</div>
</body> </body>
</html> </html>
\ No newline at end of file
documentation/docs/plugin-dev-guide.html
View file @ a61ed402
This diff is collapsed.
documentation/docs/protocol-support.html
View file @ a61ed402
...@@ -2,21 +2,26 @@ ...@@ -2,21 +2,26 @@
<html> <html>
<head> <head>
<title>Wildfire Protocol Support</title> <title>Jive Software - Wildfire: Protocol Support</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
<style type="text/css">
.supported { background-color:#D0FFCB }
.partially_supported { background-color:#FEFF94 }
.unsupported { background-color:#FFB4B4 }
</style>
</head> </head>
<body> <body>
<h1>Wildfire Protocol Support</h1> <div id="pageContainer">
<a name="top"></a> <a name="top"></a>
<div id="pageHeader">
<div id="logo"></div>
<h1>Protocol Support</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<p>Wildfire provides full support for the <p>Wildfire provides full support for the
<acronym title="Extensible Messaging and Presence Protocol">XMPP</acronym> <acronym title="Extensible Messaging and Presence Protocol">XMPP</acronym>
protocol defined by <a href="http://www.xmpp.org/specs/rfc3920.html">RFC 3920</a> and protocol defined by <a href="http://www.xmpp.org/specs/rfc3920.html">RFC 3920</a> and
...@@ -49,6 +54,7 @@ Suite</a>.</p> ...@@ -49,6 +54,7 @@ Suite</a>.</p>
<table class="dbtable"> <table class="dbtable">
<tr> <tr>
<th>Specification</th> <th>Specification</th>
<th width="35%">Supported</th> <th width="35%">Supported</th>
</tr><tr> </tr><tr>
<td><a href="http://www.xmpp.org/specs/rfc3920.html">RFC 3920</a>: XMPP Core</td> <td><a href="http://www.xmpp.org/specs/rfc3920.html">RFC 3920</a>: XMPP Core</td>
...@@ -56,6 +62,7 @@ Suite</a>.</p> ...@@ -56,6 +62,7 @@ Suite</a>.</p>
</tr><tr> </tr><tr>
<td><a href="http://www.xmpp.org/specs/rfc3921.html">RFC 3921</a>: XMPP IM</td> <td><a href="http://www.xmpp.org/specs/rfc3921.html">RFC 3921</a>: XMPP IM</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0030.html">JEP-0030</a>: Service Discovery</td> <td><a href="http://www.jabber.org/jeps/jep-0030.html">JEP-0030</a>: Service Discovery</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
...@@ -63,6 +70,7 @@ Suite</a>.</p> ...@@ -63,6 +70,7 @@ Suite</a>.</p>
<td><a href="http://www.jabber.org/jeps/jep-0077.html">JEP-0077</a>: In-Band Registration</td> <td><a href="http://www.jabber.org/jeps/jep-0077.html">JEP-0077</a>: In-Band Registration</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0078.html">JEP-0078</a>: Non-SASL Authentication</td> <td><a href="http://www.jabber.org/jeps/jep-0078.html">JEP-0078</a>: Non-SASL Authentication</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
...@@ -70,6 +78,7 @@ Suite</a>.</p> ...@@ -70,6 +78,7 @@ Suite</a>.</p>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr> </tr>
</table> </table>
<br> <br>
<a name="intermediate"></a> <a name="intermediate"></a>
...@@ -84,6 +93,7 @@ Suite</a>.</p> ...@@ -84,6 +93,7 @@ Suite</a>.</p>
<tr> <tr>
<th>Specification</th> <th>Specification</th>
<th width="35%">Supported</th> <th width="35%">Supported</th>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0073.html">JEP-0073</a>: Basic IM Protocol Suite</td> <td><a href="http://www.jabber.org/jeps/jep-0073.html">JEP-0073</a>: Basic IM Protocol Suite</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
...@@ -91,6 +101,7 @@ Suite</a>.</p> ...@@ -91,6 +101,7 @@ Suite</a>.</p>
<td><a href="http://www.jabber.org/jeps/jep-0004.html">JEP-0004</a>: Data Forms</td> <td><a href="http://www.jabber.org/jeps/jep-0004.html">JEP-0004</a>: Data Forms</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0020.html">JEP-0020</a>: Feature Negotiation</td> <td><a href="http://www.jabber.org/jeps/jep-0020.html">JEP-0020</a>: Feature Negotiation</td>
<td class="unsupported">No</td> <td class="unsupported">No</td>
</tr><tr> </tr><tr>
...@@ -98,6 +109,7 @@ Suite</a>.</p> ...@@ -98,6 +109,7 @@ Suite</a>.</p>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0047.html">JEP-0047</a>: In-Band Bytestreams</td> <td><a href="http://www.jabber.org/jeps/jep-0047.html">JEP-0047</a>: In-Band Bytestreams</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0065.html">JEP-0065</a>: SOCKS5 Bytestreams</td> <td><a href="http://www.jabber.org/jeps/jep-0065.html">JEP-0065</a>: SOCKS5 Bytestreams</td>
...@@ -105,12 +117,14 @@ Suite</a>.</p> ...@@ -105,12 +117,14 @@ Suite</a>.</p>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0071.html">JEP-0071</a>: XHTML-IM</td> <td><a href="http://www.jabber.org/jeps/jep-0071.html">JEP-0071</a>: XHTML-IM</td>
<td class="supported">Yes [<a href="#fn1">1</a>]</td> <td class="supported">Yes [<a href="#fn1">1</a>]</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0096.html">JEP-0096</a>: File Transfer</td> <td><a href="http://www.jabber.org/jeps/jep-0096.html">JEP-0096</a>: File Transfer</td>
<td class="supported">Yes</td> <td class="supported">Yes</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0115.html">JEP-0115</a>: Entity Capabilities</td> <td><a href="http://www.jabber.org/jeps/jep-0115.html">JEP-0115</a>: Entity Capabilities</td>
<td class="partially_supported">Yes [<a href="#fn2">2</a>]</td> <td class="partially_supported">Yes [<a href="#fn2">2</a>]</td>
</tr> </tr>
</table> </table>
<br> <br>
...@@ -130,12 +144,14 @@ JEPs that only require client-side support are omitted.</p> ...@@ -130,12 +144,14 @@ JEPs that only require client-side support are omitted.</p>
<td><a href="http://www.jabber.org/jeps/jep-0004.html">JEP-0004</a>: Data Forms</td> <td><a href="http://www.jabber.org/jeps/jep-0004.html">JEP-0004</a>: Data Forms</td>
<td>Intermediate</td> <td>Intermediate</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0012.html">JEP-0012</a>: Last Activity</td> <td><a href="http://www.jabber.org/jeps/jep-0012.html">JEP-0012</a>: Last Activity</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0013.html">JEP-0013</a>: Flexible Offline Message Retrieval</td> <td><a href="http://www.jabber.org/jeps/jep-0013.html">JEP-0013</a>: Flexible Offline Message Retrieval</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0030.html">JEP-0030</a>: Service Discovery</td> <td><a href="http://www.jabber.org/jeps/jep-0030.html">JEP-0030</a>: Service Discovery</td>
<td>Basic</td> <td>Basic</td>
</tr><tr> </tr><tr>
...@@ -143,6 +159,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -143,6 +159,7 @@ JEPs that only require client-side support are omitted.</p>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0045.html">JEP-0045</a>: Multi-User Chat</td> <td><a href="http://www.jabber.org/jeps/jep-0045.html">JEP-0045</a>: Multi-User Chat</td>
<td>Intermediate</td> <td>Intermediate</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0049.html">JEP-0049</a>: Private XML Storage</td> <td><a href="http://www.jabber.org/jeps/jep-0049.html">JEP-0049</a>: Private XML Storage</td>
...@@ -150,12 +167,14 @@ JEPs that only require client-side support are omitted.</p> ...@@ -150,12 +167,14 @@ JEPs that only require client-side support are omitted.</p>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0050.html">JEP-0050</a>: Ad-Hoc Commands</td> <td><a href="http://www.jabber.org/jeps/jep-0050.html">JEP-0050</a>: Ad-Hoc Commands</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0054.html">JEP-0054</a>: vcard-temp</td> <td><a href="http://www.jabber.org/jeps/jep-0054.html">JEP-0054</a>: vcard-temp</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0055.html">JEP-0055</a>: Jabber Search [<a href="#fn3">3</a>]</td> <td><a href="http://www.jabber.org/jeps/jep-0055.html">JEP-0055</a>: Jabber Search [<a href="#fn3">3</a>]</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0060.html">JEP-0060</a>: Publish-Subscribe</td> <td><a href="http://www.jabber.org/jeps/jep-0060.html">JEP-0060</a>: Publish-Subscribe</td>
<td>-</td> <td>-</td>
...@@ -163,6 +182,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -163,6 +182,7 @@ JEPs that only require client-side support are omitted.</p>
<td><a href="http://www.jabber.org/jeps/jep-0065.html">JEP-0065</a>: SOCKS5 Bytestreams</td> <td><a href="http://www.jabber.org/jeps/jep-0065.html">JEP-0065</a>: SOCKS5 Bytestreams</td>
<td>Intermediate</td> <td>Intermediate</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0077.html">JEP-0077</a>: In-Band Registration</td> <td><a href="http://www.jabber.org/jeps/jep-0077.html">JEP-0077</a>: In-Band Registration</td>
<td>Basic</td> <td>Basic</td>
</tr><tr> </tr><tr>
...@@ -170,6 +190,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -170,6 +190,7 @@ JEPs that only require client-side support are omitted.</p>
<td>Basic</td> <td>Basic</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0082.html">JEP-0082</a>: Jabber Date and Time Profiles</td> <td><a href="http://www.jabber.org/jeps/jep-0082.html">JEP-0082</a>: Jabber Date and Time Profiles</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0086.html">JEP-0086</a>: Error Condition Mappings</td> <td><a href="http://www.jabber.org/jeps/jep-0086.html">JEP-0086</a>: Error Condition Mappings</td>
...@@ -177,6 +198,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -177,6 +198,7 @@ JEPs that only require client-side support are omitted.</p>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0090.html">JEP-0090</a>: Entity Time</td> <td><a href="http://www.jabber.org/jeps/jep-0090.html">JEP-0090</a>: Entity Time</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0091.html">JEP-0091</a>: Delayed Delivery</td> <td><a href="http://www.jabber.org/jeps/jep-0091.html">JEP-0091</a>: Delayed Delivery</td>
<td>-</td> <td>-</td>
...@@ -184,6 +206,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -184,6 +206,7 @@ JEPs that only require client-side support are omitted.</p>
<td><a href="http://www.jabber.org/jeps/jep-0092.html">JEP-0092</a>: Software Version</td> <td><a href="http://www.jabber.org/jeps/jep-0092.html">JEP-0092</a>: Software Version</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0096.html">JEP-0096</a>: File Transfer</td> <td><a href="http://www.jabber.org/jeps/jep-0096.html">JEP-0096</a>: File Transfer</td>
<td>Intermediate</td> <td>Intermediate</td>
</tr><tr> </tr><tr>
...@@ -191,6 +214,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -191,6 +214,7 @@ JEPs that only require client-side support are omitted.</p>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0114.html">JEP-0114</a>: Jabber Component Protocol</td> <td><a href="http://www.jabber.org/jeps/jep-0114.html">JEP-0114</a>: Jabber Component Protocol</td>
<td>-</td> <td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0128.html">JEP-0128</a>: Service Discovery Extensions</td> <td><a href="http://www.jabber.org/jeps/jep-0128.html">JEP-0128</a>: Service Discovery Extensions</td>
...@@ -198,9 +222,7 @@ JEPs that only require client-side support are omitted.</p> ...@@ -198,9 +222,7 @@ JEPs that only require client-side support are omitted.</p>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0138.html">JEP-0138</a>: Stream Compression</td> <td><a href="http://www.jabber.org/jeps/jep-0138.html">JEP-0138</a>: Stream Compression</td>
<td>-</td> <td>-</td>
</tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0164.html">JEP-0164</a>: vCard Filtering</td>
<td>-</td>
</tr><tr> </tr><tr>
<td><a href="http://www.jabber.org/jeps/jep-0175.html">JEP-0175</a>: Best Practices for Use of SASL ANONYMOUS</td> <td><a href="http://www.jabber.org/jeps/jep-0175.html">JEP-0175</a>: Best Practices for Use of SASL ANONYMOUS</td>
<td>-</td> <td>-</td>
...@@ -219,5 +241,10 @@ JEPs that only require client-side support are omitted.</p> ...@@ -219,5 +241,10 @@ JEPs that only require client-side support are omitted.</p>
[<a name="fn3">3</a>] Support for <u>JEP-0055: Jabber Search</u> is provided by the <a href="http://www.jivesoftware.org/wildfire/plugins.jsp">Search plugin</a>. [<a name="fn3">3</a>] Support for <u>JEP-0055: Jabber Search</u> is provided by the <a href="http://www.jivesoftware.org/wildfire/plugins.jsp">Search plugin</a>.
<br> <br>
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/source-build.html
View file @ a61ed402
...@@ -2,38 +2,28 @@ ...@@ -2,38 +2,28 @@
<html> <html>
<head> <head>
<title>Wildfire Source Instructions</title> <title>Jive Software - Wildfire: Building the Source</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
<style type="text/css">
.code {
font-family : courier new;
border : 1px #ccc solid;
padding : 6px;
margin : 5px 20px 5px 20px;
}
TT {
font-family : courier new;
font-weight : bold;
color : #060;
}
PRE, CODE {
font-family : courier new;
font-size : 100%;
}
.footer {
font-size : 0.8em;
color : #666;
text-align : center;
}
</style>
</head> </head>
<body bgcolor="#ffffff"> <body>
<h1>Wildfire Source Instructions</h1> <div id="pageContainer">
<p>
<a name="top"></a>
<div id="pageHeader">
<div id="logo"></div>
<h1>Building the Source</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
This document provides detailed information for developers that wish to <div id="pageBody">
<p>This document provides detailed information for developers that wish to
compile and make changes to the Wildfire source code. compile and make changes to the Wildfire source code.
Use of the source code is governed by the GPL or the commercial license Use of the source code is governed by the GPL or the commercial license
you purchased for the codebase from Jive Software. you purchased for the codebase from Jive Software.
...@@ -55,9 +45,10 @@ in this distribution. ...@@ -55,9 +45,10 @@ in this distribution.
<p> <p>
This documentation is divided into three sections: This documentation is divided into three sections:
<ol> <ol>
<li> <a href="#source">Source</a> -- get the Wildfire source code. <li> <a href="#source">Source</a> -- get te Wildfire source code.
<li> <a href="#setup">Setup</a> -- how to setup your environment for Wildfire development. <li> <a href="#setup">Setup</a> -- how to setup your environment for Wildfire development.
<li> <a href="#tasks">Build tasks</a> -- tasks that can be performed using the build program. <li> <a href="#tasks">Build tasks</a> -- tasks that can be performed using the build program.
</ol> </ol>
<p><a name="source"><b><font color="#0066cc">1.</font> Get the Wildfire Source</b></a><p> <p><a name="source"><b><font color="#0066cc">1.</font> Get the Wildfire Source</b></a><p>
...@@ -71,6 +62,7 @@ be found on the <a href="http://www.jivesoftware.org/source.jsp">source page</a> ...@@ -71,6 +62,7 @@ be found on the <a href="http://www.jivesoftware.org/source.jsp">source page</a>
Getting your machine ready for development requires a few steps. Wherever Getting your machine ready for development requires a few steps. Wherever
possible, instructions are provided for both Unix/Linux and Windows users. possible, instructions are provided for both Unix/Linux and Windows users.
<p> <p>
<b><a name="javaSetup">Configure Java for Wildfire</a></b> <b><a name="javaSetup">Configure Java for Wildfire</a></b>
<ul> <ul>
Java 5 (JDK 1.5) must be installed and setup on your machine. To test the installation, Java 5 (JDK 1.5) must be installed and setup on your machine. To test the installation,
...@@ -87,6 +79,7 @@ possible, instructions are provided for both Unix/Linux and Windows users. ...@@ -87,6 +79,7 @@ possible, instructions are provided for both Unix/Linux and Windows users.
<ul> <ul>
<li> Unix/Linux <li> Unix/Linux
<ol> <ol>
<li>Edit the ".profile" file in your home directory (or <li>Edit the ".profile" file in your home directory (or
corresponding file for your shell). corresponding file for your shell).
<li>Set the JAVA_HOME environment variable by adding the <li>Set the JAVA_HOME environment variable by adding the
...@@ -103,6 +96,7 @@ possible, instructions are provided for both Unix/Linux and Windows users. ...@@ -103,6 +96,7 @@ possible, instructions are provided for both Unix/Linux and Windows users.
source .profile source .profile
</span> </span>
<p> <p>
The JAVA_HOME variable should now be configured correctly. The JAVA_HOME variable should now be configured correctly.
</ol> </ol>
<p> <p>
...@@ -123,6 +117,7 @@ possible, instructions are provided for both Unix/Linux and Windows users. ...@@ -123,6 +117,7 @@ possible, instructions are provided for both Unix/Linux and Windows users.
correctly. correctly.
</ol> </ol>
<p> <p>
<li> Windows95/98 <li> Windows95/98
<ol> <ol>
<li>Open your autoexec.bat file (often at "c:\autoexec.bat") using Notepad. <li>Open your autoexec.bat file (often at "c:\autoexec.bat") using Notepad.
...@@ -137,6 +132,7 @@ possible, instructions are provided for both Unix/Linux and Windows users. ...@@ -137,6 +132,7 @@ possible, instructions are provided for both Unix/Linux and Windows users.
not add an extra slash after the directory name. not add an extra slash after the directory name.
<li>Save changes to autoexec.bat and restart your computer. <li>Save changes to autoexec.bat and restart your computer.
</ol> </ol>
</ul> </ul>
</ul> </ul>
...@@ -165,6 +161,7 @@ Now, invoke the build tool to compile the Wildfire source code ...@@ -165,6 +161,7 @@ Now, invoke the build tool to compile the Wildfire source code
<p> <p>
Windows:<span class="code"> ant <br> </span><br clear="left"> Windows:<span class="code"> ant <br> </span><br clear="left">
Unix/Linux:<span class="code"> ./ant </span> Unix/Linux:<span class="code"> ./ant </span>
<p> <p>
...@@ -199,6 +196,7 @@ with the build tool. ...@@ -199,6 +196,7 @@ with the build tool.
one of the targets listed below: one of the targets listed below:
<ul> <ul>
<li><a href="#noparams"><i>Default</i></a> <li><a href="#noparams"><i>Default</i></a>
<li><a href="#jar">jar</a> <li><a href="#jar">jar</a>
<li><a href="#plugins">plugins</a> <li><a href="#plugins">plugins</a>
...@@ -210,6 +208,7 @@ for each task are enclosed with braces. If you would like to permanently set the ...@@ -210,6 +208,7 @@ for each task are enclosed with braces. If you would like to permanently set the
value of a property, add it to build/build.xml file. value of a property, add it to build/build.xml file.
<!-- default --> <!-- default -->
<p><b><a name="noparams"><i>Default</i></a></b> <p><b><a name="noparams"><i>Default</i></a></b>
<ul> <ul>
<i>Syntax:</i><p> <i>Syntax:</i><p>
...@@ -220,6 +219,7 @@ value of a property, add it to build/build.xml file. ...@@ -220,6 +219,7 @@ value of a property, add it to build/build.xml file.
Equivalent of calling "ant <a href="#jar">jar</a> javadoc". Equivalent of calling "ant <a href="#jar">jar</a> javadoc".
<p>[<a href="#tasks">return to task list</a>] <p>[<a href="#tasks">return to task list</a>]
</ul> </ul>
...@@ -240,6 +240,7 @@ Wildfire using the scripts in <tt>target/bin/</tt>. ...@@ -240,6 +240,7 @@ Wildfire using the scripts in <tt>target/bin/</tt>.
<!--PLUGINS--> <!--PLUGINS-->
<p><b><a name="jar">plugins</a></b> <p><b><a name="jar">plugins</a></b>
<ul> <ul>
<i>Syntax:</i><p> <i>Syntax:</i><p>
...@@ -249,6 +250,7 @@ Wildfire using the scripts in <tt>target/bin/</tt>. ...@@ -249,6 +250,7 @@ Wildfire using the scripts in <tt>target/bin/</tt>.
Builds all plugins into the <tt>target/plugins</tt> directory. Builds all plugins into the <tt>target/plugins</tt> directory.
<p>[<a href="#tasks">return to task list</a>] <p>[<a href="#tasks">return to task list</a>]
</ul> </ul>
<!--CLEAN--> <!--CLEAN-->
...@@ -261,10 +263,16 @@ Builds all plugins into the <tt>target/plugins</tt> directory. ...@@ -261,10 +263,16 @@ Builds all plugins into the <tt>target/plugins</tt> directory.
<p><i>Description:</i></p> <p><i>Description:</i></p>
Cleans all artifacts of the build process by deleting the <tt>target/</tt> Cleans all artifacts of the build process by deleting the <tt>target/</tt>
directory.<p> directory.<p>
<p>[<a href="#tasks">return to task list</a>] <p>[<a href="#tasks">return to task list</a>]
</ul> </ul>
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/ssl-guide.html
View file @ a61ed402
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<title>Wildfire SSL Guide</title> <title>Jive Software - Wildfire: SSL Guide</title>
<link type="text/css" rel="stylesheet" href="style.css"> <link type="text/css" rel="stylesheet" href="style.css">
</head> </head>
<body> <body>
<div id="pageContainer">
<a name="top"></a> <a name="top"></a>
<h1>Wildfire SSL Guide</h1>
<div id="pageHeader">
<div id="logo"></div>
<h1>SSL Guide</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<h2>Introduction</h2> <h2>Introduction</h2>
<p> <p>
This document outlines how to customize the SSL support in Wildfire. This document outlines how to customize the SSL support in Wildfire.
<font color="red"><b>Important note:</b></font> <font color="red"><b>Important note:</b></font>
because Wildfire ships with self-signed certificates, it will work out of the box without because Wildfire ships with self-signed certificates, it will work out of the box without
installing your own certificate. However, most users will wish to user their own installing your own certificate. However, most users will wish to user their own
...@@ -52,6 +67,7 @@ reaction to a self-signed certificate is to ask the user whether ...@@ -52,6 +67,7 @@ reaction to a self-signed certificate is to ask the user whether
to trust the certificate, or to silently trust the certificate is to trust the certificate, or to silently trust the certificate is
legitimate. Unfortunately, blindly accepting self-signed certificates legitimate. Unfortunately, blindly accepting self-signed certificates
opens up the system to 'man-in-the-middle' attacks. opens up the system to 'man-in-the-middle' attacks.
</p> </p>
<p> <p>
The advantage of a self-signed certificate is you can create them for The advantage of a self-signed certificate is you can create them for
...@@ -81,6 +97,7 @@ encrypted files. The <tt>keytool</tt> is used to create, read, update, ...@@ -81,6 +97,7 @@ encrypted files. The <tt>keytool</tt> is used to create, read, update,
and delete entries in these files. Wildfire ships with a self-signed and delete entries in these files. Wildfire ships with a self-signed
"dummy" certificate designed for initial evaluation testing. You will need "dummy" certificate designed for initial evaluation testing. You will need
to adjust the default configuration for most deployments. to adjust the default configuration for most deployments.
</p> </p>
<p> <p>
In order to configure SSL on your server you need complete the In order to configure SSL on your server you need complete the
...@@ -96,6 +113,7 @@ If so, you can skip to step 4.</li> ...@@ -96,6 +113,7 @@ If so, you can skip to step 4.</li>
server certificate. server certificate.
<ol style="list-style-type: lower-alpha;"> <ol style="list-style-type: lower-alpha;">
<li>Generate a certificate signing request (CSR).</li> <li>Generate a certificate signing request (CSR).</li>
<li>Submit your CSR to a CA for signing.</li> <li>Submit your CSR to a CA for signing.</li>
</ol> </ol>
</li> </li>
...@@ -107,6 +125,7 @@ skip this step.</li> ...@@ -107,6 +125,7 @@ skip this step.</li>
<li>Import client certificates into the truststore.</li> <li>Import client certificates into the truststore.</li>
<li>Adjust the Wildfire configuration with proper keystore and <li>Adjust the Wildfire configuration with proper keystore and
truststore settings.</li> truststore settings.</li>
</ol> </ol>
<h3>1. Decide on a Server Domain</h3> <h3>1. Decide on a Server Domain</h3>
<p> <p>
...@@ -123,6 +142,7 @@ directory of your Wildfire installation. You should see the default ...@@ -123,6 +142,7 @@ directory of your Wildfire installation. You should see the default
<tt>keystore</tt> and <tt>truststore</tt> files. First, you should <tt>keystore</tt> and <tt>truststore</tt> files. First, you should
change the default keystore change the default keystore
password: password:
</p> </p>
<p><tt>keytool -storepasswd -keystore keystore</tt></p> <p><tt>keytool -storepasswd -keystore keystore</tt></p>
<p> <p>
...@@ -140,6 +160,7 @@ After you have entered all the required information, keytool will ask you to ...@@ -140,6 +160,7 @@ After you have entered all the required information, keytool will ask you to
verify the information and set a key password. verify the information and set a key password.
<b>You must use the same key password as the store password.</b> By default <b>You must use the same key password as the store password.</b> By default
you get this by simply hitting 'enter' when prompted for a key password.</p> you get this by simply hitting 'enter' when prompted for a key password.</p>
<p>If you later change the keystore password remember to change the entries' <p>If you later change the keystore password remember to change the entries'
password as well using the keytool:</p> password as well using the keytool:</p>
...@@ -155,6 +176,7 @@ standard CSR format. You can do this with the keytool: ...@@ -155,6 +176,7 @@ standard CSR format. You can do this with the keytool:
certificate_file</tt></p> certificate_file</tt></p>
<p> <p>
Where you should substitute your server's name for <tt>example.com</tt> Where you should substitute your server's name for <tt>example.com</tt>
and the name of the and the name of the
certificate file you wish to produce for <tt>certificate_file</tt>. certificate file you wish to produce for <tt>certificate_file</tt>.
Submit the generated CSR to the CA and follow their instructions to get Submit the generated CSR to the CA and follow their instructions to get
...@@ -174,6 +196,7 @@ you'll receive an error. ...@@ -174,6 +196,7 @@ you'll receive an error.
</p> </p>
<h3>5. Remove default certificates</h3> <h3>5. Remove default certificates</h3>
<p> <p>
After importing your certificate you must remove the default certificates After importing your certificate you must remove the default certificates
using the keytool. using the keytool.
</p> </p>
...@@ -191,6 +214,7 @@ password: ...@@ -191,6 +214,7 @@ password:
keytool will ask for the old password (by default it is <tt>changeit</tt>) keytool will ask for the old password (by default it is <tt>changeit</tt>)
then the new password. then the new password.
Now import each certificate using the keytool: Now import each certificate using the keytool:
</p> </p>
<p><tt>keytool -import -keystore truststore -alias user_name -file <p><tt>keytool -import -keystore truststore -alias user_name -file
certificate_file</tt></p> certificate_file</tt></p>
...@@ -206,6 +230,7 @@ browser and add or change the following system properties: ...@@ -206,6 +230,7 @@ browser and add or change the following system properties:
<li>xmpp.socket.ssl.storeType -- the store type used ("JKS" is <li>xmpp.socket.ssl.storeType -- the store type used ("JKS" is
the Sun Java Keystore format used by the JDK keytool). If this property is the Sun Java Keystore format used by the JDK keytool). If this property is
not defined, Wildfire will assume a value of "jks".</li> not defined, Wildfire will assume a value of "jks".</li>
<li>xmpp.socket.ssl.keystore -- the location of the keystore file <li>xmpp.socket.ssl.keystore -- the location of the keystore file
relative to your Wildfire installation root directory. You can leave this property relative to your Wildfire installation root directory. You can leave this property
blank to use the default keystore.</li> blank to use the default keystore.</li>
...@@ -218,5 +243,10 @@ your Wildfire installation root directory.</li> ...@@ -218,5 +243,10 @@ your Wildfire installation root directory.</li>
changed in step 6.</li> changed in step 6.</li>
</ul> </ul>
You will need to restart the server after you have modified any of the above system properties. You will need to restart the server after you have modified any of the above system properties.
</div>
</div>
</body> </body>
</html> </html>
documentation/docs/style.css
View file @ a61ed402
BODY { /* global font and body settings */
body {
font-size : 100%; font-size : 100%;
background-color : #fff; background-color : #d3d6d9;
padding: 0px;
color: #33333;
margin: 0px 0px 30px 0px;
} }
BODY, TD, TH { body, td, th {
font-family : arial, helvetica, sans-serif; font-family : arial, helvetica, sans-serif;
font-size : 10pt; font-size : 10pt;
} }
PRE, TT, CODE { pre, tt, code {
font-family : courier new, monospaced; font-family : courier new, monospaced;
font-size : 9pt; font-size : 9pt;
} }
A:hover { #pageContainer {
text-decoration : none; display: block;
position: relative;
clear: all;
background-color: #fff;
border: 1px solid #999;
padding: 40px;
margin: 30px;
-moz-border-radius: 6px;
}
#pageHeader {
display: block;
position: relative;
height: 80px;
background-color: #e7eaee;
border: 1px solid #cccccc;
border-bottom: none;
-moz-border-radius: 5px 5px 0px 0px;
margin: 10px 0px 0px 0px;
}
#pageBody {
margin: 0px 18px 0px 20px;
} }
LI {
padding-bottom : 4px;
/* anchors */
a:link {
color: #11568c;
}
a:visited {
color: #571c8d;
} }
H1 { a:hover {
font-size : 1.4em; color: #7a1d42;
text-decoration : underline;
}
a:active {
color: #7a1d42;
}
/* page header elements (logo and navigation) */
#logo {
display: block;
position: relative;
background: url(images/header_logo.gif) no-repeat;
width: 135px;
height: 40px;
margin: 21px 20px 0px 0px;
overflow: hidden;
float: right;
}
.navigation {
display: block;
position: relative;
height: 20px;
background-color: #335588;
border: 1px solid #cccccc;
border-top: none;
color: #ffffff;
font-size: 11px;
line-height: 18px;
padding: 0px 0px 0px 0px;
margin: 0px 0px 25px 0px;
overflow: hidden;
}
.navigation a {
margin: 0px 0px 0px 20px;
}
.navigation a:link { color: #ffffff; }
.navigation a:visited { color: #ffffff; }
.navigation a:hover { color: #ffffff; }
.navigation a:active { color: #ffffff; }
/* headings */
h1 {
display: block;
position: relative;
font-size : 1.7em;
font-weight : bold; font-weight : bold;
width : 100%; color: #670e15;
border-bottom : 1px #ccc solid; padding: 0px;
padding-bottom : 2px; margin: 30px 0px 0px 20px;
} }
H2 { h2 {
font-size : 1.2em; font-size : 1.3em;
font-weight : bold; font-weight : bold;
margin: 40px 0px 6px 0px;
padding: 0px;
color: #335588;
} }
H3 { h3 {
font-size : 1.0em; font-size : 1.0em;
font-weight : bold; font-weight : bold;
margin: 25px 0px 3px 0px;
padding: 0px;
color: #334466;
}
/* general elements */
p {
margin: 0px 0px 15px 0px;
} }
TT {
ul {
margin: 5px 0px 15px 35px;
}
li {
padding-bottom : 4px;
}
tt {
font-family : courier new; font-family : courier new;
font-weight : bold; font-weight : bold;
color : #060; color : #060;
} }
FIELDSET PRE { hr {
display: block;
height: 1px;
background-color: #999999;
border: none;
margin: 40px 0px 20px 0px;
}
fieldset pre {
padding : 1em; padding : 1em;
margin : 0px; margin : 0px;
} }
FIELDSET { fieldset {
margin-left : 2em; margin-left : 2em;
margin-right : 2em; margin-right : 2em;
border : 1px #ccc solid; border : 1px #ccc solid;
-moz-border-radius : 5px; -moz-border-radius : 5px;
} }
/* classes */
.comment { .comment {
color : #666; color : #666;
font-style : italic; font-style : italic;
} }
.subheader { .subheader {
font-weight : bold; font-weight : bold;
} }
...@@ -63,18 +174,20 @@ FIELDSET { ...@@ -63,18 +174,20 @@ FIELDSET {
padding-top : 2px; padding-top : 2px;
} }
.code { .code {
display: block;
width: auto;
border : 1px #ccc solid; border : 1px #ccc solid;
padding : 0em 1.0em 0em 1.0em; padding : 6px;
margin : 4px 0px 4px 0px; margin : 10px 20px 10px 20px;
} }
.nav, .nav A { .note {
font-family : verdana; font-family : verdana;
font-size : 0.85em; font-size : 0.85em;
color : #600; color : #600;
text-decoration : none; text-decoration : none;
font-weight : bold; font-weight : bold;
} }
.note { .nav, .nav a {
font-family : verdana; font-family : verdana;
font-size : 0.85em; font-size : 0.85em;
color : #600; color : #600;
...@@ -86,9 +199,10 @@ FIELDSET { ...@@ -86,9 +199,10 @@ FIELDSET {
border-bottom : 1px #ccc solid; border-bottom : 1px #ccc solid;
padding : 3px 3px 5px 1px; padding : 3px 3px 5px 1px;
} }
.nav A:hover { .nav a:hover {
text-decoration : underline; text-decoration : underline;
}.question { }
.question {
font-weight: 600; font-weight: 600;
} }
.answer { .answer {
...@@ -97,21 +211,31 @@ FIELDSET { ...@@ -97,21 +211,31 @@ FIELDSET {
.toc { .toc {
right: 5px; right: 5px;
} }
TABLE.dbtable {
table.dbtable {
border : 1px #ccc solid; border : 1px #ccc solid;
width : 600px; width : 600px;
} }
TR, TH { tr, th {
border-bottom : 1px #ccc solid; border-bottom : 1px #ccc solid;
} }
TH, TD { th, td {
padding-right : 15px; padding-right : 15px;
} }
TH { th {
text-align : left; text-align : left;
white-space : nowrap; white-space : nowrap;
background-color : #eee; background-color : #eee;
} }
.primary-key { .primary-key {
background-color : #ffc; background-color : #ffc;
} }
/* Protocol support specific styles */
.supported { background-color: #D0FFCB }
.partially_supported { background-color: #FEFF94 }
.unsupported { background-color: #FFB4B4 }
documentation/docs/translator-guide.html
View file @ a61ed402
...@@ -2,16 +2,26 @@ ...@@ -2,16 +2,26 @@
<html> <html>
<head> <head>
<title>Wildfire Translator Guide</title> <title>Jive Software - Wildfire: Translator Guide</title>
<link href="style.css" rel="stylesheet" type="text/css"> <link href="style.css" rel="stylesheet" type="text/css">
</head> </head>
<body> <body>
<h1>Wildfire Translator Guide</h1> <div id="pageContainer">
<a name="top"></a> <a name="top"></a>
<div id="pageHeader">
<div id="logo"></div>
<h1>Translator Guide</h1>
</div>
<div class="navigation">
<a href="index.html">&laquo; Back to documentation index</a>
</div>
<div id="pageBody">
<h2>Introduction</h2> <h2>Introduction</h2>
<p> <p>
...@@ -34,6 +44,7 @@ Key/value pairs in the English resource bundle might look like the following: ...@@ -34,6 +44,7 @@ Key/value pairs in the English resource bundle might look like the following:
The German resource bundle would contain the same keys, but different values: The German resource bundle would contain the same keys, but different values:
<br> <br>
<pre> <pre>
skin.yes=<i>Ja</i> skin.yes=<i>Ja</i>
skin.no=<i>Nein</i> skin.no=<i>Nein</i>
skin.topic=<i>Thema</i> skin.topic=<i>Thema</i>
...@@ -111,7 +122,12 @@ property.</p> ...@@ -111,7 +122,12 @@ property.</p>
<p>Once your translation is complete and tested, please submit it to the Wildfire <p>Once your translation is complete and tested, please submit it to the Wildfire
developers so that others can enjoy it in the next release!</p> developers so that others can enjoy it in the next release!</p>
<br><br> <br>
<br>
</div>
</div>
</body> </body>
</html> </html>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment

Technounit-GROUP 2023