You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by er...@apache.org on 2010/10/31 10:02:57 UTC
svn commit: r1029279 - in /james/server/trunk/src/site: site.xml
xdoc/configuration.xml xdoc/configuration_serverwide.xml
xdoc/management.xml xdoc/management_domains.xml xdoc/management_users.xml
xdoc/management_virtualusers.xml
Author: eric
Date: Sun Oct 31 09:02:56 2010
New Revision: 1029279
URL: http://svn.apache.org/viewvc?rev=1029279&view=rev
Log:
Align and remove wrong stuff in configuration and management pages.
Modified:
james/server/trunk/src/site/site.xml
james/server/trunk/src/site/xdoc/configuration.xml
james/server/trunk/src/site/xdoc/configuration_serverwide.xml
james/server/trunk/src/site/xdoc/management.xml
james/server/trunk/src/site/xdoc/management_domains.xml
james/server/trunk/src/site/xdoc/management_users.xml
james/server/trunk/src/site/xdoc/management_virtualusers.xml
Modified: james/server/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/site.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/site.xml (original)
+++ james/server/trunk/src/site/site.xml Sun Oct 31 09:02:56 2010
@@ -58,7 +58,7 @@
<item name="1. Install James" href="/installation.html" />
<item name="2. Configure James" href="/configuration.html" collapse="true" >
<item name="Server-wide" href="/configuration_serverwide.html" />
- <item name="DomainList" href="/configuration_domainlist.html" />
+ <item name="Domain List" href="/configuration_domainlist.html" />
<item name="Users" href="/configuration_users.html" />
<item name="Mail Stores" href="/configuration_mailstores.html" />
<item name="DNS" href="/configuration_dns.html" />
Modified: james/server/trunk/src/site/xdoc/configuration.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/configuration.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/configuration.xml (original)
+++ james/server/trunk/src/site/xdoc/configuration.xml Sun Oct 31 09:02:56 2010
@@ -27,13 +27,12 @@
<section name="Configuration">
- <p>All configuration files resides in the conf and conf/META-INF directories.</p>
-
- <p>You can/must configure James for the following:</p>
+ <p>All configuration files resides in the ./conf/ and ./conf/META-INF/ directories.
+ You can/must configure James for the following:</p>
<ul>
<li><a href="configuration_serverwide.html">Server-wide Configuration</a></li>
- <li><a href="configuration_domainlist.html">Domains Configuration</a></li>
+ <li><a href="configuration_domainlist.html">Domain List Configuration</a></li>
<li><a href="configuration_users.html">Users Configuration</a></li>
<li><a href="configuration_mailstores.html">Mail Stores Configuration</a></li>
<li><a href="configuration_dns.html">DNS Configuration</a></li>
@@ -47,6 +46,22 @@
<li><a href="configuration_common.html">Common Configuration</a></li>
</ul>
+ <subsection name="JMX on Windows">
+
+ <div class="ui-widget">
+ <div class="ui-state-error ui-corner-all" style="padding: 0 .7em;">
+ <p><span class="ui-icon ui-icon-alert" style="float: left; margin-right: .3em;"></span>
+ <strong>JMX on Windows:</strong>
+ to let windows start with jmx username/password enabled,
+ you need to modify the security settings for the jmx files like descripted here:
+ <a href="http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html">
+ http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html</a>
+ </p>
+ </div>
+ </div>
+
+ </subsection>
+
</section>
</body>
Modified: james/server/trunk/src/site/xdoc/configuration_serverwide.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/configuration_serverwide.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/configuration_serverwide.xml (original)
+++ james/server/trunk/src/site/xdoc/configuration_serverwide.xml Sun Oct 31 09:02:56 2010
@@ -84,21 +84,6 @@
</subsection>
- <subsection name="Prepare for JMX on Windows">
-
- <p>for let windows start with jmx username/password enabled you need to modify the security settings for the jmx files
-like descripted here:
-http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html
-maybe you want to mention it in the docs ?
-user needs to modify security otherwise it won't work ?
-only for windoz
-or he need to disable user/pass on windows
-yes only windows
-on unix like operation systems the perms are correctly set
-</p>
-
-</subsection>
-
<subsection name="Other global configuration">
<p>Other configuration are available inside James.
Modified: james/server/trunk/src/site/xdoc/management.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/management.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/management.xml (original)
+++ james/server/trunk/src/site/xdoc/management.xml Sun Oct 31 09:02:56 2010
@@ -25,18 +25,56 @@
<body>
-<section name="Management">
-
- <p>Once James is up and listening, adding a user is simple:</p>
+ <section name="James Management">
+
+ <p>You can manage James via:</p>
+
<ul>
- <li>Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
- this is generally done by typing "telnet <host> <port>" where <host> is the James
- hostname and <port> is the RemoteManager port specified in the James config.xml.</li>
- <li>You will be prompted for your administrator userid and password. Enter the values you specified
- in the James config.xml.</li>
+ <li>JMX</li>
+ <li>Remote Manager</li>
</ul>
-
-</section>
+
+ <p>You need to make sure that your user/domain/mail repository configuration is correct before managing. If
+ you change your user/domain/mail repository type (i.e. file to database) or the configuration of your user repository
+ (i.e. the file or database URL) after you have added user/domain/mail, you may lose your user/domain/mail data. Please change these
+ values with care.</p>
+
+ <p>After you've done this, restart James to ensure that any changes you've made in the configuration are incorporated into
+ the running system. You are now ready to create users/domains.</p>
+
+ <subsection name="Management via JMX">
+
+ <p>James can be managed via JMX. Simply launch jconsole to access
+ the exposed attributes and methods.</p>
+
+ <div class="ui-widget">
+ <div class="ui-state-error ui-corner-all" style="padding: 0 .7em;">
+ <p><span class="ui-icon ui-icon-alert" style="float: left; margin-right: .3em;"></span>
+ <strong>JMX on Windows:</strong>
+ to let windows start with jmx username/password enabled,
+ you need to modify the security settings for the jmx files like descripted here:
+ <a href="http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html">
+ http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windows.html</a>
+ </p>
+ </div>
+ </div>
+
+ </subsection>
+
+ <subsection name="Management via Telnet">
+
+ <p>Once James is up and listening, adding a user is simple:</p>
+ <ul>
+ <li>Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
+ this is generally done by typing "telnet <host> <port>" where <host> is the James
+ hostname and <port> is the RemoteManager port specified in the James config.xml.</li>
+ <li>You will be prompted for your administrator userid and password. Enter the values you specified
+ in the James remotemanager.xml.</li>
+ </ul>
+
+ </subsection>
+
+ </section>
</body>
Modified: james/server/trunk/src/site/xdoc/management_domains.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/management_domains.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/management_domains.xml (original)
+++ james/server/trunk/src/site/xdoc/management_domains.xml Sun Oct 31 09:02:56 2010
@@ -20,43 +20,35 @@
<document>
<properties>
- <title>James 3.0 - Adding Domains</title>
+ <title>James 3.0 - Manage Domains</title>
</properties>
<body>
- <section name="Creating User Accounts">
+ <section name="Manage Domains">
- <p>User accounts are shared across services. A common user repository is shared across James
- services. That is, once you've created a POP3 mail account and set a password, that same
- account is available for authenticated SMTP and NNTP.</p>
+ <p>Domain accounts are shared across services. A common Domain repository is shared across James
+ services. That is, once you've created a POP3 mail and set a password, that same
+ is available for authenticated SMTP and NNTP.</p>
- <subsection name="Before You Add Accounts">
- <p>In James, user accounts are created throught the RemoteManager. So, after installation is complete, the first step to adding users
- is to configure the RemoteManager. More information on RemoteManager configuration can be found
- <a href="remotemanager_configuration.html">here</a>. You will need to have configured at least one administrator account and
- ensured that the RemoteManager is enabled.</p>
- <p>Also, you need to make sure that your user repository configuration is correct before adding any users. If
- you change your user repository type (i.e. file to database) or the configuration of your user repository
- (i.e. the file or database URL) after you have added users, you may lose your user data. Please change these
- values with care.</p>
- <p>After you've done this, restart James to ensure that any changes you've made in the configuration are incorporated into
- the running system. You are now ready to create user accounts.</p>
- </subsection>
-
- <p>Once James is up and listening, adding a user is simple:</p>
- 1. Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
+ <p>Once James is up and listening, adding a Domain is simple:</p>
+
+ <p>1. Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
this is generally done by typing "telnet <host> <port>" where <host> is the James
- hostname and <port> is the RemoteManager port specified in the James config.xml.<br/><br/>
- 2. You will be prompted for your administrator userid and password. Enter the values you specified
- in the James config.xml.<br/><br/>
- 3. After logging in, type "adduser <user> <password>" where <user> is the user name
- and <password> is the password of the account you wish to create. Please note that the user name
- should NOT be a complete email address. Rather, all email addresses of the form <user>@<domain>
+ hostname and <port> is the RemoteManager port specified in the James config.xml.</p>
+
+ <p>2. You will be prompted for your administrator Domainid and password. Enter the values you specified
+ in the James config.xml.</p>
+
+ <p>3. After logging in, type "addDomain <Domain> <password>" where <Domain> is the Domain name
+ and <password> is the password of the you wish to create. Please note that the Domain name
+ should NOT be a complete email address. Rather, all email addresses of the form <Domain>@<domain>
(where <domain> is any of the values specified in the <servernames> block) will be delivered to
- this account by default. Mailet configuration can change this default behavior.<br/><br/>
- 4. Repeat step 3 for all user accounts you wish to create.
- <p>That's it. Your user accounts are now created and can be used by all James services.</p>
+ this by default. Mailet configuration can change this default behavior.</p>
+
+ <p>4. Repeat step 3 for all Domain you wish to create.</p>
+
+ <p>That's it. Your Domain are now created and can be used by all James services.</p>
</section>
Modified: james/server/trunk/src/site/xdoc/management_users.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/management_users.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/management_users.xml (original)
+++ james/server/trunk/src/site/xdoc/management_users.xml Sun Oct 31 09:02:56 2010
@@ -25,37 +25,29 @@
<body>
- <section name="Creating User Accounts">
+ <section name="Manage Users">
<p>User accounts are shared across services. A common user repository is shared across James
services. That is, once you've created a POP3 mail account and set a password, that same
account is available for authenticated SMTP and NNTP.</p>
- <subsection name="Before You Add Accounts">
- <p>In James, user accounts are created throught the RemoteManager. So, after installation is complete, the first step to adding users
- is to configure the RemoteManager. More information on RemoteManager configuration can be found
- <a href="remotemanager_configuration.html">here</a>. You will need to have configured at least one administrator account and
- ensured that the RemoteManager is enabled.</p>
- <p>Also, you need to make sure that your user repository configuration is correct before adding any users. If
- you change your user repository type (i.e. file to database) or the configuration of your user repository
- (i.e. the file or database URL) after you have added users, you may lose your user data. Please change these
- values with care.</p>
- <p>After you've done this, restart James to ensure that any changes you've made in the configuration are incorporated into
- the running system. You are now ready to create user accounts.</p>
- </subsection>
-
<p>Once James is up and listening, adding a user is simple:</p>
- 1. Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
+
+ <p>1. Telnet to the host and port on which the RemoteManager is listening. For command-line telnet clients
this is generally done by typing "telnet <host> <port>" where <host> is the James
- hostname and <port> is the RemoteManager port specified in the James config.xml.<br/><br/>
- 2. You will be prompted for your administrator userid and password. Enter the values you specified
- in the James config.xml.<br/><br/>
- 3. After logging in, type "adduser <user> <password>" where <user> is the user name
+ hostname and <port> is the RemoteManager port specified in the James config.xml.</p>
+
+ <p>2. You will be prompted for your administrator userid and password. Enter the values you specified
+ in the James config.xml.</p>
+
+ <p>3. After logging in, type "adduser <user> <password>" where <user> is the user name
and <password> is the password of the account you wish to create. Please note that the user name
should NOT be a complete email address. Rather, all email addresses of the form <user>@<domain>
(where <domain> is any of the values specified in the <servernames> block) will be delivered to
- this account by default. Mailet configuration can change this default behavior.<br/><br/>
- 4. Repeat step 3 for all user accounts you wish to create.
+ this account by default. Mailet configuration can change this default behavior.</p>
+
+ <p>4. Repeat step 3 for all user accounts you wish to create.</p>
+
<p>That's it. Your user accounts are now created and can be used by all James services.</p>
</section>
Modified: james/server/trunk/src/site/xdoc/management_virtualusers.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/management_virtualusers.xml?rev=1029279&r1=1029278&r2=1029279&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/management_virtualusers.xml (original)
+++ james/server/trunk/src/site/xdoc/management_virtualusers.xml Sun Oct 31 09:02:56 2010
@@ -20,12 +20,12 @@
<document>
<properties>
- <title>James 3.0 - Adding Virtual Users</title>
+ <title>James 3.0 - Manage Virtual Users</title>
</properties>
<body>
- <section name="Creating Virtual User">
+ <section name="Manage Virtual Users">
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org