You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by bu...@apache.org on 2012/10/31 05:53:40 UTC
svn commit: r836681 [22/23] - in /websites/staging/mina/trunk/content: ./
asyncweb/ css/ ftpserver/ mina/ mina/userguide/
mina/userguide/ch1-getting-started/ mina/userguide/ch10-executor-filter/
mina/userguide/ch11-ssl-filter/ mina/userguide/ch12-loggi...
Added: websites/staging/mina/trunk/content/vysper/downloads.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/downloads.html (added)
+++ websites/staging/mina/trunk/content/vysper/downloads.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Downloads — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="latest-vysper-releases">Latest Vysper Releases</h1>
+<p>The latest release is the <a href="download_0.7.html">Apache Vysper 0.7 Release</a></p>
+<h1 id="all-releases">All Releases</h1>
+<ul>
+<li><a href="download_0.7.html">Apache Vysper 0.7 Release</a></li>
+<li><a href="download_0.6.html">Apache Vysper 0.6 Release</a></li>
+<li><a href="download_0.5.html">Apache Vysper 0.5 Release</a></li>
+</ul>
+<h1 id="maven-repositories">Maven Repositories</h1>
+<p>All Apache Vysper releases are available from the Maven central repository </p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/embed.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/embed.html (added)
+++ websites/staging/mina/trunk/content/vysper/embed.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,177 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Embed Vysper into another application — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="embed-into-another-application">Embed into another application</h1>
+<h2 id="about-logging">About logging</h2>
+<p>Embedding software making use of logging into another one making use of logging itself can be cumbersome.
+Vysper uses slf4j for logging, which foremost is a logging facade. The actual logging worker is then bound at runtime. It can be log4j, as in standalone Vysper, or some other logging framework. If you make use of one of these in your embedding application, just put the proper slf4j adapter lib onto the classpath. For more info about slf4j, see the website at slf4j.org.</p>
+<h2 id="libraries">Libraries</h2>
+<p>This example doesn't make use of the Spring-based deployment. So we don't need the Spring libraries here.</p>
+<p>TODO: elaborate about the other libs needed.</p>
+<h2 id="start-server-naivly">Start server (naivly)</h2>
+<p>Having a Vysper XMPP server instance embedded into your own application is easy:</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>import org.apache.vysper.xmpp.server;</p>
+<p>XMPPServer server = new XMPPServer("myembeddedjabber.com");
+server.start();
+</PRE>
+</DIV></DIV></p>
+<p>Unfortunately, this is not the whole story, we need to do some more preparations first. Hang on!</p>
+<h2 id="start-server-full-story">Start server (full story)</h2>
+<p>We make use of the JCR-persistent storage, and we add one user.
+If you need more users, add more. Just make sure their Jabber ID domain matches the server's domain ("myembeddedjabber.com", in this case).</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>// choose the storage you want to use
+StorageProviderRegistry providerRegistry = new JcrStorageProviderRegistry();
+//StorageProviderRegistry providerRegistry = new MemoryStorageProviderRegistry();</p>
+<p>final AccountManagement accountManagement = (AccountManagement) providerRegistry.retrieve(AccountManagement.class);</p>
+<p>if(!accountManagement.verifyAccountExists(EntityImpl.parse("user1@myembeddedjabber.com"))) {
+ accountManagement.addUser(EntityImpl.parse("user1@myembeddedjabber.com"), "password1");
+}
+</PRE>
+</DIV></DIV></p>
+<p>Now, instantiate the server and set the fundamental stuff: endpoint, user management and TLS.</p>
+<p>SSL needs a TLS certificate. There is one coming along with Vysper for testing purposes only, just make sure it is properly referenced on the file system.
+Or, even better, create your own.</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>XMPPServer server = new XMPPServer("myembeddedjabber.com");
+server.addEndpoint(new TCPEndpoint());
+server.setStorageProviderRegistry(providerRegistry);</p>
+<p>server.setTLSCertificateInfo(new File("src/main/config/bogus_mina_tls.cert"), "boguspw");
+</PRE>
+</DIV></DIV></p>
+<p>With initializing completed, just give it a go:</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>try {
+ server.start();
+ System.out.println("server is running...");
+} catch (Exception e) {
+ e.printStackTrace();
+}
+</PRE>
+</DIV></DIV></p>
+<h2 id="adding-modules-to-the-server">Adding modules to the server.</h2>
+<p>The server starts up with two built-in modules, Roster and Service Discovery. Both can be considered as optional, but for a proper server you would normally want to have them (and if you don't, remove them from code in XMPPServer.start() and rebuild).</p>
+<p>Some handy modules can be added, but this is optional:</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>server.addModule(new SoftwareVersionModule());
+server.addModule(new EntityTimeModule());
+server.addModule(new VcardTempModule()); // depends on Jcr persistence
+</PRE>
+</DIV></DIV></p>
+<h2 id="reference">Reference</h2>
+<p>The full and probably improved latest version of this code can be found <a href="http://svn.apache.org/repos/asf/mina/sandbox/vysper/trunk/server/core/src/main/java/org/apache/vysper/xmpp/server/ServerMain.java">here</a></p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/extending_server.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/extending_server.html (added)
+++ websites/staging/mina/trunk/content/vysper/extending_server.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,142 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Extending the Server — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="how-to-extend-the-server-functionality">How to extend the server functionality</h1>
+<h2 id="xmpp-support-for-extensions">XMPP support for extensions</h2>
+<p><a href="http://www.xmpp.org/">XMPP</a> provides a bunch of already specified extensions. See <a href="http://www.xmpp.org/extensions">http://www.xmpp.org/extensions</a> for a complete list.</p>
+<p>XMPP also allows for custom extensions of the core stanza types 'message', 'iq' and 'presence'. All XMPP clients and servers should be able to savely ignore them unless they are able to deal with them. See the <a href="http://www.xmpp.org/internet-drafts/draft-saintandre-rfc3920bis-05.html#stanzas-extended">relevant specification chapter</a>.</p>
+<p>Most XMPP extensions rely on Disco (Service Discovery, XEP-0030).
+It's easy to integrate modules with Vysper's Disco extension.</p>
+<p>Most XMPP extensions rely on Disco (<a href="http://xmpp.org/extensions/xep-0030.html">Service Discovery, XEP-0030</a>).
+It's easy to integrate modules with <a href="http://mina.apache.org/vysper/service-discovery.html">Vysper's Disco extension</a>.</p>
+<h2 id="modules">Modules</h2>
+<p>Regardless which kind of extension it is (Vysper internal, XMPP standardized or home-brewn) they all can be deployed using the Vysper Modules.</p>
+<p>Vysper Modules are implementations of interface org.apache.vysper.xmpp.modules.Module, but it is probably more convenient to extend DefaultModule. Modules supporting disco should extend DefaultDiscoAwareModule.</p>
+<p>An example of a Vysper-internal module is org.apache.vysper.xmpp.modules.roster.RosterModule.</p>
+<h2 id="handlers-and-dictionaries">Handlers and Dictionaries</h2>
+<p>Every incoming stanza is processed by one dedicated StanzaHandler instance. For implementing a new functionality, we'd have to code new StanzaHandlers. They are registered with the server. The server introspects the stanza and decides which handler is tailored for it by basically looking at the stanza name ('message'/'iq'/'presence') and the namespace attributes ('xmlns') on the top and first-child XML elements.</p>
+<p>Dictionary objects are used to compile handlers for the same namespace.</p>
+<h2 id="a-custom-handler">A custom handler</h2>
+<p>It is highly recommended that custom handlers do subclass</p>
+<ul>
+<li>org.apache.vysper.xmpp.modules.core.base.handler.DefaultIQHandler</li>
+<li>org.apache.vysper.xmpp.modules.core.base.handler.MessageHandler</li>
+<li>org.apache.vysper.xmpp.modules.core.im.handler.PresenceHandler</li>
+</ul>
+<h2 id="activate-a-module-in-the-server">Activate a module in the server</h2>
+<p>Modules are registered with the server calling ServerRuntimeContext.addModule(Module module).</p>
+<p>Using spring-config.xml, they are configured in bean 'server'. Simply add a new bean for the module to the config. Then add a bean reference to property 'modules' list in 'server'. On server startup, these modules are loaded and activated.</p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/extension_roadmap.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/extension_roadmap.html (added)
+++ websites/staging/mina/trunk/content/vysper/extension_roadmap.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,197 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Extension Roadmap — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="extension-roadmap">Extension Roadmap</h1>
+<h2 id="extension-roadmap_1">Extension Roadmap</h2>
+<h2 id="change-the-prios">Change the prios!</h2>
+<p>If there is anything you want to implement, regardless if it is on this lists or not, please don't hesitate to contact us.
+This is not set in stone! It's just there to give some perspective</p>
+<h2 id="completed">Completed</h2>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0004.html" class="external-link" rel="nofollow">XEP-0004</A> </TD>
+<TD class="confluenceTd"> Data Forms </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0030.html" class="external-link" rel="nofollow">XEP-0030</A> </TD>
+<TD class="confluenceTd"> <A href="service_discovery.html" title="Service Discovery">Service Discovery</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0048.html" class="external-link" rel="nofollow">XEP-0048</A> </TD>
+<TD class="confluenceTd"> Bookmarks </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0049.html" class="external-link" rel="nofollow">XEP-0049</A> </TD>
+<TD class="confluenceTd"> Private XML Storage </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0054.html" class="external-link" rel="nofollow">XEP-0054</A> </TD>
+<TD class="confluenceTd"> vcard-temp </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0090.html" class="external-link" rel="nofollow">XEP-0090</A> </TD>
+<TD class="confluenceTd"> Entity Time (deprecated, see XEP-0202) </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0092.html" class="external-link" rel="nofollow">XEP-0092</A> </TD>
+<TD class="confluenceTd"> Software Version </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0199.html" class="external-link" rel="nofollow">XEP-0199</A> </TD>
+<TD class="confluenceTd"> XMPP Ping </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0202.html" class="external-link" rel="nofollow">XEP-0202</A> </TD>
+<TD class="confluenceTd"> Entity Time </TD>
+</TR>
+</TBODY></TABLE>
+</DIV></p>
+<h2 id="in-development">In development</h2>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TD class="confluenceTd"> <A href="http://ietf.org/rfc/rfc3920.txt" class="external-link" rel="nofollow">RFC3920</A> </TD>
+<TD class="confluenceTd"> in progress, some features missing </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://ietf.org/rfc/rfc3921.txt" class="external-link" rel="nofollow">RFC3921</A> </TD>
+<TD class="confluenceTd"> in progress, major features missing </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0060.html" class="external-link" rel="nofollow">XEP-0060</A> </TD>
+<TD class="confluenceTd"> Publish-Subscribe, fully compliant but not full featured </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0045.html" class="external-link" rel="nofollow">XEP-0045</A></TD>
+<TD class="confluenceTd">Multi-user chat</TD>
+</TR>
+</TBODY></TABLE>
+</DIV></p>
+<h2 id="upcoming">Upcoming</h2>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0009.html" class="external-link" rel="nofollow">XEP-0009</A> </TD>
+<TD class="confluenceTd"> RPC </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <A href="http://xmpp.org/extensions/xep-0077.html" class="external-link" rel="nofollow">XEP-0077</A> </TD>
+<TD class="confluenceTd"> In-band Registration </TD>
+</TR>
+</TBODY></TABLE>
+</DIV></p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/getting_involved.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/getting_involved.html (added)
+++ websites/staging/mina/trunk/content/vysper/getting_involved.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Getting Involved — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="getting-involved">Getting Involved</h1>
+<p>The Apache Vysper developers communicates using our <a href="mailing_lists.html">Mailing Lists</a>. If you have any questions, feedback or suggestions, you're very welcome to join the list and send an email. We are also happy to receive <a href="{{base}}/vysper/issue_tracking.html">bug reports and feature requests in our JIRA</a>.</p>
+<h2 id="patches">Patches</h2>
+<p>The best chance of getting your bug or feature fixed is to provide a patch, if they fit our goals we will usually have them commited within a few days. The Apache Contributors page has excellent <a href="http://apache.org/dev/contributors.html#patches">information on how to produce patches</a>.</p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/index.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/index.html (added)
+++ websites/staging/mina/trunk/content/vysper/index.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Apache Vysper — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="apache-vysper">Apache Vysper</h1>
+<p>Apache Vysper aims to be a modular, full featured XMPP (Jabber) server.</p>
+<p>More details on Vysper in our <a href="documentation.html">documentation</a>.</p>
+<p>There are already some larger XEPs as modules available, most notably</p>
+<ul>
+<li>Multi User Chat (<a href="http://xmpp.org/extensions/xep-0045.html">XEP0045</a>) and</li>
+<li>Publish/Subscribe (<a href="http://xmpp.org/extensions/xep-0060.html">XEP0060</a>)</li>
+<li>BOSH (<a href="http://xmpp.org/extensions/xep-0124.html">XEP0124</a>, <a href="http://xmpp.org/extensions/xep-0206.html">XEP0206</a>)</li>
+</ul>
+<p>To start using and/or developing extensions for Vysper, don't miss the <a href="user_guide.html">User Guide</a>!</p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/issue_tracking.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/issue_tracking.html (added)
+++ websites/staging/mina/trunk/content/vysper/issue_tracking.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Issue Tracking — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="issue-tracking">Issue Tracking</h1>
+<p>We are using JIRA to track all Vysper issues including bugs. Please visit our <a href="http://issues.apache.org/jira/browse/VYSPER">issue tracker page</a> to report a bug.</p>
+<h2 id="how-to-report-a-bug">How to report a bug</h2>
+<p>Writing a bug report with detailed information will help us to fix your problem sooner.</p>
+<ul>
+<li>Make sure if the bug you are going to report doesn't exist yet.</li>
+<li>Attaching JUnit test case which reproduces the problem will put your report in our highest priority.</li>
+<li>Attach full thread stack dump if you suspect a dead lock.</li>
+<li>Attach full heap dump if you suspect a memory leak.</li>
+<li>Specify the environment in detail as much as possible.<ul>
+<li>Operating system version, distribution, architecture, ...</li>
+<li>JVM vendor, version, build number, command line arguments, ...</li>
+<li>Network settings</li>
+</ul>
+</li>
+</ul>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/mailing_lists.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/mailing_lists.html (added)
+++ websites/staging/mina/trunk/content/vysper/mailing_lists.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,184 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Mailing Lists — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="mailing-list">Mailing List</h1>
+<p>General information about the Vysper mailing lists can be found here.</p>
+<h2 id="for-users">For Users</h2>
+<p>Please use this list for any questions regarding how to use Vysper.</p>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:users-subscribe@mina.apache.org" class="external-link" rel="nofollow">users-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:users-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">users-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:users@mina.apache.org" class="external-link" rel="nofollow">users@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/users@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/users@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV></p>
+<h2 id="for-developers">For Developers</h2>
+<p>We use the MINA developers list for asking technical questions, discussing feature suggestions or general questions regarding the project.</p>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:dev-subscribe@mina.apache.org" class="external-link" rel="nofollow">dev-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:dev-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">dev-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:dev@mina.apache.org" class="external-link" rel="nofollow">dev@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/dev@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/dev@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV></p>
+<h2 id="subversion-commits">Subversion commits</h2>
+<p><DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Subscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:commits-subscribe@mina.apache.org" class="external-link" rel="nofollow">commits-subscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TD class="confluenceTd"> <A href="mailto:commits-unsubscribe@mina.apache.org" class="external-link" rel="nofollow">commits-unsubscribe@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Post </TH>
+<TD class="confluenceTd"> <A href="mailto:commits@mina.apache.org" class="external-link" rel="nofollow">commits@mina.apache.org</A> </TD>
+</TR>
+<TR>
+<TH class="confluenceTh"> Archive </TH>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/commits@mina.apache.org/" class="external-link" rel="nofollow">http://www.mail-archive.com/commits@mina.apache.org/</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV> </p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/server_standalone.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/server_standalone.html (added)
+++ websites/staging/mina/trunk/content/vysper/server_standalone.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,134 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Standalone Server — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="run-main-class">run main class</h1>
+<p>if you like to invoke the server from an IDE or the commandline, use the Java class</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>org.apache.vysper.spring.ServerMain
+</PRE>
+</DIV></DIV></p>
+<p>for example by typing</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>java org.apache.vysper.spring.ServerMain
+</PRE>
+</DIV></DIV></p>
+<p>be sure to include all jars in lib/ in your classpath plus the spring-config.xml.</p>
+<p>It is also possible to load modules on the command line:</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>java org.apache.vysper.spring.ServerMain -Dvysper.add.module=module1,module2...
+</PRE>
+</DIV></DIV></p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/server_to_server_comm.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/server_to_server_comm.html (added)
+++ websites/staging/mina/trunk/content/vysper/server_to_server_comm.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,152 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Server-to-server — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="server-to-server">Server-to-server</h1>
+<p><DIV class="info" markdown="1">
+ Available since version 0.7.
+</DIV></p>
+<p>XMPP servers like Apache Vysper work in federated networks much like SMTP servers. Users connect to their own server, and when communicating with users on a different domain, the two servers will connect to each other and exchange XMPP stanzas. Server-to-server (S2S) connections differ from client-to-server (C2) connections in that stanzas for multiple users might be sent over the same connection. S2S connections are similar to C2S connections from the point that one of the servers serves as an initiator, like a client. To exchanges stanzas in both directions between servers, two connections are established.</p>
+<p>To set up server-to-server functionality in Vysper, two configurations are needed:</p>
+<h2 id="allow-server-to-server-federation">Allow server-to-server federation</h2>
+<p>Server-to-server federation is by default disabled in Vysper. To enable sending stanzas to other servers, federations must be enabled:</p>
+<div class="codehilite"><pre><span class="n">XMPPServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPPServer</span><span class="p">(</span><span class="s">"vysper.org"</span><span class="p">);</span>
+
+<span class="sr">//</span> <span class="n">other</span> <span class="n">initialization</span>
+<span class="n">server</span><span class="o">.</span><span class="n">start</span><span class="p">();</span>
+
+<span class="sr">//</span> <span class="n">must</span> <span class="n">be</span> <span class="n">done</span> <span class="n">after</span> <span class="n">the</span> <span class="n">server</span> <span class="n">has</span> <span class="n">been</span> <span class="n">started</span>
+<span class="n">server</span><span class="o">.</span><span class="n">getServerRuntimeContext</span><span class="p">()</span><span class="o">.</span><span class="n">getServerFeatures</span><span class="p">()</span><span class="o">.</span><span class="n">setRelayingToFederationServers</span><span class="p">(</span><span class="n">true</span><span class="p">);</span>
+</pre></div>
+
+
+<h2 id="server-to-server-endpoint">Server-to-server endpoint</h2>
+<p>Next, an endpoint for incoming S2S connections must be added:</p>
+<div class="codehilite"><pre><span class="n">XMPPServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPPServer</span><span class="p">(</span><span class="s">"vysper.org"</span><span class="p">);</span>
+
+<span class="n">server</span><span class="o">.</span><span class="n">addEndpoint</span><span class="p">(</span><span class="k">new</span> <span class="n">S2SEndpoint</span><span class="p">());</span>
+
+<span class="sr">//</span> <span class="n">other</span> <span class="n">initialization</span>
+<span class="n">server</span><span class="o">.</span><span class="n">start</span><span class="p">();</span>
+
+<span class="sr">//</span> <span class="n">must</span> <span class="n">be</span> <span class="n">done</span> <span class="n">after</span> <span class="n">the</span> <span class="n">server</span> <span class="n">has</span> <span class="n">been</span> <span class="n">started</span>
+<span class="n">server</span><span class="o">.</span><span class="n">getServerRuntimeContext</span><span class="p">()</span><span class="o">.</span><span class="n">getServerFeatures</span><span class="p">()</span><span class="o">.</span><span class="n">setRelayingToFederationServers</span><span class="p">(</span><span class="n">true</span><span class="p">);</span>
+</pre></div>
+
+
+<p>Thatâs all that needs to be done. If SSL/TLS should be enabled between servers (will be negotiated during the S2S connection handshake), a keystore and keystore password must be configured:</p>
+<div class="codehilite"><pre><span class="n">server</span><span class="o">.</span><span class="n">setTLSCertificateInfo</span><span class="p">(</span><span class="k">new</span> <span class="n">File</span><span class="p">(</span><span class="s">"keystore.jks"</span><span class="p">),</span> <span class="s">"sekrit"</span><span class="p">);</span>
+</pre></div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/service_discovery.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/service_discovery.html (added)
+++ websites/staging/mina/trunk/content/vysper/service_discovery.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,152 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Service Discovery — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="using-service-discovery">Using Service Discovery</h1>
+<h2 id="disco-quick-start">Disco quick start</h2>
+<p>Service Discovery (or 'disco') is a XMPP extensions specified at (Service Discovery, XEP-0030).</p>
+<p>Disco resembles Directory services like LDAP, or even file systems.</p>
+<p>Disco is a server-side service. It maintains a tree of nodes (branches) and items (leafs). Clients discover child nodes and items of the root node or some other already discovered node by sending info-requests (IQ stanzas).
+The server replies with a IQ response containing a list of nodes and items.</p>
+<h2 id="using-disco">Using disco</h2>
+<p>In Vysper, Disco is itself implemented as a module (making it easy to swap disco implementations). The disco module must be loaded to link into it.</p>
+<p>Any module can publish its own features, nodes and items through disco to become 'discoverable' by clients and other servers and to expose 'stuff', whatever makes sense for that module.</p>
+<p>It is highly recommended that modules supporting disco extend DefaultDiscoAwareModule, which provides convenient integration with disco.</p>
+<p>Via DefaultDiscoAwareModule overrides, modules can register listeners for disco requests. If applicable, they simply add their part to the response. So, the disco-aware module has full control over the stuff it exposes.</p>
+<h2 id="the-most-simple-form-of-disco-is-to-advertise-a-feature-clients-knowing-about-that-feature-can-then-use-it-for-example-by-adding-special-payload-to-stanzas-by-interacting-with-the-module-through-dedicated-stanzas-or-by-using-more-disco">The most simple form of disco is to advertise a feature. Clients knowing about that feature can then use it, for example by adding special payload to stanzas, by interacting with the module through dedicated stanzas or by using more disco.</h2>
+<p>This is how a feature is advertised in the XEP-0092 implementation:</p>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>public class SoftwareVersionModule extends DefaultDiscoAwareModule implements ServerInfoRequestListener {
+ @Override
+ protected void addServerInfoRequestListeners(List<ServerInfoRequestListener> serverInfoRequestListeners) {
+ serverInfoRequestListeners.add(this);
+ } </p>
+<div class="codehilite"><pre><span class="n">public</span> <span class="n">List</span><span class="o">&</span><span class="ow">lt</span><span class="p">;</span><span class="n">InfoElement</span><span class="o">&</span><span class="ow">gt</span><span class="p">;</span> <span class="n">getServerInfosFor</span><span class="p">(</span><span class="n">InfoRequest</span> <span class="n">request</span><span class="p">)</span> <span class="p">{</span>
+ <span class="n">List</span><span class="o">&</span><span class="ow">lt</span><span class="p">;</span><span class="n">InfoElement</span><span class="o">&</span><span class="ow">gt</span><span class="p">;</span> <span class="n">infoElements</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ArrayList</span><span class="o">&</span><span class="ow">lt</span><span class="p">;</span><span class="n">InfoElement</span><span class="o">&</span><span class="ow">gt</span><span class="p">;();</span>
+ <span class="n">infoElements</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="k">new</span> <span class="n">Feature</span><span class="p">(</span><span class="n">NamespaceURIs</span><span class="o">.</span><span class="n">JABBER_IQ_VERSION</span><span class="p">));</span>
+ <span class="k">return</span> <span class="n">infoElements</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<p>}
+</PRE>
+</DIV></DIV></p>
+<p>At init time, the listener is registered, which is the module class itself ("this").
+On every disco request occuring on server level, disco calls the listener via getServerInfosFor(), and the module advertises its support for XEP-0092. Please note that in an advanced scenario, we can make the module's behavior depending on the properties of the InfoRequest parameter.</p>
+<h2 id="item-and-info-discovery">Item and Info discovery</h2>
+<p>They work similar, with similar listeners and callback.
+TODO: elaborate!</p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper/socks5.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper/socks5.html (added)
+++ websites/staging/mina/trunk/content/vysper/socks5.html Wed Oct 31 04:53:33 2012
@@ -0,0 +1,150 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper SOCKS5 bytestream module — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/vysper.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ <strong>Vysper</strong>
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+ <div id="navigation">
+<h5>Overview</h5>
+ <ul>
+ <li><a href="./..//vysper/index.html">Home</a> </li>
+ <li><a href="./..//vysper/documentation.html">Documentation</a></li>
+ <li><a href="./..//vysper/download.html">Downloads</a></li>
+ <li><a href="./..//vysper/sources.html">Source</a></li>
+ </ul>
+<h5>Community</h5>
+<ul>
+ <li><a href="./..//vysper/mailing_lists.html">Mailing Lists</a></li>
+ <li><a href="./..//vysper/getting_involved.html">Getting Involved</a></li>
+ <li><a href="./..//vysper/issue_tracking.html">Issue Tracking</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html">Contributing</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+
+<h5>Sponsorship</h5>
+<ul>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/">apache.org</a></li>
+</div>
+
+<!-- navigation -->
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="socks5-bytestream-module">SOCKS5 bytestream module</h1>
+<p><DIV class="info" markdown="1">
+ Available since version 0.7.
+</DIV></p>
+<p>The Vysper SOCKS5 Bytestream module implements mediated connections from XEP-0065 SOCKS5 Bytestream. Direct connections requires no support from the server and thus works without this module. For mediated connections, this module will supply a SOCKS5 proxy that transfers data between the requestor and target clients. The module also provides all the required service discovery support used to negotiate the address of the SOCKS5 proxy.</p>
+<p>The example below shows how to add the module using the API:</p>
+<div class="codehilite"><pre><span class="n">XMPPServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPPServer</span><span class="p">(</span><span class="o">&</span><span class="n">ldquo</span><span class="p">;</span><span class="n">vysper</span><span class="o">.</span><span class="n">org</span><span class="o">&</span><span class="n">rdquo</span><span class="p">;);</span>
+<span class="n">server</span><span class="o">.</span><span class="n">addEndpoint</span><span class="p">(</span><span class="k">new</span> <span class="n">TCPEndpoint</span><span class="p">());</span>
+
+<span class="sr">//</span> <span class="n">other</span> <span class="n">initialization</span>
+<span class="n">server</span><span class="o">.</span><span class="n">addModule</span><span class="p">(</span><span class="k">new</span> <span class="n">Socks5Module</span><span class="p">());</span>
+
+<span class="n">server</span><span class="o">.</span><span class="n">start</span><span class="p">();</span>
+</pre></div>
+
+
+<p>This will enable the SOCKS5 component on socks.vysper.org and start a proxy on port 5777. Make sure socks.vysper.org resolves to the server running Vysper.</p>
+<p>To configure the subdomain name, provide the subdomain in the constructor:</p>
+<div class="codehilite"><pre><span class="n">server</span><span class="o">.</span><span class="n">addModule</span><span class="p">(</span><span class="k">new</span> <span class="n">Socks5Module</span><span class="p">(</span><span class="s">"proxy"</span><span class="p">));</span>
+</pre></div>
+
+
+<p>In this case, the SOCKS5 component would be available on proxy.vysper.org.</p>
+<p>It is also possible to supply a socket address on which the proxy will be listening. This can be used to configure the port for the proxy, or the local address to bind the proxy to. For example:</p>
+<div class="codehilite"><pre><span class="n">server</span><span class="o">.</span><span class="n">addModule</span><span class="p">(</span><span class="k">new</span> <span class="n">Socks5Module</span><span class="p">(</span><span class="s">"proxy"</span><span class="p">,</span> <span class="k">new</span> <span class="n">InetSocketAddress</span><span class="p">(</span><span class="s">"foo.vysper.org"</span><span class="p">,</span> <span class="mi">18100</span><span class="p">)));</span>
+</pre></div>
+
+
+<p>With this code, the proxy will use the JID proxy.vysper.org, the hostname foo.vysper.org and the port 18100. It will only listen on the network interface for foo.vysper.org.</p>
+<p>server.addModule(new Socks5Module("proxy";, new> InetSocketAddress(18100)));</p>
+<p>In this case, the proxy will use the JID and hostname proxy.vysper.org and the port 18100. It will listen on all network interfaces.</p>
+<h2 id="limitations">Limitations</h2>
+<p>The module currently only supports unauthenticated SOCKS5 connections (support for username/password connections is tracked in <a href="https://issues.apache.org/jira/browse/VYSPER-280">VYSPER-280</a>).</p>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+