You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-user@james.apache.org by Eric Charles <er...@apache.org> on 2010/11/08 11:21:09 UTC
Quick Start for 3.0-M2
Hi Everyone,
I tried to make a short (though complete) quick start doc for 3.0-M2.
The goal of the doc is to allow anyone to start with James binary
distribution as an operational mail server.
Feel free to give it a try (should be valid for 3.0-M1) and send your
feedback so we can have the best possible doc for upcoming 3.0-M2 release.
Tks,
Eric
Step 0: Requirements
####################
JRE 1.5+
root (linux/unix) or Administrator (Windows)
libc6 (linux)
512MB RAM
Step 1: Download
#################
Download james-server-container-spring-3.0-M2-bin.zip from
http://james.apache.org/download.cgi#Apache_James_Server
Step 2: Deploy
##############
Unzip james-server-container-spring-3.0-M2-bin.zip.
You should have a folder with sub-folders bin, conf, lib, log, var and
four text files.
$ unzip james-server-container-spring-3.0-M2-bin.tar.gz
$ cd james-server-container-spring-3.0-M2
$ ls -l
drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
-rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
-rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
-rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
-rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
Step 3: Configure
#################
All configuration files reside in the conf folder.
$ cd conf
$ ls -l
-rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
-rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
-rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
-rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
-rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
-rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
-rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
-rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
-rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
-rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
-rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
-rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
-rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
-rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
-rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
-rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
-rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
-rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
-rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
-rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
-rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
-rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
-rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
-rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
James is packaged with virtual hosting disabled, XML domain list, JPA
(Derby database) storage for the mails and remote delivery from locahost
only.
You can edit the following files to change the behaviour:
- Enable virtual hosting in mailserver.xml: vi mailserver.xml
<enableVirtualHosting> true </enableVirtualHosting>
- Replace the XMLDomainList with the JPADomainList: vi usersrepository.xml
<domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
<autodetect>true</autodetect>
<autodetectIP>true</autodetectIP>
</domainlist>
- Edit the database.properties and change the values according to your
database.
- Don't forget to add the needed JDBC driver jar in the ./conf/lib folder.
Step 4: Start
#############
$ cd bin
$ ./james start (!! you need libc6 installed on Linux - sudo apt-get
install libc6-i386 libc6-dev-i386 on ubuntu)
You can see log result in the log/james-server.log file.
Step 5: Create Domains and Users
################################
$ telnet localhost 4555
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
JAMES Remote Administration Tool
Please enter your login and password
Login id:
root
Password:
root
Welcome root. HELP for a list of commands
adddomain YOUR_DOMAIN
Adding domain YOUR_DOMAIN successful
adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
User YOUR_NAME@YOUR_DOMAIN added
quit
Bye
Connection closed by foreign host.
For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will have
a test@localhost.net user.
The username to use in you mail client will be test@localhost.net.
Step 6: Test
############
$ telnet 127.0.0.1 25
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
2010 17:31:33 +0100 (CET)
ehlo test
250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
250-PIPELINING
250-ENHANCEDSTATUSCODES
250 8BITMIME
mail from:<YOUR_NAME@YOUR_DOMAIN>
250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
rcpt to:<YOUR_NAME@YOUR_DOMAIN>
250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
data
354 Ok Send data ending with <CRLF>.<CRLF>
subject: test
this is a test
.
250 2.6.0 Message received
quit
Connection closed by foreign host.
Step 7: Manage
##############
7.1. Manage via telnet
$ telnet localhost 4555
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
JAMES Remote Administration Tool
Please enter your login and password
Login id:
root
Password:
root
Welcome root. HELP for a list of commands
help
adddomain [domainname] add domain to local domains
addmapping [toUser@toDomain] [fromMapping] add mapping for the
given emailaddress
adduser [username] [password] add a new user
countusers display the number of existing accounts
deluser [username] delete existing user
help displays this help
listallmappings list all mappings
listdomains list local domains
listmapping [user@domain] list all mappings for the given emailaddress
listusers display existing accounts
memstat ([-gc]) shows memory usage. When called with -gc the garbage
collector get called
quit close connection
removedomain [domainname] remove domain from local domains
removemapping [toUser@toDomain] [fromMapping] remove mapping for the
given emailaddress
setpassword [username] [password] sets a user's password
showalias [username] shows a user's current email alias
showforwarding [username] shows a user's current email forwarding
shutdown kills the current JVM (convenient when James is run as a
daemon)
unsetalias [user] unsets an alias for 'user'
unsetforwarding [username] removes a forward
user [repositoryname] change to another user repository
verify [username] verify if specified user exist
7.2. Manage via JMX
Launch jconsole (or any other JMX client) and connect on
URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
Step 8: Monitor
##############
Monitor the ./log/james-server.log log file.
Monitor via JMX (launch any JMX client and connect to
URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi,
James now starts with -Xmx512M (in the bat/sh) so JVM can eat until 512M
(It does not mean it will do).
It really depends on your traffic, and also which database you will use
(you can save much memory if you don't use the default embedded derby
database but an external database of your choice).
The goal is to have a minimum footprint, and work done by Norman
between M1 and M2 showed we came to a drastic diminution (factor 2 !!)
of the memory usage. And there is maybe still room for improvement.
I will moderate the 512MB number in the quick-start and requirement
section of the install page :), saying also you can change this parameter.
To add users, there are 2 ways: telnet and JMX. The quick start only
shows it via Telnet, but section 8 says you can manage via Telnet.
I will add a reference to add user via JMX.
tks,
Eric
On 11/11/2010 07:54, Norman wrote:
> Hi Eric,
>
> the memory you need depends on the workload of James.. Thats all I can
> say about it, if you don't have heavy traffic you should be able to
> cut it down. Its just a "sane" default ;)
> About adding users direcly into the db, I don't think there will be a
> doc. You should use JMX todo this as this will save you from database
> schema changes later...
>
> Bye,
> Norman
>
> Am 11.11.2010 06:21, schrieb Eric MacAdie:
>> I am running James on Linux.
>>
>> Regards,
>> Eric MacAdie
>> President, Chicago Java Users Group
>> http://blog.cjug.org
>>
>> On 11/10/2010 10:36 PM, Gerry Matte wrote:
>>> Hi Eric.
>>> I don't know the answer but I suspect that you need to specify
>>> whether you are running on Unix or Windows .......
>>> Just a suggestion to save time.
>>>
>>> It would be a good idea if Eric added a longer or more explicit
>>> description of the memory requirements on each platform to his
>>> quickstart document.
>>> Gerry
>>>
>>> --------------------------------------------------
>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>> Sent: Wednesday, November 10, 2010 8:29 PM
>>> To: "James Users List" <se...@james.apache.org>
>>> Subject: Re: Quick Start for 3.0-M2
>>>
>>>> I have a couple of questions:
>>>>
>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>> (and a James server) on a VPS account that has 512 MB RAM total. Is
>>>> James 3 not an option for me?
>>>>
>>>> 2. Are there plans on documenting how to add users to the database?
>>>> If I can run James 3 on my VPS, I may be able to help with this.
>>>> Telnetting into the remote manager is not something I have any
>>>> interest in at all.
>>>>
>>>> Regards,
>>>> Eric MacAdie
>>>> President, Chicago Java Users Group
>>>> http://blog.cjug.org
>>>>
>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>> Hi Everyone,
>>>>>
>>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>> distribution as an operational mail server.
>>>>>
>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>> your feedback so we can have the best possible doc for upcoming
>>>>> 3.0-M2 release.
>>>>> Tks,
>>>>>
>>>>> Eric
>>>>>
>>>>> Step 0: Requirements
>>>>> ####################
>>>>>
>>>>> JRE 1.5+
>>>>> root (linux/unix) or Administrator (Windows)
>>>>> libc6 (linux)
>>>>> 512MB RAM
>>>>>
>>>>> Step 1: Download
>>>>> #################
>>>>>
>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>
>>>>> Step 2: Deploy
>>>>> ##############
>>>>>
>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>>> and four text files.
>>>>>
>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>> $ cd james-server-container-spring-3.0-M2
>>>>> $ ls -l
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>
>>>>>
>>>>> Step 3: Configure
>>>>> #################
>>>>>
>>>>> All configuration files reside in the conf folder.
>>>>>
>>>>> $ cd conf
>>>>> $ ls -l
>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>
>>>>>
>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>> JPA (Derby database) storage for the mails and remote delivery
>>>>> from locahost only.
>>>>> You can edit the following files to change the behaviour:
>>>>>
>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>
>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>> usersrepository.xml
>>>>> <domainlist
>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>> <autodetect>true</autodetect>
>>>>> <autodetectIP>true</autodetectIP>
>>>>> </domainlist>
>>>>>
>>>>> - Edit the database.properties and change the values according to
>>>>> your database.
>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>> folder.
>>>>>
>>>>> Step 4: Start
>>>>> #############
>>>>>
>>>>> $ cd bin
>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo
>>>>> apt-get install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>> You can see log result in the log/james-server.log file.
>>>>>
>>>>> Step 5: Create Domains and Users
>>>>> ################################
>>>>>
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> adddomain YOUR_DOMAIN
>>>>> Adding domain YOUR_DOMAIN successful
>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>> quit
>>>>> Bye
>>>>> Connection closed by foreign host.
>>>>>
>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you
>>>>> will have a test@localhost.net user.
>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>
>>>>> Step 6: Test
>>>>> ############
>>>>>
>>>>> $ telnet 127.0.0.1 25
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat,
>>>>> 6 Nov 2010 17:31:33 +0100 (CET)
>>>>> ehlo test
>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>> 250-PIPELINING
>>>>> 250-ENHANCEDSTATUSCODES
>>>>> 250 8BITMIME
>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> data
>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>> subject: test
>>>>>
>>>>> this is a test
>>>>> .
>>>>> 250 2.6.0 Message received
>>>>> quit
>>>>> Connection closed by foreign host.
>>>>>
>>>>> Step 7: Manage
>>>>> ##############
>>>>>
>>>>> 7.1. Manage via telnet
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> help
>>>>> adddomain [domainname] add domain to local domains
>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for
>>>>> the given emailaddress
>>>>> adduser [username] [password] add a new user
>>>>> countusers display the number of existing accounts
>>>>> deluser [username] delete existing user
>>>>> help displays this help
>>>>> listallmappings list all mappings
>>>>> listdomains list local domains
>>>>> listmapping [user@domain] list all mappings for the given
>>>>> emailaddress
>>>>> listusers display existing accounts
>>>>> memstat ([-gc]) shows memory usage. When called with -gc the
>>>>> garbage collector get called
>>>>> quit close connection
>>>>> removedomain [domainname] remove domain from local domains
>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>> the given emailaddress
>>>>> setpassword [username] [password] sets a user's password
>>>>> showalias [username] shows a user's current email alias
>>>>> showforwarding [username] shows a user's current email
>>>>> forwarding
>>>>> shutdown kills the current JVM (convenient when James is
>>>>> run as a daemon)
>>>>> unsetalias [user] unsets an alias for 'user'
>>>>> unsetforwarding [username] removes a forward
>>>>> user [repositoryname] change to another user repository
>>>>> verify [username] verify if specified user exist
>>>>>
>>>>> 7.2. Manage via JMX
>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>
>>>>> Step 8: Monitor
>>>>> ##############
>>>>>
>>>>> Monitor the ./log/james-server.log log file.
>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>
>>>>>
>>>>>
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Simply launch jconsole (or install jmanage or any other jmx client) and
connect to URL = service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
Tks,
Eric
On 11/11/2010 08:12, Eric MacAdie wrote:
> Maybe this is a dumb question, but: How do I use JMX? Will I need to
> install Tomcat or some other app server?
>
> Regards,
> Eric MacAdie
> President, Chicago Java Users Group
> http://blog.cjug.org
>
> On 11/11/2010 12:54 AM, Norman wrote:
>> Hi Eric,
>>
>> the memory you need depends on the workload of James.. Thats all I
>> can say about it, if you don't have heavy traffic you should be able
>> to cut it down. Its just a "sane" default ;)
>> About adding users direcly into the db, I don't think there will be a
>> doc. You should use JMX todo this as this will save you from database
>> schema changes later...
>>
>> Bye,
>> Norman
>>
>> Am 11.11.2010 06:21, schrieb Eric MacAdie:
>>> I am running James on Linux.
>>>
>>> Regards,
>>> Eric MacAdie
>>> President, Chicago Java Users Group
>>> http://blog.cjug.org
>>>
>>> On 11/10/2010 10:36 PM, Gerry Matte wrote:
>>>> Hi Eric.
>>>> I don't know the answer but I suspect that you need to specify
>>>> whether you are running on Unix or Windows .......
>>>> Just a suggestion to save time.
>>>>
>>>> It would be a good idea if Eric added a longer or more explicit
>>>> description of the memory requirements on each platform to his
>>>> quickstart document.
>>>> Gerry
>>>>
>>>> --------------------------------------------------
>>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>>> Sent: Wednesday, November 10, 2010 8:29 PM
>>>> To: "James Users List" <se...@james.apache.org>
>>>> Subject: Re: Quick Start for 3.0-M2
>>>>
>>>>> I have a couple of questions:
>>>>>
>>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>>> (and a James server) on a VPS account that has 512 MB RAM total.
>>>>> Is James 3 not an option for me?
>>>>>
>>>>> 2. Are there plans on documenting how to add users to the
>>>>> database? If I can run James 3 on my VPS, I may be able to help
>>>>> with this. Telnetting into the remote manager is not something I
>>>>> have any interest in at all.
>>>>>
>>>>> Regards,
>>>>> Eric MacAdie
>>>>> President, Chicago Java Users Group
>>>>> http://blog.cjug.org
>>>>>
>>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>>> Hi Everyone,
>>>>>>
>>>>>> I tried to make a short (though complete) quick start doc for
>>>>>> 3.0-M2.
>>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>>> distribution as an operational mail server.
>>>>>>
>>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>>> your feedback so we can have the best possible doc for upcoming
>>>>>> 3.0-M2 release.
>>>>>> Tks,
>>>>>>
>>>>>> Eric
>>>>>>
>>>>>> Step 0: Requirements
>>>>>> ####################
>>>>>>
>>>>>> JRE 1.5+
>>>>>> root (linux/unix) or Administrator (Windows)
>>>>>> libc6 (linux)
>>>>>> 512MB RAM
>>>>>>
>>>>>> Step 1: Download
>>>>>> #################
>>>>>>
>>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>>
>>>>>> Step 2: Deploy
>>>>>> ##############
>>>>>>
>>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>>> You should have a folder with sub-folders bin, conf, lib, log,
>>>>>> var and four text files.
>>>>>>
>>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>>> $ cd james-server-container-spring-3.0-M2
>>>>>> $ ls -l
>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>>
>>>>>>
>>>>>> Step 3: Configure
>>>>>> #################
>>>>>>
>>>>>> All configuration files reside in the conf folder.
>>>>>>
>>>>>> $ cd conf
>>>>>> $ ls -l
>>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>>
>>>>>>
>>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>>> JPA (Derby database) storage for the mails and remote delivery
>>>>>> from locahost only.
>>>>>> You can edit the following files to change the behaviour:
>>>>>>
>>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>>
>>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>>> usersrepository.xml
>>>>>> <domainlist
>>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>>> <autodetect>true</autodetect>
>>>>>> <autodetectIP>true</autodetectIP>
>>>>>> </domainlist>
>>>>>>
>>>>>> - Edit the database.properties and change the values according to
>>>>>> your database.
>>>>>> - Don't forget to add the needed JDBC driver jar in the
>>>>>> ./conf/lib folder.
>>>>>>
>>>>>> Step 4: Start
>>>>>> #############
>>>>>>
>>>>>> $ cd bin
>>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo
>>>>>> apt-get install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>>> You can see log result in the log/james-server.log file.
>>>>>>
>>>>>> Step 5: Create Domains and Users
>>>>>> ################################
>>>>>>
>>>>>> $ telnet localhost 4555
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> JAMES Remote Administration Tool
>>>>>> Please enter your login and password
>>>>>> Login id:
>>>>>> root
>>>>>> Password:
>>>>>> root
>>>>>> Welcome root. HELP for a list of commands
>>>>>> adddomain YOUR_DOMAIN
>>>>>> Adding domain YOUR_DOMAIN successful
>>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>>> quit
>>>>>> Bye
>>>>>> Connection closed by foreign host.
>>>>>>
>>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you
>>>>>> will have a test@localhost.net user.
>>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>>
>>>>>> Step 6: Test
>>>>>> ############
>>>>>>
>>>>>> $ telnet 127.0.0.1 25
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready
>>>>>> Sat, 6 Nov 2010 17:31:33 +0100 (CET)
>>>>>> ehlo test
>>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>>> 250-PIPELINING
>>>>>> 250-ENHANCEDSTATUSCODES
>>>>>> 250 8BITMIME
>>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>> data
>>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>>> subject: test
>>>>>>
>>>>>> this is a test
>>>>>> .
>>>>>> 250 2.6.0 Message received
>>>>>> quit
>>>>>> Connection closed by foreign host.
>>>>>>
>>>>>> Step 7: Manage
>>>>>> ##############
>>>>>>
>>>>>> 7.1. Manage via telnet
>>>>>> $ telnet localhost 4555
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> JAMES Remote Administration Tool
>>>>>> Please enter your login and password
>>>>>> Login id:
>>>>>> root
>>>>>> Password:
>>>>>> root
>>>>>> Welcome root. HELP for a list of commands
>>>>>> help
>>>>>> adddomain [domainname] add domain to local domains
>>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for
>>>>>> the given emailaddress
>>>>>> adduser [username] [password] add a new user
>>>>>> countusers display the number of existing accounts
>>>>>> deluser [username] delete existing user
>>>>>> help displays this help
>>>>>> listallmappings list all mappings
>>>>>> listdomains list local domains
>>>>>> listmapping [user@domain] list all mappings for the given
>>>>>> emailaddress
>>>>>> listusers display existing accounts
>>>>>> memstat ([-gc]) shows memory usage. When called with -gc the
>>>>>> garbage collector get called
>>>>>> quit close connection
>>>>>> removedomain [domainname] remove domain from local domains
>>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping
>>>>>> for the given emailaddress
>>>>>> setpassword [username] [password] sets a user's password
>>>>>> showalias [username] shows a user's current email alias
>>>>>> showforwarding [username] shows a user's current email
>>>>>> forwarding
>>>>>> shutdown kills the current JVM (convenient when James is
>>>>>> run as a daemon)
>>>>>> unsetalias [user] unsets an alias for 'user'
>>>>>> unsetforwarding [username] removes a forward
>>>>>> user [repositoryname] change to another user repository
>>>>>> verify [username] verify if specified user exist
>>>>>>
>>>>>> 7.2. Manage via JMX
>>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>>
>>>>>> Step 8: Monitor
>>>>>> ##############
>>>>>>
>>>>>> Monitor the ./log/james-server.log log file.
>>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric MacAdie <er...@MacAdie.net>.
Maybe this is a dumb question, but: How do I use JMX? Will I need to
install Tomcat or some other app server?
Regards,
Eric MacAdie
President, Chicago Java Users Group
http://blog.cjug.org
On 11/11/2010 12:54 AM, Norman wrote:
> Hi Eric,
>
> the memory you need depends on the workload of James.. Thats all I can
> say about it, if you don't have heavy traffic you should be able to
> cut it down. Its just a "sane" default ;)
> About adding users direcly into the db, I don't think there will be a
> doc. You should use JMX todo this as this will save you from database
> schema changes later...
>
> Bye,
> Norman
>
> Am 11.11.2010 06:21, schrieb Eric MacAdie:
>> I am running James on Linux.
>>
>> Regards,
>> Eric MacAdie
>> President, Chicago Java Users Group
>> http://blog.cjug.org
>>
>> On 11/10/2010 10:36 PM, Gerry Matte wrote:
>>> Hi Eric.
>>> I don't know the answer but I suspect that you need to specify
>>> whether you are running on Unix or Windows .......
>>> Just a suggestion to save time.
>>>
>>> It would be a good idea if Eric added a longer or more explicit
>>> description of the memory requirements on each platform to his
>>> quickstart document.
>>> Gerry
>>>
>>> --------------------------------------------------
>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>> Sent: Wednesday, November 10, 2010 8:29 PM
>>> To: "James Users List" <se...@james.apache.org>
>>> Subject: Re: Quick Start for 3.0-M2
>>>
>>>> I have a couple of questions:
>>>>
>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>> (and a James server) on a VPS account that has 512 MB RAM total. Is
>>>> James 3 not an option for me?
>>>>
>>>> 2. Are there plans on documenting how to add users to the database?
>>>> If I can run James 3 on my VPS, I may be able to help with this.
>>>> Telnetting into the remote manager is not something I have any
>>>> interest in at all.
>>>>
>>>> Regards,
>>>> Eric MacAdie
>>>> President, Chicago Java Users Group
>>>> http://blog.cjug.org
>>>>
>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>> Hi Everyone,
>>>>>
>>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>> distribution as an operational mail server.
>>>>>
>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>> your feedback so we can have the best possible doc for upcoming
>>>>> 3.0-M2 release.
>>>>> Tks,
>>>>>
>>>>> Eric
>>>>>
>>>>> Step 0: Requirements
>>>>> ####################
>>>>>
>>>>> JRE 1.5+
>>>>> root (linux/unix) or Administrator (Windows)
>>>>> libc6 (linux)
>>>>> 512MB RAM
>>>>>
>>>>> Step 1: Download
>>>>> #################
>>>>>
>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>
>>>>> Step 2: Deploy
>>>>> ##############
>>>>>
>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>>> and four text files.
>>>>>
>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>> $ cd james-server-container-spring-3.0-M2
>>>>> $ ls -l
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>
>>>>>
>>>>> Step 3: Configure
>>>>> #################
>>>>>
>>>>> All configuration files reside in the conf folder.
>>>>>
>>>>> $ cd conf
>>>>> $ ls -l
>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>
>>>>>
>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>> JPA (Derby database) storage for the mails and remote delivery
>>>>> from locahost only.
>>>>> You can edit the following files to change the behaviour:
>>>>>
>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>
>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>> usersrepository.xml
>>>>> <domainlist
>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>> <autodetect>true</autodetect>
>>>>> <autodetectIP>true</autodetectIP>
>>>>> </domainlist>
>>>>>
>>>>> - Edit the database.properties and change the values according to
>>>>> your database.
>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>> folder.
>>>>>
>>>>> Step 4: Start
>>>>> #############
>>>>>
>>>>> $ cd bin
>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo
>>>>> apt-get install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>> You can see log result in the log/james-server.log file.
>>>>>
>>>>> Step 5: Create Domains and Users
>>>>> ################################
>>>>>
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> adddomain YOUR_DOMAIN
>>>>> Adding domain YOUR_DOMAIN successful
>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>> quit
>>>>> Bye
>>>>> Connection closed by foreign host.
>>>>>
>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you
>>>>> will have a test@localhost.net user.
>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>
>>>>> Step 6: Test
>>>>> ############
>>>>>
>>>>> $ telnet 127.0.0.1 25
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat,
>>>>> 6 Nov 2010 17:31:33 +0100 (CET)
>>>>> ehlo test
>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>> 250-PIPELINING
>>>>> 250-ENHANCEDSTATUSCODES
>>>>> 250 8BITMIME
>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> data
>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>> subject: test
>>>>>
>>>>> this is a test
>>>>> .
>>>>> 250 2.6.0 Message received
>>>>> quit
>>>>> Connection closed by foreign host.
>>>>>
>>>>> Step 7: Manage
>>>>> ##############
>>>>>
>>>>> 7.1. Manage via telnet
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> help
>>>>> adddomain [domainname] add domain to local domains
>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for
>>>>> the given emailaddress
>>>>> adduser [username] [password] add a new user
>>>>> countusers display the number of existing accounts
>>>>> deluser [username] delete existing user
>>>>> help displays this help
>>>>> listallmappings list all mappings
>>>>> listdomains list local domains
>>>>> listmapping [user@domain] list all mappings for the given
>>>>> emailaddress
>>>>> listusers display existing accounts
>>>>> memstat ([-gc]) shows memory usage. When called with -gc the
>>>>> garbage collector get called
>>>>> quit close connection
>>>>> removedomain [domainname] remove domain from local domains
>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>> the given emailaddress
>>>>> setpassword [username] [password] sets a user's password
>>>>> showalias [username] shows a user's current email alias
>>>>> showforwarding [username] shows a user's current email
>>>>> forwarding
>>>>> shutdown kills the current JVM (convenient when James is
>>>>> run as a daemon)
>>>>> unsetalias [user] unsets an alias for 'user'
>>>>> unsetforwarding [username] removes a forward
>>>>> user [repositoryname] change to another user repository
>>>>> verify [username] verify if specified user exist
>>>>>
>>>>> 7.2. Manage via JMX
>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>
>>>>> Step 8: Monitor
>>>>> ##############
>>>>>
>>>>> Monitor the ./log/james-server.log log file.
>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Norman <no...@apache.org>.
Hi Eric,
the memory you need depends on the workload of James.. Thats all I can
say about it, if you don't have heavy traffic you should be able to cut
it down. Its just a "sane" default ;)
About adding users direcly into the db, I don't think there will be a
doc. You should use JMX todo this as this will save you from database
schema changes later...
Bye,
Norman
Am 11.11.2010 06:21, schrieb Eric MacAdie:
> I am running James on Linux.
>
> Regards,
> Eric MacAdie
> President, Chicago Java Users Group
> http://blog.cjug.org
>
> On 11/10/2010 10:36 PM, Gerry Matte wrote:
>> Hi Eric.
>> I don't know the answer but I suspect that you need to specify
>> whether you are running on Unix or Windows .......
>> Just a suggestion to save time.
>>
>> It would be a good idea if Eric added a longer or more explicit
>> description of the memory requirements on each platform to his
>> quickstart document.
>> Gerry
>>
>> --------------------------------------------------
>> From: "Eric MacAdie" <er...@MacAdie.net>
>> Sent: Wednesday, November 10, 2010 8:29 PM
>> To: "James Users List" <se...@james.apache.org>
>> Subject: Re: Quick Start for 3.0-M2
>>
>>> I have a couple of questions:
>>>
>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>> (and a James server) on a VPS account that has 512 MB RAM total. Is
>>> James 3 not an option for me?
>>>
>>> 2. Are there plans on documenting how to add users to the database?
>>> If I can run James 3 on my VPS, I may be able to help with this.
>>> Telnetting into the remote manager is not something I have any
>>> interest in at all.
>>>
>>> Regards,
>>> Eric MacAdie
>>> President, Chicago Java Users Group
>>> http://blog.cjug.org
>>>
>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>> Hi Everyone,
>>>>
>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>> The goal of the doc is to allow anyone to start with James binary
>>>> distribution as an operational mail server.
>>>>
>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>> your feedback so we can have the best possible doc for upcoming
>>>> 3.0-M2 release.
>>>> Tks,
>>>>
>>>> Eric
>>>>
>>>> Step 0: Requirements
>>>> ####################
>>>>
>>>> JRE 1.5+
>>>> root (linux/unix) or Administrator (Windows)
>>>> libc6 (linux)
>>>> 512MB RAM
>>>>
>>>> Step 1: Download
>>>> #################
>>>>
>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>
>>>> Step 2: Deploy
>>>> ##############
>>>>
>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>> and four text files.
>>>>
>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>> $ cd james-server-container-spring-3.0-M2
>>>> $ ls -l
>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>
>>>>
>>>> Step 3: Configure
>>>> #################
>>>>
>>>> All configuration files reside in the conf folder.
>>>>
>>>> $ cd conf
>>>> $ ls -l
>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>
>>>>
>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>> JPA (Derby database) storage for the mails and remote delivery from
>>>> locahost only.
>>>> You can edit the following files to change the behaviour:
>>>>
>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>
>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>> usersrepository.xml
>>>> <domainlist
>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>> <autodetect>true</autodetect>
>>>> <autodetectIP>true</autodetectIP>
>>>> </domainlist>
>>>>
>>>> - Edit the database.properties and change the values according to
>>>> your database.
>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>> folder.
>>>>
>>>> Step 4: Start
>>>> #############
>>>>
>>>> $ cd bin
>>>> $ ./james start (!! you need libc6 installed on Linux - sudo
>>>> apt-get install libc6-i386 libc6-dev-i386 on ubuntu)
>>>> You can see log result in the log/james-server.log file.
>>>>
>>>> Step 5: Create Domains and Users
>>>> ################################
>>>>
>>>> $ telnet localhost 4555
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> JAMES Remote Administration Tool
>>>> Please enter your login and password
>>>> Login id:
>>>> root
>>>> Password:
>>>> root
>>>> Welcome root. HELP for a list of commands
>>>> adddomain YOUR_DOMAIN
>>>> Adding domain YOUR_DOMAIN successful
>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>> quit
>>>> Bye
>>>> Connection closed by foreign host.
>>>>
>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>> have a test@localhost.net user.
>>>> The username to use in you mail client will be test@localhost.net.
>>>>
>>>> Step 6: Test
>>>> ############
>>>>
>>>> $ telnet 127.0.0.1 25
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat,
>>>> 6 Nov 2010 17:31:33 +0100 (CET)
>>>> ehlo test
>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>> 250-PIPELINING
>>>> 250-ENHANCEDSTATUSCODES
>>>> 250 8BITMIME
>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>> data
>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>> subject: test
>>>>
>>>> this is a test
>>>> .
>>>> 250 2.6.0 Message received
>>>> quit
>>>> Connection closed by foreign host.
>>>>
>>>> Step 7: Manage
>>>> ##############
>>>>
>>>> 7.1. Manage via telnet
>>>> $ telnet localhost 4555
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> JAMES Remote Administration Tool
>>>> Please enter your login and password
>>>> Login id:
>>>> root
>>>> Password:
>>>> root
>>>> Welcome root. HELP for a list of commands
>>>> help
>>>> adddomain [domainname] add domain to local domains
>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>> given emailaddress
>>>> adduser [username] [password] add a new user
>>>> countusers display the number of existing accounts
>>>> deluser [username] delete existing user
>>>> help displays this help
>>>> listallmappings list all mappings
>>>> listdomains list local domains
>>>> listmapping [user@domain] list all mappings for the given
>>>> emailaddress
>>>> listusers display existing accounts
>>>> memstat ([-gc]) shows memory usage. When called with -gc the
>>>> garbage collector get called
>>>> quit close connection
>>>> removedomain [domainname] remove domain from local domains
>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>> the given emailaddress
>>>> setpassword [username] [password] sets a user's password
>>>> showalias [username] shows a user's current email alias
>>>> showforwarding [username] shows a user's current email
>>>> forwarding
>>>> shutdown kills the current JVM (convenient when James is run
>>>> as a daemon)
>>>> unsetalias [user] unsets an alias for 'user'
>>>> unsetforwarding [username] removes a forward
>>>> user [repositoryname] change to another user repository
>>>> verify [username] verify if specified user exist
>>>>
>>>> 7.2. Manage via JMX
>>>> Launch jconsole (or any other JMX client) and connect on
>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>
>>>> Step 8: Monitor
>>>> ##############
>>>>
>>>> Monitor the ./log/james-server.log log file.
>>>> Monitor via JMX (launch any JMX client and connect to
>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>
>>>>
>>>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric MacAdie <er...@MacAdie.net>.
I am running James on Linux.
Regards,
Eric MacAdie
President, Chicago Java Users Group
http://blog.cjug.org
On 11/10/2010 10:36 PM, Gerry Matte wrote:
> Hi Eric.
> I don't know the answer but I suspect that you need to specify whether
> you are running on Unix or Windows .......
> Just a suggestion to save time.
>
> It would be a good idea if Eric added a longer or more explicit
> description of the memory requirements on each platform to his
> quickstart document.
> Gerry
>
> --------------------------------------------------
> From: "Eric MacAdie" <er...@MacAdie.net>
> Sent: Wednesday, November 10, 2010 8:29 PM
> To: "James Users List" <se...@james.apache.org>
> Subject: Re: Quick Start for 3.0-M2
>
>> I have a couple of questions:
>>
>> 1. One of the requirements is 512 MB of RAM. I am running my site
>> (and a James server) on a VPS account that has 512 MB RAM total. Is
>> James 3 not an option for me?
>>
>> 2. Are there plans on documenting how to add users to the database?
>> If I can run James 3 on my VPS, I may be able to help with this.
>> Telnetting into the remote manager is not something I have any
>> interest in at all.
>>
>> Regards,
>> Eric MacAdie
>> President, Chicago Java Users Group
>> http://blog.cjug.org
>>
>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>> Hi Everyone,
>>>
>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>> The goal of the doc is to allow anyone to start with James binary
>>> distribution as an operational mail server.
>>>
>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>> your feedback so we can have the best possible doc for upcoming
>>> 3.0-M2 release.
>>> Tks,
>>>
>>> Eric
>>>
>>> Step 0: Requirements
>>> ####################
>>>
>>> JRE 1.5+
>>> root (linux/unix) or Administrator (Windows)
>>> libc6 (linux)
>>> 512MB RAM
>>>
>>> Step 1: Download
>>> #################
>>>
>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>
>>> Step 2: Deploy
>>> ##############
>>>
>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>> and four text files.
>>>
>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>> $ cd james-server-container-spring-3.0-M2
>>> $ ls -l
>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>
>>>
>>> Step 3: Configure
>>> #################
>>>
>>> All configuration files reside in the conf folder.
>>>
>>> $ cd conf
>>> $ ls -l
>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>
>>>
>>> James is packaged with virtual hosting disabled, XML domain list,
>>> JPA (Derby database) storage for the mails and remote delivery from
>>> locahost only.
>>> You can edit the following files to change the behaviour:
>>>
>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>
>>> - Replace the XMLDomainList with the JPADomainList: vi
>>> usersrepository.xml
>>> <domainlist
>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>> <autodetect>true</autodetect>
>>> <autodetectIP>true</autodetectIP>
>>> </domainlist>
>>>
>>> - Edit the database.properties and change the values according to
>>> your database.
>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>> folder.
>>>
>>> Step 4: Start
>>> #############
>>>
>>> $ cd bin
>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>> You can see log result in the log/james-server.log file.
>>>
>>> Step 5: Create Domains and Users
>>> ################################
>>>
>>> $ telnet localhost 4555
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> JAMES Remote Administration Tool
>>> Please enter your login and password
>>> Login id:
>>> root
>>> Password:
>>> root
>>> Welcome root. HELP for a list of commands
>>> adddomain YOUR_DOMAIN
>>> Adding domain YOUR_DOMAIN successful
>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>> User YOUR_NAME@YOUR_DOMAIN added
>>> quit
>>> Bye
>>> Connection closed by foreign host.
>>>
>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>> have a test@localhost.net user.
>>> The username to use in you mail client will be test@localhost.net.
>>>
>>> Step 6: Test
>>> ############
>>>
>>> $ telnet 127.0.0.1 25
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>> Nov 2010 17:31:33 +0100 (CET)
>>> ehlo test
>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>> 250-PIPELINING
>>> 250-ENHANCEDSTATUSCODES
>>> 250 8BITMIME
>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>> data
>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>> subject: test
>>>
>>> this is a test
>>> .
>>> 250 2.6.0 Message received
>>> quit
>>> Connection closed by foreign host.
>>>
>>> Step 7: Manage
>>> ##############
>>>
>>> 7.1. Manage via telnet
>>> $ telnet localhost 4555
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> JAMES Remote Administration Tool
>>> Please enter your login and password
>>> Login id:
>>> root
>>> Password:
>>> root
>>> Welcome root. HELP for a list of commands
>>> help
>>> adddomain [domainname] add domain to local domains
>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>> given emailaddress
>>> adduser [username] [password] add a new user
>>> countusers display the number of existing accounts
>>> deluser [username] delete existing user
>>> help displays this help
>>> listallmappings list all mappings
>>> listdomains list local domains
>>> listmapping [user@domain] list all mappings for the given
>>> emailaddress
>>> listusers display existing accounts
>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>> collector get called
>>> quit close connection
>>> removedomain [domainname] remove domain from local domains
>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>> the given emailaddress
>>> setpassword [username] [password] sets a user's password
>>> showalias [username] shows a user's current email alias
>>> showforwarding [username] shows a user's current email forwarding
>>> shutdown kills the current JVM (convenient when James is run
>>> as a daemon)
>>> unsetalias [user] unsets an alias for 'user'
>>> unsetforwarding [username] removes a forward
>>> user [repositoryname] change to another user repository
>>> verify [username] verify if specified user exist
>>>
>>> 7.2. Manage via JMX
>>> Launch jconsole (or any other JMX client) and connect on
>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>
>>> Step 8: Monitor
>>> ##############
>>>
>>> Monitor the ./log/james-server.log log file.
>>> Monitor via JMX (launch any JMX client and connect to
>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>
>>>
>>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Gerry Matte <Ge...@shaw.ca>.
Hi Eric.
I don't know the answer but I suspect that you need to specify whether you
are running on Unix or Windows .......
Just a suggestion to save time.
It would be a good idea if Eric added a longer or more explicit description
of the memory requirements on each platform to his quickstart document.
Gerry
--------------------------------------------------
From: "Eric MacAdie" <er...@MacAdie.net>
Sent: Wednesday, November 10, 2010 8:29 PM
To: "James Users List" <se...@james.apache.org>
Subject: Re: Quick Start for 3.0-M2
> I have a couple of questions:
>
> 1. One of the requirements is 512 MB of RAM. I am running my site (and a
> James server) on a VPS account that has 512 MB RAM total. Is James 3 not
> an option for me?
>
> 2. Are there plans on documenting how to add users to the database? If I
> can run James 3 on my VPS, I may be able to help with this. Telnetting
> into the remote manager is not something I have any interest in at all.
>
> Regards,
> Eric MacAdie
> President, Chicago Java Users Group
> http://blog.cjug.org
>
> On 11/8/2010 4:21 AM, Eric Charles wrote:
>> Hi Everyone,
>>
>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>> The goal of the doc is to allow anyone to start with James binary
>> distribution as an operational mail server.
>>
>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>> feedback so we can have the best possible doc for upcoming 3.0-M2
>> release.
>> Tks,
>>
>> Eric
>>
>> Step 0: Requirements
>> ####################
>>
>> JRE 1.5+
>> root (linux/unix) or Administrator (Windows)
>> libc6 (linux)
>> 512MB RAM
>>
>> Step 1: Download
>> #################
>>
>> Download james-server-container-spring-3.0-M2-bin.zip from
>> http://james.apache.org/download.cgi#Apache_James_Server
>>
>> Step 2: Deploy
>> ##############
>>
>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>> You should have a folder with sub-folders bin, conf, lib, log, var and
>> four text files.
>>
>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>> $ cd james-server-container-spring-3.0-M2
>> $ ls -l
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>
>>
>> Step 3: Configure
>> #################
>>
>> All configuration files reside in the conf folder.
>>
>> $ cd conf
>> $ ls -l
>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>
>>
>> James is packaged with virtual hosting disabled, XML domain list, JPA
>> (Derby database) storage for the mails and remote delivery from locahost
>> only.
>> You can edit the following files to change the behaviour:
>>
>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>> <enableVirtualHosting> true </enableVirtualHosting>
>>
>> - Replace the XMLDomainList with the JPADomainList: vi
>> usersrepository.xml
>> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
>> <autodetect>true</autodetect>
>> <autodetectIP>true</autodetectIP>
>> </domainlist>
>>
>> - Edit the database.properties and change the values according to your
>> database.
>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>> folder.
>>
>> Step 4: Start
>> #############
>>
>> $ cd bin
>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>> install libc6-i386 libc6-dev-i386 on ubuntu)
>> You can see log result in the log/james-server.log file.
>>
>> Step 5: Create Domains and Users
>> ################################
>>
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> adddomain YOUR_DOMAIN
>> Adding domain YOUR_DOMAIN successful
>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>> User YOUR_NAME@YOUR_DOMAIN added
>> quit
>> Bye
>> Connection closed by foreign host.
>>
>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will have
>> a test@localhost.net user.
>> The username to use in you mail client will be test@localhost.net.
>>
>> Step 6: Test
>> ############
>>
>> $ telnet 127.0.0.1 25
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
>> 2010 17:31:33 +0100 (CET)
>> ehlo test
>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>> 250-PIPELINING
>> 250-ENHANCEDSTATUSCODES
>> 250 8BITMIME
>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>> data
>> 354 Ok Send data ending with <CRLF>.<CRLF>
>> subject: test
>>
>> this is a test
>> .
>> 250 2.6.0 Message received
>> quit
>> Connection closed by foreign host.
>>
>> Step 7: Manage
>> ##############
>>
>> 7.1. Manage via telnet
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> help
>> adddomain [domainname] add domain to local domains
>> addmapping [toUser@toDomain] [fromMapping] add mapping for the given
>> emailaddress
>> adduser [username] [password] add a new user
>> countusers display the number of existing accounts
>> deluser [username] delete existing user
>> help displays this help
>> listallmappings list all mappings
>> listdomains list local domains
>> listmapping [user@domain] list all mappings for the given
>> emailaddress
>> listusers display existing accounts
>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>> collector get called
>> quit close connection
>> removedomain [domainname] remove domain from local domains
>> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
>> given emailaddress
>> setpassword [username] [password] sets a user's password
>> showalias [username] shows a user's current email alias
>> showforwarding [username] shows a user's current email forwarding
>> shutdown kills the current JVM (convenient when James is run as a
>> daemon)
>> unsetalias [user] unsets an alias for 'user'
>> unsetforwarding [username] removes a forward
>> user [repositoryname] change to another user repository
>> verify [username] verify if specified user exist
>>
>> 7.2. Manage via JMX
>> Launch jconsole (or any other JMX client) and connect on
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>
>> Step 8: Monitor
>> ##############
>>
>> Monitor the ./log/james-server.log log file.
>> Monitor via JMX (launch any JMX client and connect to
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi,
James 3 db schema is not compatible with 2.3 (I was just talking about
2.3 because of the deadletter table, but if you've changed
mailetcontainer it may be normal to have that table).
If you start a new project, that's the simple thing, you don't have to
worry about backwards,... (configure as you like).
Tks,
Eric
On 12/11/2010 13:13, Mohammad Naghavi wrote:
> Hi
> yeah I changed the configuration in mailcontainer myself.
> is james 3 's db schema compatible with james 2.3.2?
> I am starting a new project and there is no need to adhere to old or
> backward if it is not needed or makes any difference.
>
> Thanks
> MN
> ________________________________________
> PHP& ASP .Net 3.5 web developer
> Java& C# desktop developer
> www.mohamnag.com
>
>
>
> On Fri, Nov 12, 2010 at 9:05 AM, Eric Charles<er...@apache.org> wrote:
>
>> Hi,
>>
>> Yes, that's it. The default mailboxmanager is implemented with JPA
>> framework.
>>
>> Did you create a domain or a user? James is configured so OpenJPA
>> automatically creates the tables when needed, so go via remotemanager
>> (telnet localhost 4555) to create user,....
>>
>> The strange thing is that the presence of deadletter table. It may be there
>> is you changed the mailetcontainer to use db:... patterns for deadletter
>> processor. An other option would be that you use an exisiting db schema
>> (already used for james 2.3.2) ?
>>
>> Tks,
>>
>> Eric
>>
>>
>>
>> On 12/11/2010 08:58, Mohammad Naghavi wrote:
>>
>>> Hi again
>>> and tanks for infos, it was really good. but it is really confusing so let
>>> me ask if by jpa=database you mean this tag:
>>>
>>> <constructor-arg index="2" value="${openjpa.streaming}"/>
>>>
>>> in this part of spring-beans.xml:
>>>
>>> <bean id="mailboxmanager"
>>> class="org.apache.james.mailbox.jpa.openjpa.OpenJPAMailboxManager">
>>> <constructor-arg index="0" ref="sessionMapperFactory"/>
>>> <constructor-arg index="1" ref="authenticator"/>
>>> <constructor-arg index="2" value="${openjpa.streaming}"/>
>>> </bean>
>>>
>>>
>>> I did find no where else in spring-beans.xml to be related to mailbox.
>>> and another question that if it is by default configured to use DB why it
>>> is
>>> not building the tables in database? I have now just one table in my DB
>>> named as deadletter and as you said before it is not related to mailboxs.
>>>
>>> Thanks again
>>> MN
>>> ________________________________________
>>> PHP& ASP .Net 3.5 web developer
>>> Java& C# desktop developer
>>> www.mohamnag.com
>>>
>>>
>>>
>>> On Fri, Nov 12, 2010 at 8:42 AM, Eric Charles<er...@apache.org> wrote:
>>>
>>> Hi Mohammad,
>>>> Yes,
>>>> - maibox is for users' inbox, sent items, trash... folders.
>>>> - mailstore is for spam, error,... mails, so nothing to do with users
>>>> visible mails.
>>>>
>>>> Both are configurable.
>>>>
>>>> - Mailbox persistence is configured in spring-beans.xml (by default
>>>> jpa=database, you set the database connection properties in
>>>> database.properties - can also be maildir=file, jcr). We think to move
>>>> this
>>>> config out-of spring-beans.xml.
>>>> - Available mailstore persistence are defined in mailstore.xml. Each has
>>>> an
>>>> URL prefix (file, db, dbfile,...) that can be used in mailetcontainer.xml
>>>> to
>>>> define where to store spam,... mails (exemple: file://var/mail/error/).
>>>>
>>>> Both mailbox and mailstore use database connection defined via
>>>> database.properties in case of database access.
>>>>
>>>> http://james.apache.org/server/3/feature_stores.html will be updated
>>>> with
>>>> this for 3.0-M2 release.
>>>> I will try to also inject it in the quick start, but it must remain quick
>>>> :)
>>>>
>>>> Tks,
>>>>
>>>> Eric
>>>>
>>>>
>>>>
>>>> On 12/11/2010 08:23, Mohammad Naghavi wrote:
>>>>
>>>> Hi Eric
>>>>> I didn't get it! maybe cause I'm totally new to James. what do you mean
>>>>> by
>>>>> mailbox in contrast to mailstore? does mailbox means inbox? and
>>>>> mailstore
>>>>> as
>>>>> I understood means spams and deadletters.
>>>>> also the non-mailbox ones are using database.properties or not? (sure
>>>>> when
>>>>> it is configured to use DB for storage)
>>>>>
>>>>> Tanks
>>>>> MN
>>>>> ________________________________________
>>>>> PHP& ASP .Net 3.5 web developer
>>>>> Java& C# desktop developer
>>>>> www.mohamnag.com
>>>>>
>>>>>
>>>>>
>>>>> On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles<er...@apache.org> wrote:
>>>>>
>>>>> Hi,
>>>>>
>>>>>> To be complete, there are two types of "mail store".
>>>>>>
>>>>>> 1.- The mailbox store which is configured in spring-beans.xml (if
>>>>>> default
>>>>>> jpa is used, you have database.properties to define which database to
>>>>>> use).
>>>>>> 2.- The other mails (non-mailbox) that use definitions from
>>>>>> mailstore.xml
>>>>>> and that can be used in by mailetcontainer.xml to persist mails that
>>>>>> are
>>>>>> spam, error,...
>>>>>>
>>>>>> This is really confusing and I'm sure we can do better on conf/doc
>>>>>> level.
>>>>>> For example, having an additional mailbox.xml file that contains
>>>>>> definitions for the mailbox. At least, user will see there is two types
>>>>>> of
>>>>>> mail : the mailbox and the mailstore.
>>>>>>
>>>>>> Tks,
>>>>>>
>>>>>> Eric
>>>>>>
>>>>>>
>>>>>> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>>>>>>
>>>>>> Thanks now it is functioning!
>>>>>>
>>>>>>> ________________________________________
>>>>>>> PHP& ASP .Net 3.5 web developer
>>>>>>> Java& C# desktop developer
>>>>>>> www.mohamnag.com
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>>>>>>> wrote:
>>>>>>>
>>>>>>> ee repositories - any are available to use.
>>>>>>>
>>>>>>> The mailetcontainer lines se
>>>>>>>>
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>>>
>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>
>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Hi
yeah I changed the configuration in mailcontainer myself.
is james 3 's db schema compatible with james 2.3.2?
I am starting a new project and there is no need to adhere to old or
backward if it is not needed or makes any difference.
Thanks
MN
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Fri, Nov 12, 2010 at 9:05 AM, Eric Charles <er...@apache.org> wrote:
> Hi,
>
> Yes, that's it. The default mailboxmanager is implemented with JPA
> framework.
>
> Did you create a domain or a user? James is configured so OpenJPA
> automatically creates the tables when needed, so go via remotemanager
> (telnet localhost 4555) to create user,....
>
> The strange thing is that the presence of deadletter table. It may be there
> is you changed the mailetcontainer to use db:... patterns for deadletter
> processor. An other option would be that you use an exisiting db schema
> (already used for james 2.3.2) ?
>
> Tks,
>
> Eric
>
>
>
> On 12/11/2010 08:58, Mohammad Naghavi wrote:
>
>> Hi again
>> and tanks for infos, it was really good. but it is really confusing so let
>> me ask if by jpa=database you mean this tag:
>>
>> <constructor-arg index="2" value="${openjpa.streaming}"/>
>>
>> in this part of spring-beans.xml:
>>
>> <bean id="mailboxmanager"
>> class="org.apache.james.mailbox.jpa.openjpa.OpenJPAMailboxManager">
>> <constructor-arg index="0" ref="sessionMapperFactory"/>
>> <constructor-arg index="1" ref="authenticator"/>
>> <constructor-arg index="2" value="${openjpa.streaming}"/>
>> </bean>
>>
>>
>> I did find no where else in spring-beans.xml to be related to mailbox.
>> and another question that if it is by default configured to use DB why it
>> is
>> not building the tables in database? I have now just one table in my DB
>> named as deadletter and as you said before it is not related to mailboxs.
>>
>> Thanks again
>> MN
>> ________________________________________
>> PHP& ASP .Net 3.5 web developer
>> Java& C# desktop developer
>> www.mohamnag.com
>>
>>
>>
>> On Fri, Nov 12, 2010 at 8:42 AM, Eric Charles<er...@apache.org> wrote:
>>
>> Hi Mohammad,
>>>
>>> Yes,
>>> - maibox is for users' inbox, sent items, trash... folders.
>>> - mailstore is for spam, error,... mails, so nothing to do with users
>>> visible mails.
>>>
>>> Both are configurable.
>>>
>>> - Mailbox persistence is configured in spring-beans.xml (by default
>>> jpa=database, you set the database connection properties in
>>> database.properties - can also be maildir=file, jcr). We think to move
>>> this
>>> config out-of spring-beans.xml.
>>> - Available mailstore persistence are defined in mailstore.xml. Each has
>>> an
>>> URL prefix (file, db, dbfile,...) that can be used in mailetcontainer.xml
>>> to
>>> define where to store spam,... mails (exemple: file://var/mail/error/).
>>>
>>> Both mailbox and mailstore use database connection defined via
>>> database.properties in case of database access.
>>>
>>> http://james.apache.org/server/3/feature_stores.html will be updated
>>> with
>>> this for 3.0-M2 release.
>>> I will try to also inject it in the quick start, but it must remain quick
>>> :)
>>>
>>> Tks,
>>>
>>> Eric
>>>
>>>
>>>
>>> On 12/11/2010 08:23, Mohammad Naghavi wrote:
>>>
>>> Hi Eric
>>>> I didn't get it! maybe cause I'm totally new to James. what do you mean
>>>> by
>>>> mailbox in contrast to mailstore? does mailbox means inbox? and
>>>> mailstore
>>>> as
>>>> I understood means spams and deadletters.
>>>> also the non-mailbox ones are using database.properties or not? (sure
>>>> when
>>>> it is configured to use DB for storage)
>>>>
>>>> Tanks
>>>> MN
>>>> ________________________________________
>>>> PHP& ASP .Net 3.5 web developer
>>>> Java& C# desktop developer
>>>> www.mohamnag.com
>>>>
>>>>
>>>>
>>>> On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles<er...@apache.org> wrote:
>>>>
>>>> Hi,
>>>>
>>>>> To be complete, there are two types of "mail store".
>>>>>
>>>>> 1.- The mailbox store which is configured in spring-beans.xml (if
>>>>> default
>>>>> jpa is used, you have database.properties to define which database to
>>>>> use).
>>>>> 2.- The other mails (non-mailbox) that use definitions from
>>>>> mailstore.xml
>>>>> and that can be used in by mailetcontainer.xml to persist mails that
>>>>> are
>>>>> spam, error,...
>>>>>
>>>>> This is really confusing and I'm sure we can do better on conf/doc
>>>>> level.
>>>>> For example, having an additional mailbox.xml file that contains
>>>>> definitions for the mailbox. At least, user will see there is two types
>>>>> of
>>>>> mail : the mailbox and the mailstore.
>>>>>
>>>>> Tks,
>>>>>
>>>>> Eric
>>>>>
>>>>>
>>>>> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>>>>>
>>>>> Thanks now it is functioning!
>>>>>
>>>>>> ________________________________________
>>>>>> PHP& ASP .Net 3.5 web developer
>>>>>> Java& C# desktop developer
>>>>>> www.mohamnag.com
>>>>>>
>>>>>>
>>>>>>
>>>>>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>>>>>> wrote:
>>>>>>
>>>>>> ee repositories - any are available to use.
>>>>>>
>>>>>> The mailetcontainer lines se
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>>
>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>
>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi,
Yes, that's it. The default mailboxmanager is implemented with JPA
framework.
Did you create a domain or a user? James is configured so OpenJPA
automatically creates the tables when needed, so go via remotemanager
(telnet localhost 4555) to create user,....
The strange thing is that the presence of deadletter table. It may be
there is you changed the mailetcontainer to use db:... patterns for
deadletter processor. An other option would be that you use an exisiting
db schema (already used for james 2.3.2) ?
Tks,
Eric
On 12/11/2010 08:58, Mohammad Naghavi wrote:
> Hi again
> and tanks for infos, it was really good. but it is really confusing so let
> me ask if by jpa=database you mean this tag:
>
> <constructor-arg index="2" value="${openjpa.streaming}"/>
>
> in this part of spring-beans.xml:
>
> <bean id="mailboxmanager"
> class="org.apache.james.mailbox.jpa.openjpa.OpenJPAMailboxManager">
> <constructor-arg index="0" ref="sessionMapperFactory"/>
> <constructor-arg index="1" ref="authenticator"/>
> <constructor-arg index="2" value="${openjpa.streaming}"/>
> </bean>
>
>
> I did find no where else in spring-beans.xml to be related to mailbox.
> and another question that if it is by default configured to use DB why it is
> not building the tables in database? I have now just one table in my DB
> named as deadletter and as you said before it is not related to mailboxs.
>
> Thanks again
> MN
> ________________________________________
> PHP& ASP .Net 3.5 web developer
> Java& C# desktop developer
> www.mohamnag.com
>
>
>
> On Fri, Nov 12, 2010 at 8:42 AM, Eric Charles<er...@apache.org> wrote:
>
>> Hi Mohammad,
>>
>> Yes,
>> - maibox is for users' inbox, sent items, trash... folders.
>> - mailstore is for spam, error,... mails, so nothing to do with users
>> visible mails.
>>
>> Both are configurable.
>>
>> - Mailbox persistence is configured in spring-beans.xml (by default
>> jpa=database, you set the database connection properties in
>> database.properties - can also be maildir=file, jcr). We think to move this
>> config out-of spring-beans.xml.
>> - Available mailstore persistence are defined in mailstore.xml. Each has an
>> URL prefix (file, db, dbfile,...) that can be used in mailetcontainer.xml to
>> define where to store spam,... mails (exemple: file://var/mail/error/).
>>
>> Both mailbox and mailstore use database connection defined via
>> database.properties in case of database access.
>>
>> http://james.apache.org/server/3/feature_stores.html will be updated with
>> this for 3.0-M2 release.
>> I will try to also inject it in the quick start, but it must remain quick
>> :)
>>
>> Tks,
>>
>> Eric
>>
>>
>>
>> On 12/11/2010 08:23, Mohammad Naghavi wrote:
>>
>>> Hi Eric
>>> I didn't get it! maybe cause I'm totally new to James. what do you mean by
>>> mailbox in contrast to mailstore? does mailbox means inbox? and mailstore
>>> as
>>> I understood means spams and deadletters.
>>> also the non-mailbox ones are using database.properties or not? (sure when
>>> it is configured to use DB for storage)
>>>
>>> Tanks
>>> MN
>>> ________________________________________
>>> PHP& ASP .Net 3.5 web developer
>>> Java& C# desktop developer
>>> www.mohamnag.com
>>>
>>>
>>>
>>> On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles<er...@apache.org> wrote:
>>>
>>> Hi,
>>>> To be complete, there are two types of "mail store".
>>>>
>>>> 1.- The mailbox store which is configured in spring-beans.xml (if default
>>>> jpa is used, you have database.properties to define which database to
>>>> use).
>>>> 2.- The other mails (non-mailbox) that use definitions from mailstore.xml
>>>> and that can be used in by mailetcontainer.xml to persist mails that are
>>>> spam, error,...
>>>>
>>>> This is really confusing and I'm sure we can do better on conf/doc level.
>>>> For example, having an additional mailbox.xml file that contains
>>>> definitions for the mailbox. At least, user will see there is two types
>>>> of
>>>> mail : the mailbox and the mailstore.
>>>>
>>>> Tks,
>>>>
>>>> Eric
>>>>
>>>>
>>>> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>>>>
>>>> Thanks now it is functioning!
>>>>> ________________________________________
>>>>> PHP& ASP .Net 3.5 web developer
>>>>> Java& C# desktop developer
>>>>> www.mohamnag.com
>>>>>
>>>>>
>>>>>
>>>>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>>>>> wrote:
>>>>>
>>>>> ee repositories - any are available to use.
>>>>>
>>>>>> The mailetcontainer lines se
>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Hi again
and tanks for infos, it was really good. but it is really confusing so let
me ask if by jpa=database you mean this tag:
<constructor-arg index="2" value="${openjpa.streaming}"/>
in this part of spring-beans.xml:
<bean id="mailboxmanager"
class="org.apache.james.mailbox.jpa.openjpa.OpenJPAMailboxManager">
<constructor-arg index="0" ref="sessionMapperFactory"/>
<constructor-arg index="1" ref="authenticator"/>
<constructor-arg index="2" value="${openjpa.streaming}"/>
</bean>
I did find no where else in spring-beans.xml to be related to mailbox.
and another question that if it is by default configured to use DB why it is
not building the tables in database? I have now just one table in my DB
named as deadletter and as you said before it is not related to mailboxs.
Thanks again
MN
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Fri, Nov 12, 2010 at 8:42 AM, Eric Charles <er...@apache.org> wrote:
> Hi Mohammad,
>
> Yes,
> - maibox is for users' inbox, sent items, trash... folders.
> - mailstore is for spam, error,... mails, so nothing to do with users
> visible mails.
>
> Both are configurable.
>
> - Mailbox persistence is configured in spring-beans.xml (by default
> jpa=database, you set the database connection properties in
> database.properties - can also be maildir=file, jcr). We think to move this
> config out-of spring-beans.xml.
> - Available mailstore persistence are defined in mailstore.xml. Each has an
> URL prefix (file, db, dbfile,...) that can be used in mailetcontainer.xml to
> define where to store spam,... mails (exemple: file://var/mail/error/).
>
> Both mailbox and mailstore use database connection defined via
> database.properties in case of database access.
>
> http://james.apache.org/server/3/feature_stores.html will be updated with
> this for 3.0-M2 release.
> I will try to also inject it in the quick start, but it must remain quick
> :)
>
> Tks,
>
> Eric
>
>
>
> On 12/11/2010 08:23, Mohammad Naghavi wrote:
>
>> Hi Eric
>> I didn't get it! maybe cause I'm totally new to James. what do you mean by
>> mailbox in contrast to mailstore? does mailbox means inbox? and mailstore
>> as
>> I understood means spams and deadletters.
>> also the non-mailbox ones are using database.properties or not? (sure when
>> it is configured to use DB for storage)
>>
>> Tanks
>> MN
>> ________________________________________
>> PHP& ASP .Net 3.5 web developer
>> Java& C# desktop developer
>> www.mohamnag.com
>>
>>
>>
>> On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles<er...@apache.org> wrote:
>>
>> Hi,
>>> To be complete, there are two types of "mail store".
>>>
>>> 1.- The mailbox store which is configured in spring-beans.xml (if default
>>> jpa is used, you have database.properties to define which database to
>>> use).
>>> 2.- The other mails (non-mailbox) that use definitions from mailstore.xml
>>> and that can be used in by mailetcontainer.xml to persist mails that are
>>> spam, error,...
>>>
>>> This is really confusing and I'm sure we can do better on conf/doc level.
>>> For example, having an additional mailbox.xml file that contains
>>> definitions for the mailbox. At least, user will see there is two types
>>> of
>>> mail : the mailbox and the mailstore.
>>>
>>> Tks,
>>>
>>> Eric
>>>
>>>
>>> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>>>
>>> Thanks now it is functioning!
>>>> ________________________________________
>>>> PHP& ASP .Net 3.5 web developer
>>>> Java& C# desktop developer
>>>> www.mohamnag.com
>>>>
>>>>
>>>>
>>>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>>>> wrote:
>>>>
>>>> ee repositories - any are available to use.
>>>>
>>>>> The mailetcontainer lines se
>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi Mohammad,
Yes,
- maibox is for users' inbox, sent items, trash... folders.
- mailstore is for spam, error,... mails, so nothing to do with users
visible mails.
Both are configurable.
- Mailbox persistence is configured in spring-beans.xml (by default
jpa=database, you set the database connection properties in
database.properties - can also be maildir=file, jcr). We think to move
this config out-of spring-beans.xml.
- Available mailstore persistence are defined in mailstore.xml. Each has
an URL prefix (file, db, dbfile,...) that can be used in
mailetcontainer.xml to define where to store spam,... mails (exemple:
file://var/mail/error/).
Both mailbox and mailstore use database connection defined via
database.properties in case of database access.
http://james.apache.org/server/3/feature_stores.html will be updated
with this for 3.0-M2 release.
I will try to also inject it in the quick start, but it must remain quick :)
Tks,
Eric
On 12/11/2010 08:23, Mohammad Naghavi wrote:
> Hi Eric
> I didn't get it! maybe cause I'm totally new to James. what do you mean by
> mailbox in contrast to mailstore? does mailbox means inbox? and mailstore as
> I understood means spams and deadletters.
> also the non-mailbox ones are using database.properties or not? (sure when
> it is configured to use DB for storage)
>
> Tanks
> MN
> ________________________________________
> PHP& ASP .Net 3.5 web developer
> Java& C# desktop developer
> www.mohamnag.com
>
>
>
> On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles<er...@apache.org> wrote:
>
>> Hi,
>> To be complete, there are two types of "mail store".
>>
>> 1.- The mailbox store which is configured in spring-beans.xml (if default
>> jpa is used, you have database.properties to define which database to use).
>> 2.- The other mails (non-mailbox) that use definitions from mailstore.xml
>> and that can be used in by mailetcontainer.xml to persist mails that are
>> spam, error,...
>>
>> This is really confusing and I'm sure we can do better on conf/doc level.
>> For example, having an additional mailbox.xml file that contains
>> definitions for the mailbox. At least, user will see there is two types of
>> mail : the mailbox and the mailstore.
>>
>> Tks,
>>
>> Eric
>>
>>
>> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>>
>>> Thanks now it is functioning!
>>> ________________________________________
>>> PHP& ASP .Net 3.5 web developer
>>> Java& C# desktop developer
>>> www.mohamnag.com
>>>
>>>
>>>
>>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>>> wrote:
>>>
>>> ee repositories - any are available to use.
>>>> The mailetcontainer lines se
>>>>
>>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Hi Eric
I didn't get it! maybe cause I'm totally new to James. what do you mean by
mailbox in contrast to mailstore? does mailbox means inbox? and mailstore as
I understood means spams and deadletters.
also the non-mailbox ones are using database.properties or not? (sure when
it is configured to use DB for storage)
Tanks
MN
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Fri, Nov 12, 2010 at 6:25 AM, Eric Charles <er...@apache.org> wrote:
> Hi,
> To be complete, there are two types of "mail store".
>
> 1.- The mailbox store which is configured in spring-beans.xml (if default
> jpa is used, you have database.properties to define which database to use).
> 2.- The other mails (non-mailbox) that use definitions from mailstore.xml
> and that can be used in by mailetcontainer.xml to persist mails that are
> spam, error,...
>
> This is really confusing and I'm sure we can do better on conf/doc level.
> For example, having an additional mailbox.xml file that contains
> definitions for the mailbox. At least, user will see there is two types of
> mail : the mailbox and the mailstore.
>
> Tks,
>
> Eric
>
>
> On 11/11/2010 22:34, Mohammad Naghavi wrote:
>
>> Thanks now it is functioning!
>> ________________________________________
>> PHP& ASP .Net 3.5 web developer
>> Java& C# desktop developer
>> www.mohamnag.com
>>
>>
>>
>> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca>
>> wrote:
>>
>> ee repositories - any are available to use.
>>> The mailetcontainer lines se
>>>
>>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi,
To be complete, there are two types of "mail store".
1.- The mailbox store which is configured in spring-beans.xml (if
default jpa is used, you have database.properties to define which
database to use).
2.- The other mails (non-mailbox) that use definitions from
mailstore.xml and that can be used in by mailetcontainer.xml to persist
mails that are spam, error,...
This is really confusing and I'm sure we can do better on conf/doc level.
For example, having an additional mailbox.xml file that contains
definitions for the mailbox. At least, user will see there is two types
of mail : the mailbox and the mailstore.
Tks,
Eric
On 11/11/2010 22:34, Mohammad Naghavi wrote:
> Thanks now it is functioning!
> ________________________________________
> PHP& ASP .Net 3.5 web developer
> Java& C# desktop developer
> www.mohamnag.com
>
>
>
> On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte<Ge...@shaw.ca> wrote:
>
>> ee repositories - any are available to use.
>> The mailetcontainer lines se
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Thanks now it is functioning!
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Thu, Nov 11, 2010 at 10:27 PM, Gerry Matte <Ge...@shaw.ca> wrote:
> ee repositories - any are available to use.
> The mailetcontainer lines se
>
Re: Quick Start for 3.0-M2
Posted by Gerry Matte <Ge...@shaw.ca>.
I was too quick responding.
The file to change is mailetcontainer.xml - see lines 348-355
mailstore.xml creates all three repositories - any are available to use.
The mailetcontainer lines select which of those repositories to use.
Gerry
--------------------------------------------------
From: "Mohammad Naghavi" <mo...@gmail.com>
Sent: Thursday, November 11, 2010 1:22 PM
To: "James Users List" <se...@james.apache.org>; "Gerry Matte"
<Ge...@shaw.ca>
Subject: Re: Quick Start for 3.0-M2
> I would try it :) thanks and have a good trip :)
>
> Mohammad
> ________________________________________
> PHP & ASP .Net 3.5 web developer
> Java & C# desktop developer
> www.mohamnag.com
>
>
>
> On Thu, Nov 11, 2010 at 10:19 PM, Gerry Matte <Ge...@shaw.ca> wrote:
>
>> Hi Mohammed.
>> Sorry for the delay - I'm packing for a trip.
>> I never bothered to save messages in the database because my email
>> clients
>> download them rather than leaving them on the server.
>> I believe from the mailstore comments that you can change this behavior
>> by
>> commenting the first repository and activating one of the next two
>> repositories.
>> Give it a try - you can always revert back if that fails.
>>
>> Gerry
>>
>> --------------------------------------------------
>> From: "Mohammad Naghavi" <mo...@gmail.com>
>> Sent: Thursday, November 11, 2010 12:39 PM
>> To: "James Users List" <se...@james.apache.org>; "Gerry Matte" <
>> Gerry.Matte@shaw.ca>
>>
>> Subject: Re: Quick Start for 3.0-M2
>>
>> Hi Gerry
>>> I have changed the line in database.properties but according to logs
>>> mailstore is again using file storage. what should I change in
>>> mailstore.xml
>>> or any where else to use DB for mail storage?
>>>
>>> thanks again,
>>> MN
>>> ________________________________________
>>> PHP & ASP .Net 3.5 web developer
>>> Java & C# desktop developer
>>> www.mohamnag.com
>>>
>>>
>>>
>>> On Thu, Nov 11, 2010 at 7:18 PM, Gerry Matte <Ge...@shaw.ca>
>>> wrote:
>>>
>>> Hi Mohammed.
>>>> You used the DataSource driver (used in J2EE environments) instead of
>>>> the
>>>> stand-alone JDBC driver.
>>>> In your database.properties use
>>>> database.driverClassName=com.mysql.jdbc.Driver
>>>>
>>>> Cheers
>>>> Gerry
>>>>
>>>> --------------------------------------------------
>>>> From: "Mohammad Naghavi" <mo...@gmail.com>
>>>> Sent: Thursday, November 11, 2010 9:55 AM
>>>>
>>>> To: "James Users List" <se...@james.apache.org>
>>>> Subject: Re: Quick Start for 3.0-M2
>>>>
>>>> Hi there,
>>>>
>>>>> I have done some experiments with james 2.3 and now I'm trying to move
>>>>> on
>>>>> to
>>>>> James 3. the problem is the lack of documentation specially when it
>>>>> comes
>>>>> to
>>>>> DB configurations. I tried to use the same configs from james 2.3 to
>>>>> run
>>>>> james 3 with MySql backend but till now I got actually nothing. can
>>>>> any
>>>>> one
>>>>> point out the points I didn't made right in my config files?
>>>>> this is my *database.properties *file:
>>>>>
>>>>>
>>>>> # Use derby as default
>>>>> database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
>>>>> database.url=jdbc:mysql://127.0.0.1/james3test
>>>>> database.username=myDbUser
>>>>> database.password=myDbPass
>>>>>
>>>>> # Supported adapters are:
>>>>> # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL,
>>>>> SQL_SERVER,
>>>>> SYBASE
>>>>> vendorAdapter.database=MYSQL
>>>>>
>>>>> # Use streaming for Blobs
>>>>> # This is only supported on a limited set of databases atm. You should
>>>>> check
>>>>> if its supported by your DB before enable
>>>>> # it.
>>>>> #
>>>>> # See:
>>>>> #
>>>>>
>>>>>
>>>>> http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
>>>>> #7.11. LOB Streaming
>>>>> #
>>>>> openjpa.streaming=false
>>>>>
>>>>>
>>>>> but I actually don't know what should I change in *mailstore.xml *to
>>>>> store
>>>>> the mails inside DB. or where to configure to store users in DB.
>>>>>
>>>>> Thanks in advance,
>>>>> Mohammad Naghavi
>>>>> ________________________________________
>>>>> PHP & ASP .Net 3.5 web developer
>>>>> Java & C# desktop developer
>>>>> www.mohamnag.com
>>>>>
>>>>>
>>>>>
>>>>> On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
>>>>>
>>>>> Hi Ran,
>>>>>
>>>>>> That's really great!!!
>>>>>> If you like, you can add yourself to
>>>>>> http://wiki.apache.org/james/JamesUsers :) (I still need to link the
>>>>>> web
>>>>>> site to this page...)
>>>>>>
>>>>>> I will also publish your notes/ref via Twitter @ApacheJames.
>>>>>>
>>>>>> The memory usage should still be lower with M2 tks to optimizations
>>>>>> on
>>>>>> activemq component.
>>>>>>
>>>>>> Tks,
>>>>>>
>>>>>> Eric
>>>>>>
>>>>>>
>>>>>>
>>>>>> On 11/11/2010 06:45, RanBing wrote:
>>>>>>
>>>>>> I'm running a very early James 3 on a Linux 64 for mass marketing
>>>>>> and
>>>>>>
>>>>>>> the
>>>>>>> memory stays at 320MB under load.
>>>>>>>
>>>>>>> br
>>>>>>>
>>>>>>>
>>>>>>> --------------------------------------------------
>>>>>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>>>>>> Sent: Thursday, November 11, 2010 12:29 PM
>>>>>>> To: "James Users List" <se...@james.apache.org>
>>>>>>> Subject: Re: Quick Start for 3.0-M2
>>>>>>>
>>>>>>> I have a couple of questions:
>>>>>>>
>>>>>>>
>>>>>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>>>>>> (and
>>>>>>>> a
>>>>>>>> James server) on a VPS account that has 512 MB RAM total. Is James
>>>>>>>> 3
>>>>>>>> not an
>>>>>>>> option for me?
>>>>>>>>
>>>>>>>> 2. Are there plans on documenting how to add users to the database?
>>>>>>>> If
>>>>>>>> I
>>>>>>>> can run James 3 on my VPS, I may be able to help with this.
>>>>>>>> Telnetting
>>>>>>>> into
>>>>>>>> the remote manager is not something I have any interest in at all.
>>>>>>>>
>>>>>>>> Regards,
>>>>>>>> Eric MacAdie
>>>>>>>> President, Chicago Java Users Group
>>>>>>>> http://blog.cjug.org
>>>>>>>>
>>>>>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>>>>>
>>>>>>>> Hi Everyone,
>>>>>>>>
>>>>>>>>>
>>>>>>>>> I tried to make a short (though complete) quick start doc for
>>>>>>>>> 3.0-M2.
>>>>>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>>>>>> distribution as an operational mail server.
>>>>>>>>>
>>>>>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>>>>>> your
>>>>>>>>> feedback so we can have the best possible doc for upcoming 3.0-M2
>>>>>>>>> release.
>>>>>>>>> Tks,
>>>>>>>>>
>>>>>>>>> Eric
>>>>>>>>>
>>>>>>>>> Step 0: Requirements
>>>>>>>>> ####################
>>>>>>>>>
>>>>>>>>> JRE 1.5+
>>>>>>>>> root (linux/unix) or Administrator (Windows)
>>>>>>>>> libc6 (linux)
>>>>>>>>> 512MB RAM
>>>>>>>>>
>>>>>>>>> Step 1: Download
>>>>>>>>> #################
>>>>>>>>>
>>>>>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>>>>>
>>>>>>>>> Step 2: Deploy
>>>>>>>>> ##############
>>>>>>>>>
>>>>>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>>>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>>>>>>> and
>>>>>>>>> four text files.
>>>>>>>>>
>>>>>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>>>>>> $ cd james-server-container-spring-3.0-M2
>>>>>>>>> $ ls -l
>>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> Step 3: Configure
>>>>>>>>> #################
>>>>>>>>>
>>>>>>>>> All configuration files reside in the conf folder.
>>>>>>>>>
>>>>>>>>> $ cd conf
>>>>>>>>> $ ls -l
>>>>>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10
>>>>>>>>> james-listmanager.xml
>>>>>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07
>>>>>>>>> virtualusertable.xml
>>>>>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>>>>>> JPA
>>>>>>>>> (Derby database) storage for the mails and remote delivery from
>>>>>>>>> locahost
>>>>>>>>> only.
>>>>>>>>> You can edit the following files to change the behaviour:
>>>>>>>>>
>>>>>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>>>>>
>>>>>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>>>>>> usersrepository.xml
>>>>>>>>> <domainlist
>>>>>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>>>>>> <autodetect>true</autodetect>
>>>>>>>>> <autodetectIP>true</autodetectIP>
>>>>>>>>> </domainlist>
>>>>>>>>>
>>>>>>>>> - Edit the database.properties and change the values according to
>>>>>>>>> your
>>>>>>>>> database.
>>>>>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>>>>>> folder.
>>>>>>>>>
>>>>>>>>> Step 4: Start
>>>>>>>>> #############
>>>>>>>>>
>>>>>>>>> $ cd bin
>>>>>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo
>>>>>>>>> apt-get
>>>>>>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>>>>>> You can see log result in the log/james-server.log file.
>>>>>>>>>
>>>>>>>>> Step 5: Create Domains and Users
>>>>>>>>> ################################
>>>>>>>>>
>>>>>>>>> $ telnet localhost 4555
>>>>>>>>> Trying 127.0.0.1...
>>>>>>>>> Connected to localhost.
>>>>>>>>> Escape character is '^]'.
>>>>>>>>> JAMES Remote Administration Tool
>>>>>>>>> Please enter your login and password
>>>>>>>>> Login id:
>>>>>>>>> root
>>>>>>>>> Password:
>>>>>>>>> root
>>>>>>>>> Welcome root. HELP for a list of commands
>>>>>>>>> adddomain YOUR_DOMAIN
>>>>>>>>> Adding domain YOUR_DOMAIN successful
>>>>>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>>>>>> quit
>>>>>>>>> Bye
>>>>>>>>> Connection closed by foreign host.
>>>>>>>>>
>>>>>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you
>>>>>>>>> will
>>>>>>>>> have a test@localhost.net user.
>>>>>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>>>>>
>>>>>>>>> Step 6: Test
>>>>>>>>> ############
>>>>>>>>>
>>>>>>>>> $ telnet 127.0.0.1 25
>>>>>>>>> Trying 127.0.0.1...
>>>>>>>>> Connected to localhost.
>>>>>>>>> Escape character is '^]'.
>>>>>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat,
>>>>>>>>> 6
>>>>>>>>> Nov
>>>>>>>>> 2010 17:31:33 +0100 (CET)
>>>>>>>>> ehlo test
>>>>>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>>>>>> 250-PIPELINING
>>>>>>>>> 250-ENHANCEDSTATUSCODES
>>>>>>>>> 250 8BITMIME
>>>>>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>>>> data
>>>>>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>>>>>> subject: test
>>>>>>>>>
>>>>>>>>> this is a test
>>>>>>>>> .
>>>>>>>>> 250 2.6.0 Message received
>>>>>>>>> quit
>>>>>>>>> Connection closed by foreign host.
>>>>>>>>>
>>>>>>>>> Step 7: Manage
>>>>>>>>> ##############
>>>>>>>>>
>>>>>>>>> 7.1. Manage via telnet
>>>>>>>>> $ telnet localhost 4555
>>>>>>>>> Trying 127.0.0.1...
>>>>>>>>> Connected to localhost.
>>>>>>>>> Escape character is '^]'.
>>>>>>>>> JAMES Remote Administration Tool
>>>>>>>>> Please enter your login and password
>>>>>>>>> Login id:
>>>>>>>>> root
>>>>>>>>> Password:
>>>>>>>>> root
>>>>>>>>> Welcome root. HELP for a list of commands
>>>>>>>>> help
>>>>>>>>> adddomain [domainname] add domain to local domains
>>>>>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for
>>>>>>>>> the
>>>>>>>>> given emailaddress
>>>>>>>>> adduser [username] [password] add a new user
>>>>>>>>> countusers display the number of existing accounts
>>>>>>>>> deluser [username] delete existing user
>>>>>>>>> help displays this help
>>>>>>>>> listallmappings list all mappings
>>>>>>>>> listdomains list local domains
>>>>>>>>> listmapping [user@domain] list all mappings for the given
>>>>>>>>> emailaddress
>>>>>>>>> listusers display existing accounts
>>>>>>>>> memstat ([-gc]) shows memory usage. When called with -gc the
>>>>>>>>> garbage
>>>>>>>>> collector get called
>>>>>>>>> quit close connection
>>>>>>>>> removedomain [domainname] remove domain from local domains
>>>>>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>>>>>> the
>>>>>>>>> given emailaddress
>>>>>>>>> setpassword [username] [password] sets a user's password
>>>>>>>>> showalias [username] shows a user's current email alias
>>>>>>>>> showforwarding [username] shows a user's current email
>>>>>>>>> forwarding
>>>>>>>>> shutdown kills the current JVM (convenient when James is
>>>>>>>>> run
>>>>>>>>> as
>>>>>>>>> a
>>>>>>>>> daemon)
>>>>>>>>> unsetalias [user] unsets an alias for 'user'
>>>>>>>>> unsetforwarding [username] removes a forward
>>>>>>>>> user [repositoryname] change to another user repository
>>>>>>>>> verify [username] verify if specified user exist
>>>>>>>>>
>>>>>>>>> 7.2. Manage via JMX
>>>>>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>>>>>
>>>>>>>>> Step 8: Monitor
>>>>>>>>> ##############
>>>>>>>>>
>>>>>>>>> Monitor the ./log/james-server.log log file.
>>>>>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> ---------------------------------------------------------------------
>>>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> ---------------------------------------------------------------------
>>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>>>
>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
I would try it :) thanks and have a good trip :)
Mohammad
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Thu, Nov 11, 2010 at 10:19 PM, Gerry Matte <Ge...@shaw.ca> wrote:
> Hi Mohammed.
> Sorry for the delay - I'm packing for a trip.
> I never bothered to save messages in the database because my email clients
> download them rather than leaving them on the server.
> I believe from the mailstore comments that you can change this behavior by
> commenting the first repository and activating one of the next two
> repositories.
> Give it a try - you can always revert back if that fails.
>
> Gerry
>
> --------------------------------------------------
> From: "Mohammad Naghavi" <mo...@gmail.com>
> Sent: Thursday, November 11, 2010 12:39 PM
> To: "James Users List" <se...@james.apache.org>; "Gerry Matte" <
> Gerry.Matte@shaw.ca>
>
> Subject: Re: Quick Start for 3.0-M2
>
> Hi Gerry
>> I have changed the line in database.properties but according to logs
>> mailstore is again using file storage. what should I change in
>> mailstore.xml
>> or any where else to use DB for mail storage?
>>
>> thanks again,
>> MN
>> ________________________________________
>> PHP & ASP .Net 3.5 web developer
>> Java & C# desktop developer
>> www.mohamnag.com
>>
>>
>>
>> On Thu, Nov 11, 2010 at 7:18 PM, Gerry Matte <Ge...@shaw.ca> wrote:
>>
>> Hi Mohammed.
>>> You used the DataSource driver (used in J2EE environments) instead of the
>>> stand-alone JDBC driver.
>>> In your database.properties use
>>> database.driverClassName=com.mysql.jdbc.Driver
>>>
>>> Cheers
>>> Gerry
>>>
>>> --------------------------------------------------
>>> From: "Mohammad Naghavi" <mo...@gmail.com>
>>> Sent: Thursday, November 11, 2010 9:55 AM
>>>
>>> To: "James Users List" <se...@james.apache.org>
>>> Subject: Re: Quick Start for 3.0-M2
>>>
>>> Hi there,
>>>
>>>> I have done some experiments with james 2.3 and now I'm trying to move
>>>> on
>>>> to
>>>> James 3. the problem is the lack of documentation specially when it
>>>> comes
>>>> to
>>>> DB configurations. I tried to use the same configs from james 2.3 to run
>>>> james 3 with MySql backend but till now I got actually nothing. can any
>>>> one
>>>> point out the points I didn't made right in my config files?
>>>> this is my *database.properties *file:
>>>>
>>>>
>>>> # Use derby as default
>>>> database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
>>>> database.url=jdbc:mysql://127.0.0.1/james3test
>>>> database.username=myDbUser
>>>> database.password=myDbPass
>>>>
>>>> # Supported adapters are:
>>>> # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER,
>>>> SYBASE
>>>> vendorAdapter.database=MYSQL
>>>>
>>>> # Use streaming for Blobs
>>>> # This is only supported on a limited set of databases atm. You should
>>>> check
>>>> if its supported by your DB before enable
>>>> # it.
>>>> #
>>>> # See:
>>>> #
>>>>
>>>>
>>>> http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
>>>> #7.11. LOB Streaming
>>>> #
>>>> openjpa.streaming=false
>>>>
>>>>
>>>> but I actually don't know what should I change in *mailstore.xml *to
>>>> store
>>>> the mails inside DB. or where to configure to store users in DB.
>>>>
>>>> Thanks in advance,
>>>> Mohammad Naghavi
>>>> ________________________________________
>>>> PHP & ASP .Net 3.5 web developer
>>>> Java & C# desktop developer
>>>> www.mohamnag.com
>>>>
>>>>
>>>>
>>>> On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
>>>>
>>>> Hi Ran,
>>>>
>>>>> That's really great!!!
>>>>> If you like, you can add yourself to
>>>>> http://wiki.apache.org/james/JamesUsers :) (I still need to link the
>>>>> web
>>>>> site to this page...)
>>>>>
>>>>> I will also publish your notes/ref via Twitter @ApacheJames.
>>>>>
>>>>> The memory usage should still be lower with M2 tks to optimizations on
>>>>> activemq component.
>>>>>
>>>>> Tks,
>>>>>
>>>>> Eric
>>>>>
>>>>>
>>>>>
>>>>> On 11/11/2010 06:45, RanBing wrote:
>>>>>
>>>>> I'm running a very early James 3 on a Linux 64 for mass marketing and
>>>>>
>>>>>> the
>>>>>> memory stays at 320MB under load.
>>>>>>
>>>>>> br
>>>>>>
>>>>>>
>>>>>> --------------------------------------------------
>>>>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>>>>> Sent: Thursday, November 11, 2010 12:29 PM
>>>>>> To: "James Users List" <se...@james.apache.org>
>>>>>> Subject: Re: Quick Start for 3.0-M2
>>>>>>
>>>>>> I have a couple of questions:
>>>>>>
>>>>>>
>>>>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>>>>> (and
>>>>>>> a
>>>>>>> James server) on a VPS account that has 512 MB RAM total. Is James 3
>>>>>>> not an
>>>>>>> option for me?
>>>>>>>
>>>>>>> 2. Are there plans on documenting how to add users to the database?
>>>>>>> If
>>>>>>> I
>>>>>>> can run James 3 on my VPS, I may be able to help with this.
>>>>>>> Telnetting
>>>>>>> into
>>>>>>> the remote manager is not something I have any interest in at all.
>>>>>>>
>>>>>>> Regards,
>>>>>>> Eric MacAdie
>>>>>>> President, Chicago Java Users Group
>>>>>>> http://blog.cjug.org
>>>>>>>
>>>>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>>>>
>>>>>>> Hi Everyone,
>>>>>>>
>>>>>>>>
>>>>>>>> I tried to make a short (though complete) quick start doc for
>>>>>>>> 3.0-M2.
>>>>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>>>>> distribution as an operational mail server.
>>>>>>>>
>>>>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>>>>> your
>>>>>>>> feedback so we can have the best possible doc for upcoming 3.0-M2
>>>>>>>> release.
>>>>>>>> Tks,
>>>>>>>>
>>>>>>>> Eric
>>>>>>>>
>>>>>>>> Step 0: Requirements
>>>>>>>> ####################
>>>>>>>>
>>>>>>>> JRE 1.5+
>>>>>>>> root (linux/unix) or Administrator (Windows)
>>>>>>>> libc6 (linux)
>>>>>>>> 512MB RAM
>>>>>>>>
>>>>>>>> Step 1: Download
>>>>>>>> #################
>>>>>>>>
>>>>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>>>>
>>>>>>>> Step 2: Deploy
>>>>>>>> ##############
>>>>>>>>
>>>>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>>>>>> and
>>>>>>>> four text files.
>>>>>>>>
>>>>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>>>>> $ cd james-server-container-spring-3.0-M2
>>>>>>>> $ ls -l
>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>>>>
>>>>>>>>
>>>>>>>> Step 3: Configure
>>>>>>>> #################
>>>>>>>>
>>>>>>>> All configuration files reside in the conf folder.
>>>>>>>>
>>>>>>>> $ cd conf
>>>>>>>> $ ls -l
>>>>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>>>>
>>>>>>>>
>>>>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>>>>> JPA
>>>>>>>> (Derby database) storage for the mails and remote delivery from
>>>>>>>> locahost
>>>>>>>> only.
>>>>>>>> You can edit the following files to change the behaviour:
>>>>>>>>
>>>>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>>>>
>>>>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>>>>> usersrepository.xml
>>>>>>>> <domainlist
>>>>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>>>>> <autodetect>true</autodetect>
>>>>>>>> <autodetectIP>true</autodetectIP>
>>>>>>>> </domainlist>
>>>>>>>>
>>>>>>>> - Edit the database.properties and change the values according to
>>>>>>>> your
>>>>>>>> database.
>>>>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>>>>> folder.
>>>>>>>>
>>>>>>>> Step 4: Start
>>>>>>>> #############
>>>>>>>>
>>>>>>>> $ cd bin
>>>>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>>>>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>>>>> You can see log result in the log/james-server.log file.
>>>>>>>>
>>>>>>>> Step 5: Create Domains and Users
>>>>>>>> ################################
>>>>>>>>
>>>>>>>> $ telnet localhost 4555
>>>>>>>> Trying 127.0.0.1...
>>>>>>>> Connected to localhost.
>>>>>>>> Escape character is '^]'.
>>>>>>>> JAMES Remote Administration Tool
>>>>>>>> Please enter your login and password
>>>>>>>> Login id:
>>>>>>>> root
>>>>>>>> Password:
>>>>>>>> root
>>>>>>>> Welcome root. HELP for a list of commands
>>>>>>>> adddomain YOUR_DOMAIN
>>>>>>>> Adding domain YOUR_DOMAIN successful
>>>>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>>>>> quit
>>>>>>>> Bye
>>>>>>>> Connection closed by foreign host.
>>>>>>>>
>>>>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>>>>>> have a test@localhost.net user.
>>>>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>>>>
>>>>>>>> Step 6: Test
>>>>>>>> ############
>>>>>>>>
>>>>>>>> $ telnet 127.0.0.1 25
>>>>>>>> Trying 127.0.0.1...
>>>>>>>> Connected to localhost.
>>>>>>>> Escape character is '^]'.
>>>>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>>>>>>> Nov
>>>>>>>> 2010 17:31:33 +0100 (CET)
>>>>>>>> ehlo test
>>>>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>>>>> 250-PIPELINING
>>>>>>>> 250-ENHANCEDSTATUSCODES
>>>>>>>> 250 8BITMIME
>>>>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>>> data
>>>>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>>>>> subject: test
>>>>>>>>
>>>>>>>> this is a test
>>>>>>>> .
>>>>>>>> 250 2.6.0 Message received
>>>>>>>> quit
>>>>>>>> Connection closed by foreign host.
>>>>>>>>
>>>>>>>> Step 7: Manage
>>>>>>>> ##############
>>>>>>>>
>>>>>>>> 7.1. Manage via telnet
>>>>>>>> $ telnet localhost 4555
>>>>>>>> Trying 127.0.0.1...
>>>>>>>> Connected to localhost.
>>>>>>>> Escape character is '^]'.
>>>>>>>> JAMES Remote Administration Tool
>>>>>>>> Please enter your login and password
>>>>>>>> Login id:
>>>>>>>> root
>>>>>>>> Password:
>>>>>>>> root
>>>>>>>> Welcome root. HELP for a list of commands
>>>>>>>> help
>>>>>>>> adddomain [domainname] add domain to local domains
>>>>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>>>>>> given emailaddress
>>>>>>>> adduser [username] [password] add a new user
>>>>>>>> countusers display the number of existing accounts
>>>>>>>> deluser [username] delete existing user
>>>>>>>> help displays this help
>>>>>>>> listallmappings list all mappings
>>>>>>>> listdomains list local domains
>>>>>>>> listmapping [user@domain] list all mappings for the given
>>>>>>>> emailaddress
>>>>>>>> listusers display existing accounts
>>>>>>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>>>>>>> collector get called
>>>>>>>> quit close connection
>>>>>>>> removedomain [domainname] remove domain from local domains
>>>>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>>>>> the
>>>>>>>> given emailaddress
>>>>>>>> setpassword [username] [password] sets a user's password
>>>>>>>> showalias [username] shows a user's current email alias
>>>>>>>> showforwarding [username] shows a user's current email
>>>>>>>> forwarding
>>>>>>>> shutdown kills the current JVM (convenient when James is run
>>>>>>>> as
>>>>>>>> a
>>>>>>>> daemon)
>>>>>>>> unsetalias [user] unsets an alias for 'user'
>>>>>>>> unsetforwarding [username] removes a forward
>>>>>>>> user [repositoryname] change to another user repository
>>>>>>>> verify [username] verify if specified user exist
>>>>>>>>
>>>>>>>> 7.2. Manage via JMX
>>>>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>>>>
>>>>>>>> Step 8: Monitor
>>>>>>>> ##############
>>>>>>>>
>>>>>>>> Monitor the ./log/james-server.log log file.
>>>>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>>
>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>
>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>
>>>>>
>>>>>
>>>>>
>>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>>
>>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Gerry Matte <Ge...@shaw.ca>.
Hi Mohammed.
Sorry for the delay - I'm packing for a trip.
I never bothered to save messages in the database because my email clients
download them rather than leaving them on the server.
I believe from the mailstore comments that you can change this behavior by
commenting the first repository and activating one of the next two
repositories.
Give it a try - you can always revert back if that fails.
Gerry
--------------------------------------------------
From: "Mohammad Naghavi" <mo...@gmail.com>
Sent: Thursday, November 11, 2010 12:39 PM
To: "James Users List" <se...@james.apache.org>; "Gerry Matte"
<Ge...@shaw.ca>
Subject: Re: Quick Start for 3.0-M2
> Hi Gerry
> I have changed the line in database.properties but according to logs
> mailstore is again using file storage. what should I change in
> mailstore.xml
> or any where else to use DB for mail storage?
>
> thanks again,
> MN
> ________________________________________
> PHP & ASP .Net 3.5 web developer
> Java & C# desktop developer
> www.mohamnag.com
>
>
>
> On Thu, Nov 11, 2010 at 7:18 PM, Gerry Matte <Ge...@shaw.ca> wrote:
>
>> Hi Mohammed.
>> You used the DataSource driver (used in J2EE environments) instead of the
>> stand-alone JDBC driver.
>> In your database.properties use
>> database.driverClassName=com.mysql.jdbc.Driver
>>
>> Cheers
>> Gerry
>>
>> --------------------------------------------------
>> From: "Mohammad Naghavi" <mo...@gmail.com>
>> Sent: Thursday, November 11, 2010 9:55 AM
>>
>> To: "James Users List" <se...@james.apache.org>
>> Subject: Re: Quick Start for 3.0-M2
>>
>> Hi there,
>>> I have done some experiments with james 2.3 and now I'm trying to move
>>> on
>>> to
>>> James 3. the problem is the lack of documentation specially when it
>>> comes
>>> to
>>> DB configurations. I tried to use the same configs from james 2.3 to run
>>> james 3 with MySql backend but till now I got actually nothing. can any
>>> one
>>> point out the points I didn't made right in my config files?
>>> this is my *database.properties *file:
>>>
>>>
>>> # Use derby as default
>>> database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
>>> database.url=jdbc:mysql://127.0.0.1/james3test
>>> database.username=myDbUser
>>> database.password=myDbPass
>>>
>>> # Supported adapters are:
>>> # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER,
>>> SYBASE
>>> vendorAdapter.database=MYSQL
>>>
>>> # Use streaming for Blobs
>>> # This is only supported on a limited set of databases atm. You should
>>> check
>>> if its supported by your DB before enable
>>> # it.
>>> #
>>> # See:
>>> #
>>>
>>> http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
>>> #7.11. LOB Streaming
>>> #
>>> openjpa.streaming=false
>>>
>>>
>>> but I actually don't know what should I change in *mailstore.xml *to
>>> store
>>> the mails inside DB. or where to configure to store users in DB.
>>>
>>> Thanks in advance,
>>> Mohammad Naghavi
>>> ________________________________________
>>> PHP & ASP .Net 3.5 web developer
>>> Java & C# desktop developer
>>> www.mohamnag.com
>>>
>>>
>>>
>>> On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
>>>
>>> Hi Ran,
>>>> That's really great!!!
>>>> If you like, you can add yourself to
>>>> http://wiki.apache.org/james/JamesUsers :) (I still need to link the
>>>> web
>>>> site to this page...)
>>>>
>>>> I will also publish your notes/ref via Twitter @ApacheJames.
>>>>
>>>> The memory usage should still be lower with M2 tks to optimizations on
>>>> activemq component.
>>>>
>>>> Tks,
>>>>
>>>> Eric
>>>>
>>>>
>>>>
>>>> On 11/11/2010 06:45, RanBing wrote:
>>>>
>>>> I'm running a very early James 3 on a Linux 64 for mass marketing and
>>>>> the
>>>>> memory stays at 320MB under load.
>>>>>
>>>>> br
>>>>>
>>>>>
>>>>> --------------------------------------------------
>>>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>>>> Sent: Thursday, November 11, 2010 12:29 PM
>>>>> To: "James Users List" <se...@james.apache.org>
>>>>> Subject: Re: Quick Start for 3.0-M2
>>>>>
>>>>> I have a couple of questions:
>>>>>
>>>>>>
>>>>>> 1. One of the requirements is 512 MB of RAM. I am running my site
>>>>>> (and
>>>>>> a
>>>>>> James server) on a VPS account that has 512 MB RAM total. Is James 3
>>>>>> not an
>>>>>> option for me?
>>>>>>
>>>>>> 2. Are there plans on documenting how to add users to the database?
>>>>>> If
>>>>>> I
>>>>>> can run James 3 on my VPS, I may be able to help with this.
>>>>>> Telnetting
>>>>>> into
>>>>>> the remote manager is not something I have any interest in at all.
>>>>>>
>>>>>> Regards,
>>>>>> Eric MacAdie
>>>>>> President, Chicago Java Users Group
>>>>>> http://blog.cjug.org
>>>>>>
>>>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>>>
>>>>>> Hi Everyone,
>>>>>>>
>>>>>>> I tried to make a short (though complete) quick start doc for
>>>>>>> 3.0-M2.
>>>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>>>> distribution as an operational mail server.
>>>>>>>
>>>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>>>>>> your
>>>>>>> feedback so we can have the best possible doc for upcoming 3.0-M2
>>>>>>> release.
>>>>>>> Tks,
>>>>>>>
>>>>>>> Eric
>>>>>>>
>>>>>>> Step 0: Requirements
>>>>>>> ####################
>>>>>>>
>>>>>>> JRE 1.5+
>>>>>>> root (linux/unix) or Administrator (Windows)
>>>>>>> libc6 (linux)
>>>>>>> 512MB RAM
>>>>>>>
>>>>>>> Step 1: Download
>>>>>>> #################
>>>>>>>
>>>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>>>
>>>>>>> Step 2: Deploy
>>>>>>> ##############
>>>>>>>
>>>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>>>>>> and
>>>>>>> four text files.
>>>>>>>
>>>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>>>> $ cd james-server-container-spring-3.0-M2
>>>>>>> $ ls -l
>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>>>
>>>>>>>
>>>>>>> Step 3: Configure
>>>>>>> #################
>>>>>>>
>>>>>>> All configuration files reside in the conf folder.
>>>>>>>
>>>>>>> $ cd conf
>>>>>>> $ ls -l
>>>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>>>
>>>>>>>
>>>>>>> James is packaged with virtual hosting disabled, XML domain list,
>>>>>>> JPA
>>>>>>> (Derby database) storage for the mails and remote delivery from
>>>>>>> locahost
>>>>>>> only.
>>>>>>> You can edit the following files to change the behaviour:
>>>>>>>
>>>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>>>
>>>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>>>> usersrepository.xml
>>>>>>> <domainlist
>>>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>>>> <autodetect>true</autodetect>
>>>>>>> <autodetectIP>true</autodetectIP>
>>>>>>> </domainlist>
>>>>>>>
>>>>>>> - Edit the database.properties and change the values according to
>>>>>>> your
>>>>>>> database.
>>>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>>>> folder.
>>>>>>>
>>>>>>> Step 4: Start
>>>>>>> #############
>>>>>>>
>>>>>>> $ cd bin
>>>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>>>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>>>> You can see log result in the log/james-server.log file.
>>>>>>>
>>>>>>> Step 5: Create Domains and Users
>>>>>>> ################################
>>>>>>>
>>>>>>> $ telnet localhost 4555
>>>>>>> Trying 127.0.0.1...
>>>>>>> Connected to localhost.
>>>>>>> Escape character is '^]'.
>>>>>>> JAMES Remote Administration Tool
>>>>>>> Please enter your login and password
>>>>>>> Login id:
>>>>>>> root
>>>>>>> Password:
>>>>>>> root
>>>>>>> Welcome root. HELP for a list of commands
>>>>>>> adddomain YOUR_DOMAIN
>>>>>>> Adding domain YOUR_DOMAIN successful
>>>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>>>> quit
>>>>>>> Bye
>>>>>>> Connection closed by foreign host.
>>>>>>>
>>>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>>>>> have a test@localhost.net user.
>>>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>>>
>>>>>>> Step 6: Test
>>>>>>> ############
>>>>>>>
>>>>>>> $ telnet 127.0.0.1 25
>>>>>>> Trying 127.0.0.1...
>>>>>>> Connected to localhost.
>>>>>>> Escape character is '^]'.
>>>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>>>>>> Nov
>>>>>>> 2010 17:31:33 +0100 (CET)
>>>>>>> ehlo test
>>>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>>>> 250-PIPELINING
>>>>>>> 250-ENHANCEDSTATUSCODES
>>>>>>> 250 8BITMIME
>>>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>>> data
>>>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>>>> subject: test
>>>>>>>
>>>>>>> this is a test
>>>>>>> .
>>>>>>> 250 2.6.0 Message received
>>>>>>> quit
>>>>>>> Connection closed by foreign host.
>>>>>>>
>>>>>>> Step 7: Manage
>>>>>>> ##############
>>>>>>>
>>>>>>> 7.1. Manage via telnet
>>>>>>> $ telnet localhost 4555
>>>>>>> Trying 127.0.0.1...
>>>>>>> Connected to localhost.
>>>>>>> Escape character is '^]'.
>>>>>>> JAMES Remote Administration Tool
>>>>>>> Please enter your login and password
>>>>>>> Login id:
>>>>>>> root
>>>>>>> Password:
>>>>>>> root
>>>>>>> Welcome root. HELP for a list of commands
>>>>>>> help
>>>>>>> adddomain [domainname] add domain to local domains
>>>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>>>>> given emailaddress
>>>>>>> adduser [username] [password] add a new user
>>>>>>> countusers display the number of existing accounts
>>>>>>> deluser [username] delete existing user
>>>>>>> help displays this help
>>>>>>> listallmappings list all mappings
>>>>>>> listdomains list local domains
>>>>>>> listmapping [user@domain] list all mappings for the given
>>>>>>> emailaddress
>>>>>>> listusers display existing accounts
>>>>>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>>>>>> collector get called
>>>>>>> quit close connection
>>>>>>> removedomain [domainname] remove domain from local domains
>>>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>>>> the
>>>>>>> given emailaddress
>>>>>>> setpassword [username] [password] sets a user's password
>>>>>>> showalias [username] shows a user's current email alias
>>>>>>> showforwarding [username] shows a user's current email
>>>>>>> forwarding
>>>>>>> shutdown kills the current JVM (convenient when James is run
>>>>>>> as
>>>>>>> a
>>>>>>> daemon)
>>>>>>> unsetalias [user] unsets an alias for 'user'
>>>>>>> unsetforwarding [username] removes a forward
>>>>>>> user [repositoryname] change to another user repository
>>>>>>> verify [username] verify if specified user exist
>>>>>>>
>>>>>>> 7.2. Manage via JMX
>>>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>>>
>>>>>>> Step 8: Monitor
>>>>>>> ##############
>>>>>>>
>>>>>>> Monitor the ./log/james-server.log log file.
>>>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>>>
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>
>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>
>>>>>
>>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Hi Gerry
I have changed the line in database.properties but according to logs
mailstore is again using file storage. what should I change in mailstore.xml
or any where else to use DB for mail storage?
thanks again,
MN
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Thu, Nov 11, 2010 at 7:18 PM, Gerry Matte <Ge...@shaw.ca> wrote:
> Hi Mohammed.
> You used the DataSource driver (used in J2EE environments) instead of the
> stand-alone JDBC driver.
> In your database.properties use
> database.driverClassName=com.mysql.jdbc.Driver
>
> Cheers
> Gerry
>
> --------------------------------------------------
> From: "Mohammad Naghavi" <mo...@gmail.com>
> Sent: Thursday, November 11, 2010 9:55 AM
>
> To: "James Users List" <se...@james.apache.org>
> Subject: Re: Quick Start for 3.0-M2
>
> Hi there,
>> I have done some experiments with james 2.3 and now I'm trying to move on
>> to
>> James 3. the problem is the lack of documentation specially when it comes
>> to
>> DB configurations. I tried to use the same configs from james 2.3 to run
>> james 3 with MySql backend but till now I got actually nothing. can any
>> one
>> point out the points I didn't made right in my config files?
>> this is my *database.properties *file:
>>
>>
>> # Use derby as default
>> database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
>> database.url=jdbc:mysql://127.0.0.1/james3test
>> database.username=myDbUser
>> database.password=myDbPass
>>
>> # Supported adapters are:
>> # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER,
>> SYBASE
>> vendorAdapter.database=MYSQL
>>
>> # Use streaming for Blobs
>> # This is only supported on a limited set of databases atm. You should
>> check
>> if its supported by your DB before enable
>> # it.
>> #
>> # See:
>> #
>>
>> http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
>> #7.11. LOB Streaming
>> #
>> openjpa.streaming=false
>>
>>
>> but I actually don't know what should I change in *mailstore.xml *to store
>> the mails inside DB. or where to configure to store users in DB.
>>
>> Thanks in advance,
>> Mohammad Naghavi
>> ________________________________________
>> PHP & ASP .Net 3.5 web developer
>> Java & C# desktop developer
>> www.mohamnag.com
>>
>>
>>
>> On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
>>
>> Hi Ran,
>>> That's really great!!!
>>> If you like, you can add yourself to
>>> http://wiki.apache.org/james/JamesUsers :) (I still need to link the web
>>> site to this page...)
>>>
>>> I will also publish your notes/ref via Twitter @ApacheJames.
>>>
>>> The memory usage should still be lower with M2 tks to optimizations on
>>> activemq component.
>>>
>>> Tks,
>>>
>>> Eric
>>>
>>>
>>>
>>> On 11/11/2010 06:45, RanBing wrote:
>>>
>>> I'm running a very early James 3 on a Linux 64 for mass marketing and
>>>> the
>>>> memory stays at 320MB under load.
>>>>
>>>> br
>>>>
>>>>
>>>> --------------------------------------------------
>>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>>> Sent: Thursday, November 11, 2010 12:29 PM
>>>> To: "James Users List" <se...@james.apache.org>
>>>> Subject: Re: Quick Start for 3.0-M2
>>>>
>>>> I have a couple of questions:
>>>>
>>>>>
>>>>> 1. One of the requirements is 512 MB of RAM. I am running my site (and
>>>>> a
>>>>> James server) on a VPS account that has 512 MB RAM total. Is James 3
>>>>> not an
>>>>> option for me?
>>>>>
>>>>> 2. Are there plans on documenting how to add users to the database? If
>>>>> I
>>>>> can run James 3 on my VPS, I may be able to help with this. Telnetting
>>>>> into
>>>>> the remote manager is not something I have any interest in at all.
>>>>>
>>>>> Regards,
>>>>> Eric MacAdie
>>>>> President, Chicago Java Users Group
>>>>> http://blog.cjug.org
>>>>>
>>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>>
>>>>> Hi Everyone,
>>>>>>
>>>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>>> distribution as an operational mail server.
>>>>>>
>>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>>>>>> feedback so we can have the best possible doc for upcoming 3.0-M2
>>>>>> release.
>>>>>> Tks,
>>>>>>
>>>>>> Eric
>>>>>>
>>>>>> Step 0: Requirements
>>>>>> ####################
>>>>>>
>>>>>> JRE 1.5+
>>>>>> root (linux/unix) or Administrator (Windows)
>>>>>> libc6 (linux)
>>>>>> 512MB RAM
>>>>>>
>>>>>> Step 1: Download
>>>>>> #################
>>>>>>
>>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>>
>>>>>> Step 2: Deploy
>>>>>> ##############
>>>>>>
>>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>>> You should have a folder with sub-folders bin, conf, lib, log, var and
>>>>>> four text files.
>>>>>>
>>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>>> $ cd james-server-container-spring-3.0-M2
>>>>>> $ ls -l
>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>>
>>>>>>
>>>>>> Step 3: Configure
>>>>>> #################
>>>>>>
>>>>>> All configuration files reside in the conf folder.
>>>>>>
>>>>>> $ cd conf
>>>>>> $ ls -l
>>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>>
>>>>>>
>>>>>> James is packaged with virtual hosting disabled, XML domain list, JPA
>>>>>> (Derby database) storage for the mails and remote delivery from
>>>>>> locahost
>>>>>> only.
>>>>>> You can edit the following files to change the behaviour:
>>>>>>
>>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>>
>>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>>> usersrepository.xml
>>>>>> <domainlist
>>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>>> <autodetect>true</autodetect>
>>>>>> <autodetectIP>true</autodetectIP>
>>>>>> </domainlist>
>>>>>>
>>>>>> - Edit the database.properties and change the values according to your
>>>>>> database.
>>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>>> folder.
>>>>>>
>>>>>> Step 4: Start
>>>>>> #############
>>>>>>
>>>>>> $ cd bin
>>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>>> You can see log result in the log/james-server.log file.
>>>>>>
>>>>>> Step 5: Create Domains and Users
>>>>>> ################################
>>>>>>
>>>>>> $ telnet localhost 4555
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> JAMES Remote Administration Tool
>>>>>> Please enter your login and password
>>>>>> Login id:
>>>>>> root
>>>>>> Password:
>>>>>> root
>>>>>> Welcome root. HELP for a list of commands
>>>>>> adddomain YOUR_DOMAIN
>>>>>> Adding domain YOUR_DOMAIN successful
>>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>>> quit
>>>>>> Bye
>>>>>> Connection closed by foreign host.
>>>>>>
>>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>>>> have a test@localhost.net user.
>>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>>
>>>>>> Step 6: Test
>>>>>> ############
>>>>>>
>>>>>> $ telnet 127.0.0.1 25
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>>>>> Nov
>>>>>> 2010 17:31:33 +0100 (CET)
>>>>>> ehlo test
>>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>>> 250-PIPELINING
>>>>>> 250-ENHANCEDSTATUSCODES
>>>>>> 250 8BITMIME
>>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>>> data
>>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>>> subject: test
>>>>>>
>>>>>> this is a test
>>>>>> .
>>>>>> 250 2.6.0 Message received
>>>>>> quit
>>>>>> Connection closed by foreign host.
>>>>>>
>>>>>> Step 7: Manage
>>>>>> ##############
>>>>>>
>>>>>> 7.1. Manage via telnet
>>>>>> $ telnet localhost 4555
>>>>>> Trying 127.0.0.1...
>>>>>> Connected to localhost.
>>>>>> Escape character is '^]'.
>>>>>> JAMES Remote Administration Tool
>>>>>> Please enter your login and password
>>>>>> Login id:
>>>>>> root
>>>>>> Password:
>>>>>> root
>>>>>> Welcome root. HELP for a list of commands
>>>>>> help
>>>>>> adddomain [domainname] add domain to local domains
>>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>>>> given emailaddress
>>>>>> adduser [username] [password] add a new user
>>>>>> countusers display the number of existing accounts
>>>>>> deluser [username] delete existing user
>>>>>> help displays this help
>>>>>> listallmappings list all mappings
>>>>>> listdomains list local domains
>>>>>> listmapping [user@domain] list all mappings for the given
>>>>>> emailaddress
>>>>>> listusers display existing accounts
>>>>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>>>>> collector get called
>>>>>> quit close connection
>>>>>> removedomain [domainname] remove domain from local domains
>>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>>>>> the
>>>>>> given emailaddress
>>>>>> setpassword [username] [password] sets a user's password
>>>>>> showalias [username] shows a user's current email alias
>>>>>> showforwarding [username] shows a user's current email
>>>>>> forwarding
>>>>>> shutdown kills the current JVM (convenient when James is run as
>>>>>> a
>>>>>> daemon)
>>>>>> unsetalias [user] unsets an alias for 'user'
>>>>>> unsetforwarding [username] removes a forward
>>>>>> user [repositoryname] change to another user repository
>>>>>> verify [username] verify if specified user exist
>>>>>>
>>>>>> 7.2. Manage via JMX
>>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>>
>>>>>> Step 8: Monitor
>>>>>> ##############
>>>>>>
>>>>>> Monitor the ./log/james-server.log log file.
>>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>
>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>>
>>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Gerry Matte <Ge...@shaw.ca>.
Hi Mohammed.
You used the DataSource driver (used in J2EE environments) instead of the
stand-alone JDBC driver.
In your database.properties use
database.driverClassName=com.mysql.jdbc.Driver
Cheers
Gerry
--------------------------------------------------
From: "Mohammad Naghavi" <mo...@gmail.com>
Sent: Thursday, November 11, 2010 9:55 AM
To: "James Users List" <se...@james.apache.org>
Subject: Re: Quick Start for 3.0-M2
> Hi there,
> I have done some experiments with james 2.3 and now I'm trying to move on
> to
> James 3. the problem is the lack of documentation specially when it comes
> to
> DB configurations. I tried to use the same configs from james 2.3 to run
> james 3 with MySql backend but till now I got actually nothing. can any
> one
> point out the points I didn't made right in my config files?
> this is my *database.properties *file:
>
>
> # Use derby as default
> database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
> database.url=jdbc:mysql://127.0.0.1/james3test
> database.username=myDbUser
> database.password=myDbPass
>
> # Supported adapters are:
> # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER,
> SYBASE
> vendorAdapter.database=MYSQL
>
> # Use streaming for Blobs
> # This is only supported on a limited set of databases atm. You should
> check
> if its supported by your DB before enable
> # it.
> #
> # See:
> #
> http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
> #7.11. LOB Streaming
> #
> openjpa.streaming=false
>
>
> but I actually don't know what should I change in *mailstore.xml *to store
> the mails inside DB. or where to configure to store users in DB.
>
> Thanks in advance,
> Mohammad Naghavi
> ________________________________________
> PHP & ASP .Net 3.5 web developer
> Java & C# desktop developer
> www.mohamnag.com
>
>
>
> On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
>
>> Hi Ran,
>> That's really great!!!
>> If you like, you can add yourself to
>> http://wiki.apache.org/james/JamesUsers :) (I still need to link the web
>> site to this page...)
>>
>> I will also publish your notes/ref via Twitter @ApacheJames.
>>
>> The memory usage should still be lower with M2 tks to optimizations on
>> activemq component.
>>
>> Tks,
>>
>> Eric
>>
>>
>>
>> On 11/11/2010 06:45, RanBing wrote:
>>
>>> I'm running a very early James 3 on a Linux 64 for mass marketing and
>>> the
>>> memory stays at 320MB under load.
>>>
>>> br
>>>
>>>
>>> --------------------------------------------------
>>> From: "Eric MacAdie" <er...@MacAdie.net>
>>> Sent: Thursday, November 11, 2010 12:29 PM
>>> To: "James Users List" <se...@james.apache.org>
>>> Subject: Re: Quick Start for 3.0-M2
>>>
>>> I have a couple of questions:
>>>>
>>>> 1. One of the requirements is 512 MB of RAM. I am running my site (and
>>>> a
>>>> James server) on a VPS account that has 512 MB RAM total. Is James 3
>>>> not an
>>>> option for me?
>>>>
>>>> 2. Are there plans on documenting how to add users to the database? If
>>>> I
>>>> can run James 3 on my VPS, I may be able to help with this. Telnetting
>>>> into
>>>> the remote manager is not something I have any interest in at all.
>>>>
>>>> Regards,
>>>> Eric MacAdie
>>>> President, Chicago Java Users Group
>>>> http://blog.cjug.org
>>>>
>>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>>
>>>>> Hi Everyone,
>>>>>
>>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>>> The goal of the doc is to allow anyone to start with James binary
>>>>> distribution as an operational mail server.
>>>>>
>>>>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>>>>> feedback so we can have the best possible doc for upcoming 3.0-M2
>>>>> release.
>>>>> Tks,
>>>>>
>>>>> Eric
>>>>>
>>>>> Step 0: Requirements
>>>>> ####################
>>>>>
>>>>> JRE 1.5+
>>>>> root (linux/unix) or Administrator (Windows)
>>>>> libc6 (linux)
>>>>> 512MB RAM
>>>>>
>>>>> Step 1: Download
>>>>> #################
>>>>>
>>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>>
>>>>> Step 2: Deploy
>>>>> ##############
>>>>>
>>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>>> You should have a folder with sub-folders bin, conf, lib, log, var and
>>>>> four text files.
>>>>>
>>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>>> $ cd james-server-container-spring-3.0-M2
>>>>> $ ls -l
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>>
>>>>>
>>>>> Step 3: Configure
>>>>> #################
>>>>>
>>>>> All configuration files reside in the conf folder.
>>>>>
>>>>> $ cd conf
>>>>> $ ls -l
>>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>>
>>>>>
>>>>> James is packaged with virtual hosting disabled, XML domain list, JPA
>>>>> (Derby database) storage for the mails and remote delivery from
>>>>> locahost
>>>>> only.
>>>>> You can edit the following files to change the behaviour:
>>>>>
>>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>>
>>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>>> usersrepository.xml
>>>>> <domainlist
>>>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>>>> <autodetect>true</autodetect>
>>>>> <autodetectIP>true</autodetectIP>
>>>>> </domainlist>
>>>>>
>>>>> - Edit the database.properties and change the values according to your
>>>>> database.
>>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>>> folder.
>>>>>
>>>>> Step 4: Start
>>>>> #############
>>>>>
>>>>> $ cd bin
>>>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>>> You can see log result in the log/james-server.log file.
>>>>>
>>>>> Step 5: Create Domains and Users
>>>>> ################################
>>>>>
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> adddomain YOUR_DOMAIN
>>>>> Adding domain YOUR_DOMAIN successful
>>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>>> quit
>>>>> Bye
>>>>> Connection closed by foreign host.
>>>>>
>>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>>> have a test@localhost.net user.
>>>>> The username to use in you mail client will be test@localhost.net.
>>>>>
>>>>> Step 6: Test
>>>>> ############
>>>>>
>>>>> $ telnet 127.0.0.1 25
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>>>> Nov
>>>>> 2010 17:31:33 +0100 (CET)
>>>>> ehlo test
>>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>>> 250-PIPELINING
>>>>> 250-ENHANCEDSTATUSCODES
>>>>> 250 8BITMIME
>>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>>> data
>>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>>> subject: test
>>>>>
>>>>> this is a test
>>>>> .
>>>>> 250 2.6.0 Message received
>>>>> quit
>>>>> Connection closed by foreign host.
>>>>>
>>>>> Step 7: Manage
>>>>> ##############
>>>>>
>>>>> 7.1. Manage via telnet
>>>>> $ telnet localhost 4555
>>>>> Trying 127.0.0.1...
>>>>> Connected to localhost.
>>>>> Escape character is '^]'.
>>>>> JAMES Remote Administration Tool
>>>>> Please enter your login and password
>>>>> Login id:
>>>>> root
>>>>> Password:
>>>>> root
>>>>> Welcome root. HELP for a list of commands
>>>>> help
>>>>> adddomain [domainname] add domain to local domains
>>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>>> given emailaddress
>>>>> adduser [username] [password] add a new user
>>>>> countusers display the number of existing accounts
>>>>> deluser [username] delete existing user
>>>>> help displays this help
>>>>> listallmappings list all mappings
>>>>> listdomains list local domains
>>>>> listmapping [user@domain] list all mappings for the given
>>>>> emailaddress
>>>>> listusers display existing accounts
>>>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>>>> collector get called
>>>>> quit close connection
>>>>> removedomain [domainname] remove domain from local domains
>>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
>>>>> given emailaddress
>>>>> setpassword [username] [password] sets a user's password
>>>>> showalias [username] shows a user's current email alias
>>>>> showforwarding [username] shows a user's current email
>>>>> forwarding
>>>>> shutdown kills the current JVM (convenient when James is run as
>>>>> a
>>>>> daemon)
>>>>> unsetalias [user] unsets an alias for 'user'
>>>>> unsetforwarding [username] removes a forward
>>>>> user [repositoryname] change to another user repository
>>>>> verify [username] verify if specified user exist
>>>>>
>>>>> 7.2. Manage via JMX
>>>>> Launch jconsole (or any other JMX client) and connect on
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>>
>>>>> Step 8: Monitor
>>>>> ##############
>>>>>
>>>>> Monitor the ./log/james-server.log log file.
>>>>> Monitor via JMX (launch any JMX client and connect to
>>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>>
>>>>>
>>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Mohammad Naghavi <mo...@gmail.com>.
Hi there,
I have done some experiments with james 2.3 and now I'm trying to move on to
James 3. the problem is the lack of documentation specially when it comes to
DB configurations. I tried to use the same configs from james 2.3 to run
james 3 with MySql backend but till now I got actually nothing. can any one
point out the points I didn't made right in my config files?
this is my *database.properties *file:
# Use derby as default
database.driverClassName=org.apache.james.util.dbcp.JdbcDataSource
database.url=jdbc:mysql://127.0.0.1/james3test
database.username=myDbUser
database.password=myDbPass
# Supported adapters are:
# DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER,
SYBASE
vendorAdapter.database=MYSQL
# Use streaming for Blobs
# This is only supported on a limited set of databases atm. You should check
if its supported by your DB before enable
# it.
#
# See:
#
http://openjpa.apache.org/builds/latest/docs/manual/ref_guide_mapping_jpa.html
#7.11. LOB Streaming
#
openjpa.streaming=false
but I actually don't know what should I change in *mailstore.xml *to store
the mails inside DB. or where to configure to store users in DB.
Thanks in advance,
Mohammad Naghavi
________________________________________
PHP & ASP .Net 3.5 web developer
Java & C# desktop developer
www.mohamnag.com
On Thu, Nov 11, 2010 at 2:36 PM, Eric Charles <er...@apache.org> wrote:
> Hi Ran,
> That's really great!!!
> If you like, you can add yourself to
> http://wiki.apache.org/james/JamesUsers :) (I still need to link the web
> site to this page...)
>
> I will also publish your notes/ref via Twitter @ApacheJames.
>
> The memory usage should still be lower with M2 tks to optimizations on
> activemq component.
>
> Tks,
>
> Eric
>
>
>
> On 11/11/2010 06:45, RanBing wrote:
>
>> I'm running a very early James 3 on a Linux 64 for mass marketing and the
>> memory stays at 320MB under load.
>>
>> br
>>
>>
>> --------------------------------------------------
>> From: "Eric MacAdie" <er...@MacAdie.net>
>> Sent: Thursday, November 11, 2010 12:29 PM
>> To: "James Users List" <se...@james.apache.org>
>> Subject: Re: Quick Start for 3.0-M2
>>
>> I have a couple of questions:
>>>
>>> 1. One of the requirements is 512 MB of RAM. I am running my site (and a
>>> James server) on a VPS account that has 512 MB RAM total. Is James 3 not an
>>> option for me?
>>>
>>> 2. Are there plans on documenting how to add users to the database? If I
>>> can run James 3 on my VPS, I may be able to help with this. Telnetting into
>>> the remote manager is not something I have any interest in at all.
>>>
>>> Regards,
>>> Eric MacAdie
>>> President, Chicago Java Users Group
>>> http://blog.cjug.org
>>>
>>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>>
>>>> Hi Everyone,
>>>>
>>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>>> The goal of the doc is to allow anyone to start with James binary
>>>> distribution as an operational mail server.
>>>>
>>>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>>>> feedback so we can have the best possible doc for upcoming 3.0-M2 release.
>>>> Tks,
>>>>
>>>> Eric
>>>>
>>>> Step 0: Requirements
>>>> ####################
>>>>
>>>> JRE 1.5+
>>>> root (linux/unix) or Administrator (Windows)
>>>> libc6 (linux)
>>>> 512MB RAM
>>>>
>>>> Step 1: Download
>>>> #################
>>>>
>>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>>
>>>> Step 2: Deploy
>>>> ##############
>>>>
>>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>>> You should have a folder with sub-folders bin, conf, lib, log, var and
>>>> four text files.
>>>>
>>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>>> $ cd james-server-container-spring-3.0-M2
>>>> $ ls -l
>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>>
>>>>
>>>> Step 3: Configure
>>>> #################
>>>>
>>>> All configuration files reside in the conf folder.
>>>>
>>>> $ cd conf
>>>> $ ls -l
>>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>>
>>>>
>>>> James is packaged with virtual hosting disabled, XML domain list, JPA
>>>> (Derby database) storage for the mails and remote delivery from locahost
>>>> only.
>>>> You can edit the following files to change the behaviour:
>>>>
>>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>>
>>>> - Replace the XMLDomainList with the JPADomainList: vi
>>>> usersrepository.xml
>>>> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
>>>> <autodetect>true</autodetect>
>>>> <autodetectIP>true</autodetectIP>
>>>> </domainlist>
>>>>
>>>> - Edit the database.properties and change the values according to your
>>>> database.
>>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>>> folder.
>>>>
>>>> Step 4: Start
>>>> #############
>>>>
>>>> $ cd bin
>>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>>> You can see log result in the log/james-server.log file.
>>>>
>>>> Step 5: Create Domains and Users
>>>> ################################
>>>>
>>>> $ telnet localhost 4555
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> JAMES Remote Administration Tool
>>>> Please enter your login and password
>>>> Login id:
>>>> root
>>>> Password:
>>>> root
>>>> Welcome root. HELP for a list of commands
>>>> adddomain YOUR_DOMAIN
>>>> Adding domain YOUR_DOMAIN successful
>>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>>> User YOUR_NAME@YOUR_DOMAIN added
>>>> quit
>>>> Bye
>>>> Connection closed by foreign host.
>>>>
>>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>>> have a test@localhost.net user.
>>>> The username to use in you mail client will be test@localhost.net.
>>>>
>>>> Step 6: Test
>>>> ############
>>>>
>>>> $ telnet 127.0.0.1 25
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
>>>> 2010 17:31:33 +0100 (CET)
>>>> ehlo test
>>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>>> 250-PIPELINING
>>>> 250-ENHANCEDSTATUSCODES
>>>> 250 8BITMIME
>>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>>> data
>>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>>> subject: test
>>>>
>>>> this is a test
>>>> .
>>>> 250 2.6.0 Message received
>>>> quit
>>>> Connection closed by foreign host.
>>>>
>>>> Step 7: Manage
>>>> ##############
>>>>
>>>> 7.1. Manage via telnet
>>>> $ telnet localhost 4555
>>>> Trying 127.0.0.1...
>>>> Connected to localhost.
>>>> Escape character is '^]'.
>>>> JAMES Remote Administration Tool
>>>> Please enter your login and password
>>>> Login id:
>>>> root
>>>> Password:
>>>> root
>>>> Welcome root. HELP for a list of commands
>>>> help
>>>> adddomain [domainname] add domain to local domains
>>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>>> given emailaddress
>>>> adduser [username] [password] add a new user
>>>> countusers display the number of existing accounts
>>>> deluser [username] delete existing user
>>>> help displays this help
>>>> listallmappings list all mappings
>>>> listdomains list local domains
>>>> listmapping [user@domain] list all mappings for the given
>>>> emailaddress
>>>> listusers display existing accounts
>>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>>> collector get called
>>>> quit close connection
>>>> removedomain [domainname] remove domain from local domains
>>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
>>>> given emailaddress
>>>> setpassword [username] [password] sets a user's password
>>>> showalias [username] shows a user's current email alias
>>>> showforwarding [username] shows a user's current email forwarding
>>>> shutdown kills the current JVM (convenient when James is run as a
>>>> daemon)
>>>> unsetalias [user] unsets an alias for 'user'
>>>> unsetforwarding [username] removes a forward
>>>> user [repositoryname] change to another user repository
>>>> verify [username] verify if specified user exist
>>>>
>>>> 7.2. Manage via JMX
>>>> Launch jconsole (or any other JMX client) and connect on
>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>>
>>>> Step 8: Monitor
>>>> ##############
>>>>
>>>> Monitor the ./log/james-server.log log file.
>>>> Monitor via JMX (launch any JMX client and connect to
>>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>>
>>>>
>>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi Ran,
That's really great!!!
If you like, you can add yourself to
http://wiki.apache.org/james/JamesUsers :) (I still need to link the web
site to this page...)
I will also publish your notes/ref via Twitter @ApacheJames.
The memory usage should still be lower with M2 tks to optimizations on
activemq component.
Tks,
Eric
On 11/11/2010 06:45, RanBing wrote:
> I'm running a very early James 3 on a Linux 64 for mass marketing and
> the memory stays at 320MB under load.
>
> br
>
>
> --------------------------------------------------
> From: "Eric MacAdie" <er...@MacAdie.net>
> Sent: Thursday, November 11, 2010 12:29 PM
> To: "James Users List" <se...@james.apache.org>
> Subject: Re: Quick Start for 3.0-M2
>
>> I have a couple of questions:
>>
>> 1. One of the requirements is 512 MB of RAM. I am running my site
>> (and a James server) on a VPS account that has 512 MB RAM total. Is
>> James 3 not an option for me?
>>
>> 2. Are there plans on documenting how to add users to the database?
>> If I can run James 3 on my VPS, I may be able to help with this.
>> Telnetting into the remote manager is not something I have any
>> interest in at all.
>>
>> Regards,
>> Eric MacAdie
>> President, Chicago Java Users Group
>> http://blog.cjug.org
>>
>> On 11/8/2010 4:21 AM, Eric Charles wrote:
>>> Hi Everyone,
>>>
>>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>>> The goal of the doc is to allow anyone to start with James binary
>>> distribution as an operational mail server.
>>>
>>> Feel free to give it a try (should be valid for 3.0-M1) and send
>>> your feedback so we can have the best possible doc for upcoming
>>> 3.0-M2 release.
>>> Tks,
>>>
>>> Eric
>>>
>>> Step 0: Requirements
>>> ####################
>>>
>>> JRE 1.5+
>>> root (linux/unix) or Administrator (Windows)
>>> libc6 (linux)
>>> 512MB RAM
>>>
>>> Step 1: Download
>>> #################
>>>
>>> Download james-server-container-spring-3.0-M2-bin.zip from
>>> http://james.apache.org/download.cgi#Apache_James_Server
>>>
>>> Step 2: Deploy
>>> ##############
>>>
>>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>>> You should have a folder with sub-folders bin, conf, lib, log, var
>>> and four text files.
>>>
>>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>>> $ cd james-server-container-spring-3.0-M2
>>> $ ls -l
>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>>
>>>
>>> Step 3: Configure
>>> #################
>>>
>>> All configuration files reside in the conf folder.
>>>
>>> $ cd conf
>>> $ ls -l
>>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>>
>>>
>>> James is packaged with virtual hosting disabled, XML domain list,
>>> JPA (Derby database) storage for the mails and remote delivery from
>>> locahost only.
>>> You can edit the following files to change the behaviour:
>>>
>>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>>> <enableVirtualHosting> true </enableVirtualHosting>
>>>
>>> - Replace the XMLDomainList with the JPADomainList: vi
>>> usersrepository.xml
>>> <domainlist
>>> class="org.apache.james.domainlist.jpa.JPADomainList">
>>> <autodetect>true</autodetect>
>>> <autodetectIP>true</autodetectIP>
>>> </domainlist>
>>>
>>> - Edit the database.properties and change the values according to
>>> your database.
>>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>>> folder.
>>>
>>> Step 4: Start
>>> #############
>>>
>>> $ cd bin
>>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>>> install libc6-i386 libc6-dev-i386 on ubuntu)
>>> You can see log result in the log/james-server.log file.
>>>
>>> Step 5: Create Domains and Users
>>> ################################
>>>
>>> $ telnet localhost 4555
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> JAMES Remote Administration Tool
>>> Please enter your login and password
>>> Login id:
>>> root
>>> Password:
>>> root
>>> Welcome root. HELP for a list of commands
>>> adddomain YOUR_DOMAIN
>>> Adding domain YOUR_DOMAIN successful
>>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>>> User YOUR_NAME@YOUR_DOMAIN added
>>> quit
>>> Bye
>>> Connection closed by foreign host.
>>>
>>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>>> have a test@localhost.net user.
>>> The username to use in you mail client will be test@localhost.net.
>>>
>>> Step 6: Test
>>> ############
>>>
>>> $ telnet 127.0.0.1 25
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>>> Nov 2010 17:31:33 +0100 (CET)
>>> ehlo test
>>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>>> 250-PIPELINING
>>> 250-ENHANCEDSTATUSCODES
>>> 250 8BITMIME
>>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>>> data
>>> 354 Ok Send data ending with <CRLF>.<CRLF>
>>> subject: test
>>>
>>> this is a test
>>> .
>>> 250 2.6.0 Message received
>>> quit
>>> Connection closed by foreign host.
>>>
>>> Step 7: Manage
>>> ##############
>>>
>>> 7.1. Manage via telnet
>>> $ telnet localhost 4555
>>> Trying 127.0.0.1...
>>> Connected to localhost.
>>> Escape character is '^]'.
>>> JAMES Remote Administration Tool
>>> Please enter your login and password
>>> Login id:
>>> root
>>> Password:
>>> root
>>> Welcome root. HELP for a list of commands
>>> help
>>> adddomain [domainname] add domain to local domains
>>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>>> given emailaddress
>>> adduser [username] [password] add a new user
>>> countusers display the number of existing accounts
>>> deluser [username] delete existing user
>>> help displays this help
>>> listallmappings list all mappings
>>> listdomains list local domains
>>> listmapping [user@domain] list all mappings for the given
>>> emailaddress
>>> listusers display existing accounts
>>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>>> collector get called
>>> quit close connection
>>> removedomain [domainname] remove domain from local domains
>>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>>> the given emailaddress
>>> setpassword [username] [password] sets a user's password
>>> showalias [username] shows a user's current email alias
>>> showforwarding [username] shows a user's current email forwarding
>>> shutdown kills the current JVM (convenient when James is run
>>> as a daemon)
>>> unsetalias [user] unsets an alias for 'user'
>>> unsetforwarding [username] removes a forward
>>> user [repositoryname] change to another user repository
>>> verify [username] verify if specified user exist
>>>
>>> 7.2. Manage via JMX
>>> Launch jconsole (or any other JMX client) and connect on
>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>>
>>> Step 8: Monitor
>>> ##############
>>>
>>> Monitor the ./log/james-server.log log file.
>>> Monitor via JMX (launch any JMX client and connect to
>>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>>> For additional commands, e-mail: server-user-help@james.apache.org
>>>
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by RanBing <bi...@hotmail.com>.
I'm running a very early James 3 on a Linux 64 for mass marketing and the
memory stays at 320MB under load.
br
--------------------------------------------------
From: "Eric MacAdie" <er...@MacAdie.net>
Sent: Thursday, November 11, 2010 12:29 PM
To: "James Users List" <se...@james.apache.org>
Subject: Re: Quick Start for 3.0-M2
> I have a couple of questions:
>
> 1. One of the requirements is 512 MB of RAM. I am running my site (and a
> James server) on a VPS account that has 512 MB RAM total. Is James 3 not
> an option for me?
>
> 2. Are there plans on documenting how to add users to the database? If I
> can run James 3 on my VPS, I may be able to help with this. Telnetting
> into the remote manager is not something I have any interest in at all.
>
> Regards,
> Eric MacAdie
> President, Chicago Java Users Group
> http://blog.cjug.org
>
> On 11/8/2010 4:21 AM, Eric Charles wrote:
>> Hi Everyone,
>>
>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>> The goal of the doc is to allow anyone to start with James binary
>> distribution as an operational mail server.
>>
>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>> feedback so we can have the best possible doc for upcoming 3.0-M2
>> release.
>> Tks,
>>
>> Eric
>>
>> Step 0: Requirements
>> ####################
>>
>> JRE 1.5+
>> root (linux/unix) or Administrator (Windows)
>> libc6 (linux)
>> 512MB RAM
>>
>> Step 1: Download
>> #################
>>
>> Download james-server-container-spring-3.0-M2-bin.zip from
>> http://james.apache.org/download.cgi#Apache_James_Server
>>
>> Step 2: Deploy
>> ##############
>>
>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>> You should have a folder with sub-folders bin, conf, lib, log, var and
>> four text files.
>>
>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>> $ cd james-server-container-spring-3.0-M2
>> $ ls -l
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>
>>
>> Step 3: Configure
>> #################
>>
>> All configuration files reside in the conf folder.
>>
>> $ cd conf
>> $ ls -l
>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>
>>
>> James is packaged with virtual hosting disabled, XML domain list, JPA
>> (Derby database) storage for the mails and remote delivery from locahost
>> only.
>> You can edit the following files to change the behaviour:
>>
>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>> <enableVirtualHosting> true </enableVirtualHosting>
>>
>> - Replace the XMLDomainList with the JPADomainList: vi
>> usersrepository.xml
>> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
>> <autodetect>true</autodetect>
>> <autodetectIP>true</autodetectIP>
>> </domainlist>
>>
>> - Edit the database.properties and change the values according to your
>> database.
>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>> folder.
>>
>> Step 4: Start
>> #############
>>
>> $ cd bin
>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>> install libc6-i386 libc6-dev-i386 on ubuntu)
>> You can see log result in the log/james-server.log file.
>>
>> Step 5: Create Domains and Users
>> ################################
>>
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> adddomain YOUR_DOMAIN
>> Adding domain YOUR_DOMAIN successful
>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>> User YOUR_NAME@YOUR_DOMAIN added
>> quit
>> Bye
>> Connection closed by foreign host.
>>
>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will have
>> a test@localhost.net user.
>> The username to use in you mail client will be test@localhost.net.
>>
>> Step 6: Test
>> ############
>>
>> $ telnet 127.0.0.1 25
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
>> 2010 17:31:33 +0100 (CET)
>> ehlo test
>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>> 250-PIPELINING
>> 250-ENHANCEDSTATUSCODES
>> 250 8BITMIME
>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>> data
>> 354 Ok Send data ending with <CRLF>.<CRLF>
>> subject: test
>>
>> this is a test
>> .
>> 250 2.6.0 Message received
>> quit
>> Connection closed by foreign host.
>>
>> Step 7: Manage
>> ##############
>>
>> 7.1. Manage via telnet
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> help
>> adddomain [domainname] add domain to local domains
>> addmapping [toUser@toDomain] [fromMapping] add mapping for the given
>> emailaddress
>> adduser [username] [password] add a new user
>> countusers display the number of existing accounts
>> deluser [username] delete existing user
>> help displays this help
>> listallmappings list all mappings
>> listdomains list local domains
>> listmapping [user@domain] list all mappings for the given
>> emailaddress
>> listusers display existing accounts
>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>> collector get called
>> quit close connection
>> removedomain [domainname] remove domain from local domains
>> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
>> given emailaddress
>> setpassword [username] [password] sets a user's password
>> showalias [username] shows a user's current email alias
>> showforwarding [username] shows a user's current email forwarding
>> shutdown kills the current JVM (convenient when James is run as a
>> daemon)
>> unsetalias [user] unsets an alias for 'user'
>> unsetforwarding [username] removes a forward
>> user [repositoryname] change to another user repository
>> verify [username] verify if specified user exist
>>
>> 7.2. Manage via JMX
>> Launch jconsole (or any other JMX client) and connect on
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>
>> Step 8: Monitor
>> ##############
>>
>> Monitor the ./log/james-server.log log file.
>> Monitor via JMX (launch any JMX client and connect to
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric MacAdie <er...@MacAdie.net>.
I have a couple of questions:
1. One of the requirements is 512 MB of RAM. I am running my site (and a
James server) on a VPS account that has 512 MB RAM total. Is James 3 not
an option for me?
2. Are there plans on documenting how to add users to the database? If I
can run James 3 on my VPS, I may be able to help with this. Telnetting
into the remote manager is not something I have any interest in at all.
Regards,
Eric MacAdie
President, Chicago Java Users Group
http://blog.cjug.org
On 11/8/2010 4:21 AM, Eric Charles wrote:
> Hi Everyone,
>
> I tried to make a short (though complete) quick start doc for 3.0-M2.
> The goal of the doc is to allow anyone to start with James binary
> distribution as an operational mail server.
>
> Feel free to give it a try (should be valid for 3.0-M1) and send your
> feedback so we can have the best possible doc for upcoming 3.0-M2
> release.
> Tks,
>
> Eric
>
> Step 0: Requirements
> ####################
>
> JRE 1.5+
> root (linux/unix) or Administrator (Windows)
> libc6 (linux)
> 512MB RAM
>
> Step 1: Download
> #################
>
> Download james-server-container-spring-3.0-M2-bin.zip from
> http://james.apache.org/download.cgi#Apache_James_Server
>
> Step 2: Deploy
> ##############
>
> Unzip james-server-container-spring-3.0-M2-bin.zip.
> You should have a folder with sub-folders bin, conf, lib, log, var and
> four text files.
>
> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
> $ cd james-server-container-spring-3.0-M2
> $ ls -l
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>
>
> Step 3: Configure
> #################
>
> All configuration files reside in the conf folder.
>
> $ cd conf
> $ ls -l
> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>
>
> James is packaged with virtual hosting disabled, XML domain list, JPA
> (Derby database) storage for the mails and remote delivery from
> locahost only.
> You can edit the following files to change the behaviour:
>
> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
> <enableVirtualHosting> true </enableVirtualHosting>
>
> - Replace the XMLDomainList with the JPADomainList: vi
> usersrepository.xml
> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
> <autodetect>true</autodetect>
> <autodetectIP>true</autodetectIP>
> </domainlist>
>
> - Edit the database.properties and change the values according to your
> database.
> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
> folder.
>
> Step 4: Start
> #############
>
> $ cd bin
> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
> install libc6-i386 libc6-dev-i386 on ubuntu)
> You can see log result in the log/james-server.log file.
>
> Step 5: Create Domains and Users
> ################################
>
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> adddomain YOUR_DOMAIN
> Adding domain YOUR_DOMAIN successful
> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
> User YOUR_NAME@YOUR_DOMAIN added
> quit
> Bye
> Connection closed by foreign host.
>
> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
> have a test@localhost.net user.
> The username to use in you mail client will be test@localhost.net.
>
> Step 6: Test
> ############
>
> $ telnet 127.0.0.1 25
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
> Nov 2010 17:31:33 +0100 (CET)
> ehlo test
> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
> 250-PIPELINING
> 250-ENHANCEDSTATUSCODES
> 250 8BITMIME
> mail from:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
> data
> 354 Ok Send data ending with <CRLF>.<CRLF>
> subject: test
>
> this is a test
> .
> 250 2.6.0 Message received
> quit
> Connection closed by foreign host.
>
> Step 7: Manage
> ##############
>
> 7.1. Manage via telnet
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> help
> adddomain [domainname] add domain to local domains
> addmapping [toUser@toDomain] [fromMapping] add mapping for the
> given emailaddress
> adduser [username] [password] add a new user
> countusers display the number of existing accounts
> deluser [username] delete existing user
> help displays this help
> listallmappings list all mappings
> listdomains list local domains
> listmapping [user@domain] list all mappings for the given
> emailaddress
> listusers display existing accounts
> memstat ([-gc]) shows memory usage. When called with -gc the garbage
> collector get called
> quit close connection
> removedomain [domainname] remove domain from local domains
> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
> given emailaddress
> setpassword [username] [password] sets a user's password
> showalias [username] shows a user's current email alias
> showforwarding [username] shows a user's current email forwarding
> shutdown kills the current JVM (convenient when James is run as
> a daemon)
> unsetalias [user] unsets an alias for 'user'
> unsetforwarding [username] removes a forward
> user [repositoryname] change to another user repository
> verify [username] verify if specified user exist
>
> 7.2. Manage via JMX
> Launch jconsole (or any other JMX client) and connect on
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>
> Step 8: Monitor
> ##############
>
> Monitor the ./log/james-server.log log file.
> Monitor via JMX (launch any JMX client and connect to
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Eric Charles <er...@apache.org>.
Hi Gerry,
Many tks for your reply.
Could you send me to my email the pdf (it is removed by ml).
Yes, I will make it less platform dependent, just as java tries to be :)
For the settings:
- We have cleaned the conf files so M2 (and future) will have less
verbose files (https://issues.apache.org/jira/browse/JAMES-1079).
- The quick start is just to allow users to get up-and-running with
james. The fine-tuning of conf should be part of user manual
- You're right to point important matters around Bounce,
NotifyPostmaster,... For that (the default conf to be packaged), there
is https://issues.apache.org/jira/browse/JAMES-1124 where we can record
what should be done. Could you please replay your comments on this JIRA
(simply create an account and comment the JIRA). On my side, I may for
example prefer to silently drop address errors to not give information
to spammers (to be discussed).
Tks,
Eric
On 11/11/2010 05:14, Gerry Matte wrote:
> Hello Eric.
> Your November 8 Quickstart notes did not provide any instructions for
> Microsoft Windows users.
> In the attached PDF and text files, I suggest some added text for
> those folks. The PDF file shows the additions in yellow highlighting.
> The text file is the fulltext version of the PDF.
>
> Consider removing the list of files contained in the bin and conf
> folders - or list the files with the ls parameters that only shows the
> names of the files (without file attributes or timestamps, etc). The
> unix file list may be confusing to windows users.
>
> I also suggest that in mailetcontainer.xml lines 586, the default
> setting for mailet Bounce should be to notify the sender if a received
> email is in error and is undeliverable. Even more importantly at line
> 593, the mailet NotifyPostmaster should not be commented out so that
> the postmaster is advised if undeliverable emails are received. These
> two changes will alert james administrators if a configuration error
> exists - currently the received emails just silently disappear. I
> spent a lot of time adjusting router settings and windows firewall
> settings before noticing that the emails were being treated as
> address-errors. If invalid emails had bounced to the sender or the
> postmaster I would have looked at the james config files right away.
>
> Thanks
> Gerry
> --------------------------------------------------
> From: "Eric Charles" <er...@apache.org>
> Sent: Monday, November 08, 2010 2:21 AM
> To: "James Users List" <se...@james.apache.org>
> Subject: Quick Start for 3.0-M2
>
>> Hi Everyone,
>>
>> I tried to make a short (though complete) quick start doc for 3.0-M2.
>> The goal of the doc is to allow anyone to start with James binary
>> distribution as an operational mail server.
>>
>> Feel free to give it a try (should be valid for 3.0-M1) and send your
>> feedback so we can have the best possible doc for upcoming 3.0-M2
>> release.
>> Tks,
>>
>> Eric
>>
>> Step 0: Requirements
>> ####################
>>
>> JRE 1.5+
>> root (linux/unix) or Administrator (Windows)
>> libc6 (linux)
>> 512MB RAM
>>
>> Step 1: Download
>> #################
>>
>> Download james-server-container-spring-3.0-M2-bin.zip from
>> http://james.apache.org/download.cgi#Apache_James_Server
>>
>> Step 2: Deploy
>> ##############
>>
>> Unzip james-server-container-spring-3.0-M2-bin.zip.
>> You should have a folder with sub-folders bin, conf, lib, log, var
>> and four text files.
>>
>> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
>> $ cd james-server-container-spring-3.0-M2
>> $ ls -l
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
>> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
>> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
>> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
>> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
>> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
>> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
>> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
>> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>>
>>
>> Step 3: Configure
>> #################
>>
>> All configuration files reside in the conf folder.
>>
>> $ cd conf
>> $ ls -l
>> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
>> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
>> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
>> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
>> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
>> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
>> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
>> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
>> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
>> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
>> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
>> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
>> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
>> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
>> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
>> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
>> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
>> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
>> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
>> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
>> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
>> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
>> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
>> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>>
>>
>> James is packaged with virtual hosting disabled, XML domain list, JPA
>> (Derby database) storage for the mails and remote delivery from
>> locahost only.
>> You can edit the following files to change the behaviour:
>>
>> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
>> <enableVirtualHosting> true </enableVirtualHosting>
>>
>> - Replace the XMLDomainList with the JPADomainList: vi
>> usersrepository.xml
>> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
>> <autodetect>true</autodetect>
>> <autodetectIP>true</autodetectIP>
>> </domainlist>
>>
>> - Edit the database.properties and change the values according to
>> your database.
>> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
>> folder.
>>
>> Step 4: Start
>> #############
>>
>> $ cd bin
>> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
>> install libc6-i386 libc6-dev-i386 on ubuntu)
>> You can see log result in the log/james-server.log file.
>>
>> Step 5: Create Domains and Users
>> ################################
>>
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> adddomain YOUR_DOMAIN
>> Adding domain YOUR_DOMAIN successful
>> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
>> User YOUR_NAME@YOUR_DOMAIN added
>> quit
>> Bye
>> Connection closed by foreign host.
>>
>> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will
>> have a test@localhost.net user.
>> The username to use in you mail client will be test@localhost.net.
>>
>> Step 6: Test
>> ############
>>
>> $ telnet 127.0.0.1 25
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6
>> Nov 2010 17:31:33 +0100 (CET)
>> ehlo test
>> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
>> 250-PIPELINING
>> 250-ENHANCEDSTATUSCODES
>> 250 8BITMIME
>> mail from:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
>> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
>> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
>> data
>> 354 Ok Send data ending with <CRLF>.<CRLF>
>> subject: test
>>
>> this is a test
>> .
>> 250 2.6.0 Message received
>> quit
>> Connection closed by foreign host.
>>
>> Step 7: Manage
>> ##############
>>
>> 7.1. Manage via telnet
>> $ telnet localhost 4555
>> Trying 127.0.0.1...
>> Connected to localhost.
>> Escape character is '^]'.
>> JAMES Remote Administration Tool
>> Please enter your login and password
>> Login id:
>> root
>> Password:
>> root
>> Welcome root. HELP for a list of commands
>> help
>> adddomain [domainname] add domain to local domains
>> addmapping [toUser@toDomain] [fromMapping] add mapping for the
>> given emailaddress
>> adduser [username] [password] add a new user
>> countusers display the number of existing accounts
>> deluser [username] delete existing user
>> help displays this help
>> listallmappings list all mappings
>> listdomains list local domains
>> listmapping [user@domain] list all mappings for the given
>> emailaddress
>> listusers display existing accounts
>> memstat ([-gc]) shows memory usage. When called with -gc the garbage
>> collector get called
>> quit close connection
>> removedomain [domainname] remove domain from local domains
>> removemapping [toUser@toDomain] [fromMapping] remove mapping for
>> the given emailaddress
>> setpassword [username] [password] sets a user's password
>> showalias [username] shows a user's current email alias
>> showforwarding [username] shows a user's current email forwarding
>> shutdown kills the current JVM (convenient when James is run
>> as a daemon)
>> unsetalias [user] unsets an alias for 'user'
>> unsetforwarding [username] removes a forward
>> user [repositoryname] change to another user repository
>> verify [username] verify if specified user exist
>>
>> 7.2. Manage via JMX
>> Launch jconsole (or any other JMX client) and connect on
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>>
>> Step 8: Monitor
>> ##############
>>
>> Monitor the ./log/james-server.log log file.
>> Monitor via JMX (launch any JMX client and connect to
>> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
> Step 0: Requirements
> ####################
>
> JRE 1.5+
> root (linux/unix) or Administrator (Windows)
> libc6 (linux)
> 512MB RAM
>
> Step 1: Download
> #################
>
> Download james-server-container-spring-3.0-M2-bin.zip from
> http://james.apache.org/download.cgi#Apache_James_Server
>
> Step 2: Deploy
> ##############
>
> Unzip james-server-container-spring-3.0-M2-bin.zip.
> You should have a folder with sub-folders bin, conf, lib, log, var and
> four text files.
>
> Unix:
> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
> $ cd james-server-container-spring-3.0-M2
> $ ls -l
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>
>
> Step 3: Configure
> #################
>
> All configuration files reside in the conf folder.
>
> $ cd conf
> $ ls -l
> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>
>
> James is packaged with virtual hosting disabled, XML domain list, JPA
> (Derby database) storage for the mails and remote delivery from localhost
> only.
> You can edit the following files to change the behaviour:
>
> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
> <enableVirtualHosting> true </enableVirtualHosting>
>
> - Replace the XMLDomainList with the JPADomainList: vi
> usersrepository.xml
> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
> <autodetect>true</autodetect>
> <autodetectIP>true</autodetectIP>
> </domainlist>
>
> - Edit the database.properties and change the values according to your
> database.
> - Don't forget to add the needed JDBC driver jar in the ./conf/lib
> folder.
>
> On Windows:
> You should execute run.bat from a DOS command window to ensure that james
> starts up without errors. If you see the error message "Error: Password
> file read access must be restricted: ../conf/jmx.password" then will
> need to
> modify the file permissions on two JMX related files in the CONF
> folder --
> jmx.access and jmx.properties. The file security procedure to follow is
> documented at
> http://download.oracle.com/javase/1.5.0/docs/guide/management/security-windo
>
> ws.html. See the next paragraph before following this procedure.
>
> If you intend to run james as a windows service, you must create a
> windows
> userid and password under which the service will run (this is the
> recommended practice but is a required practice for the Apache James
> Service
> because that userid/password must be designated as the file owners for
> the
> two jmx control files noted in the previous paragraph. For example, you
> might create a userid james3 with password james3 and use those
> credentials
> and the file security procedure noted above -- making userid james3 the
> official owner of files jmx.access and jmx.password. Do NOT keep any
> rights
> for the Administrator group -- only the james3 userid should have any
> rights
> and that id should have full rights.
>
> After following this procedure, execute run.bat and the error message
> "Password file read access must be restricted:" should no longer appear.
> Use Control-C to shutdown james when started using run.bat
>
> To create the Apache James Service on windows, execute "james.bat
> install".
> Then open the windows service manager, right-click the service "Apache
> James
> Server Container Spring" and select properties. Click the "logon" tab
> and
> click the radio button beside "This Account". Enter the james3 userid
> and
> password (you may need to enter the userid as ".\james3" if you are not
> using a domain controller). When you click ok you should see a popup
> window
> stating that james3 has been granted the "RunAsService" right.
>
> Step 4: Start
> #############
>
> Unix:
> $ cd bin
> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
> install libc6-i386 libc6-dev-i386 on ubuntu)
> You can see log result in the log/james-server.log file.
>
> Windows:
> Start the Apache James Service using the Windows service manager. Select
> the service, right-click and select start. Or, open a DOS window and
> execute "james start".
>
> Step 5: Create Domains and Users
> ################################
>
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> adddomain YOUR_DOMAIN
> Adding domain YOUR_DOMAIN successful
> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
> User YOUR_NAME@YOUR_DOMAIN added
> quit
> Bye
> Connection closed by foreign host.
>
> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will have
> a test@localhost.net user.
> The username to use in your mail client will be test@localhost.net.
>
> Step 6: Test
> ############
>
> $ telnet 127.0.0.1 25
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
> 2010 17:31:33 +0100 (CET)
> ehlo test
> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
> 250-PIPELINING
> 250-ENHANCEDSTATUSCODES
> 250 8BITMIME
> mail from:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
> data
> 354 Ok Send data ending with <CRLF>.<CRLF>
> subject: test
>
> this is a test
> .
> 250 2.6.0 Message received
> quit
> Connection closed by foreign host.
>
> Step 7: Manage
> ##############
>
> 7.1. Manage via telnet
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> help
> adddomain [domainname] add domain to local domains
> addmapping [toUser@toDomain] [fromMapping] add mapping for the
> given emailaddress
> adduser [username] [password] add a new user
> countusers display the number of existing accounts
> deluser [username] delete existing user
> help displays this help
> listallmappings list all mappings
> listdomains list local domains
> listmapping [user@domain] list all mappings for the given
> emailaddress
> listusers display existing accounts
> memstat ([-gc]) shows memory usage. When called with -gc the garbage
> collector get called
> quit close connection
> removedomain [domainname] remove domain from local domains
> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
> given emailaddress
> setpassword [username] [password] sets a user's password
> showalias [username] shows a user's current email alias
> showforwarding [username] shows a user's current email forwarding
> shutdown kills the current JVM (convenient when James is run as a
> daemon)
> unsetalias [user] unsets an alias for 'user'
> unsetforwarding [username] removes a forward
> user [repositoryname] change to another user repository
> verify [username] verify if specified user exist
>
> 7.2. Manage via JMX
> Launch jconsole (or any other JMX client) and connect on
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>
> Step 8: Monitor
> ##############
>
> Monitor the ./log/james-server.log log file.
> Monitor via JMX (launch any JMX client and connect to
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
Re: Quick Start for 3.0-M2
Posted by Gerry Matte <Ge...@shaw.ca>.
Hello Eric.
Your November 8 Quickstart notes did not provide any instructions for
Microsoft Windows users.
In the attached PDF and text files, I suggest some added text for those
folks. The PDF file shows the additions in yellow highlighting.
The text file is the fulltext version of the PDF.
Consider removing the list of files contained in the bin and conf folders -
or list the files with the ls parameters that only shows the names of the
files (without file attributes or timestamps, etc). The unix file list may
be confusing to windows users.
I also suggest that in mailetcontainer.xml lines 586, the default setting
for mailet Bounce should be to notify the sender if a received email is in
error and is undeliverable. Even more importantly at line 593, the mailet
NotifyPostmaster should not be commented out so that the postmaster is
advised if undeliverable emails are received. These two changes will alert
james administrators if a configuration error exists - currently the
received emails just silently disappear. I spent a lot of time adjusting
router settings and windows firewall settings before noticing that the
emails were being treated as address-errors. If invalid emails had bounced
to the sender or the postmaster I would have looked at the james config
files right away.
Thanks
Gerry
--------------------------------------------------
From: "Eric Charles" <er...@apache.org>
Sent: Monday, November 08, 2010 2:21 AM
To: "James Users List" <se...@james.apache.org>
Subject: Quick Start for 3.0-M2
> Hi Everyone,
>
> I tried to make a short (though complete) quick start doc for 3.0-M2.
> The goal of the doc is to allow anyone to start with James binary
> distribution as an operational mail server.
>
> Feel free to give it a try (should be valid for 3.0-M1) and send your
> feedback so we can have the best possible doc for upcoming 3.0-M2 release.
> Tks,
>
> Eric
>
> Step 0: Requirements
> ####################
>
> JRE 1.5+
> root (linux/unix) or Administrator (Windows)
> libc6 (linux)
> 512MB RAM
>
> Step 1: Download
> #################
>
> Download james-server-container-spring-3.0-M2-bin.zip from
> http://james.apache.org/download.cgi#Apache_James_Server
>
> Step 2: Deploy
> ##############
>
> Unzip james-server-container-spring-3.0-M2-bin.zip.
> You should have a folder with sub-folders bin, conf, lib, log, var and
> four text files.
>
> $ unzip james-server-container-spring-3.0-M2-bin.tar.gz
> $ cd james-server-container-spring-3.0-M2
> $ ls -l
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 bin
> -rw-r--r--. 1 root root 495 2010-11-06 08:56 BUILD.txt
> drwxrwxrwx. 4 root root 4096 2010-11-06 14:43 conf
> drwxrwxrwx. 2 root root 12288 2010-11-06 09:01 lib
> -rw-r--r--. 1 root root 12082 2010-11-01 17:23 LICENSE.txt
> drwxrwxrwx. 2 root root 4096 2010-11-06 09:24 log
> -rw-r--r--. 1 root root 1579 2010-11-01 17:23 NOTICE.txt
> -rw-r--r--. 1 root root 1545 2010-11-06 08:55 README.txt
> drwxrwxrwx. 6 root root 4096 2010-11-06 09:25 var
>
>
> Step 3: Configure
> #################
>
> All configuration files reside in the conf folder.
>
> $ cd conf
> $ ls -l
> -rw-------. 1 root root 1414 2010-11-05 16:01 database.properties
> -rw-------. 1 root root 2749 2010-10-21 14:07 dnsservice.xml
> -rw-------. 1 root root 2802 2010-11-06 09:22 domainlist.xml
> -rw-------. 1 root root 18599 2010-10-21 14:07 fetchmail.xml
> -rw-------. 1 root root 3201 2010-10-21 14:07 imapserver.xml
> -rw-------. 1 root root 2850 2010-11-04 08:10 james-listmanager.xml
> -rw-------. 1 root root 5821 2010-10-21 14:07 jcr-repository.xml
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.access
> -rw-------. 1 root root 0 2010-11-05 16:01 jmx.password
> -rw-------. 1 root root 961 2010-11-06 08:42 jmx.properties
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 lib
> -rw-------. 1 root root 3129 2010-10-21 14:07 lmtpserver.xml
> -rw-------. 1 root root 7463 2010-11-05 15:54 log4j.properties
> -rw-------. 1 root root 31478 2010-11-06 09:22 mailetcontainer.xml
> -rw-------. 1 root root 2473 2010-11-06 09:22 mailserver.xml
> -rw-------. 1 root root 5234 2010-10-21 14:54 mailstore.xml
> drwxrwxrwx. 2 root root 4096 2010-10-21 14:07 META-INF
> -rw-------. 1 root root 8038 2010-10-21 14:07 miResources.xml
> -rw-------. 1 root root 3327 2010-10-21 14:07 pop3server.xml
> -rw-------. 1 root root 3369 2010-10-21 14:07 remotemanager.xml
> -rw-------. 1 root root 15837 2010-11-05 15:54 smtpserver.xml
> -rw-------. 1 root root 21941 2010-11-05 16:01 spring-beans.xml
> -rw-------. 1 root root 48523 2010-10-21 14:07 sqlResources.xml
> -rw-------. 1 root root 4301 2010-10-29 15:48 usersrepository.xml
> -rw-------. 1 root root 2465 2010-10-21 14:07 virtualusertable.xml
> -rw-------. 1 root root 13680 2010-11-06 09:01 wrapper.conf
>
>
> James is packaged with virtual hosting disabled, XML domain list, JPA
> (Derby database) storage for the mails and remote delivery from locahost
> only.
> You can edit the following files to change the behaviour:
>
> - Enable virtual hosting in mailserver.xml: vi mailserver.xml
> <enableVirtualHosting> true </enableVirtualHosting>
>
> - Replace the XMLDomainList with the JPADomainList: vi usersrepository.xml
> <domainlist class="org.apache.james.domainlist.jpa.JPADomainList">
> <autodetect>true</autodetect>
> <autodetectIP>true</autodetectIP>
> </domainlist>
>
> - Edit the database.properties and change the values according to your
> database.
> - Don't forget to add the needed JDBC driver jar in the ./conf/lib folder.
>
> Step 4: Start
> #############
>
> $ cd bin
> $ ./james start (!! you need libc6 installed on Linux - sudo apt-get
> install libc6-i386 libc6-dev-i386 on ubuntu)
> You can see log result in the log/james-server.log file.
>
> Step 5: Create Domains and Users
> ################################
>
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> adddomain YOUR_DOMAIN
> Adding domain YOUR_DOMAIN successful
> adduser YOUR_NAME@YOUR_DOMAIN YOUR_PASSWORD
> User YOUR_NAME@YOUR_DOMAIN added
> quit
> Bye
> Connection closed by foreign host.
>
> For example, YOUR_DOMAIN=localhost.net, YOUR_NAME=test, so you will have a
> test@localhost.net user.
> The username to use in you mail client will be test@localhost.net.
>
> Step 6: Test
> ############
>
> $ telnet 127.0.0.1 25
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> 220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0-M2) ready Sat, 6 Nov
> 2010 17:31:33 +0100 (CET)
> ehlo test
> 250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
> 250-PIPELINING
> 250-ENHANCEDSTATUSCODES
> 250 8BITMIME
> mail from:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
> rcpt to:<YOUR_NAME@YOUR_DOMAIN>
> 250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
> data
> 354 Ok Send data ending with <CRLF>.<CRLF>
> subject: test
>
> this is a test
> .
> 250 2.6.0 Message received
> quit
> Connection closed by foreign host.
>
> Step 7: Manage
> ##############
>
> 7.1. Manage via telnet
> $ telnet localhost 4555
> Trying 127.0.0.1...
> Connected to localhost.
> Escape character is '^]'.
> JAMES Remote Administration Tool
> Please enter your login and password
> Login id:
> root
> Password:
> root
> Welcome root. HELP for a list of commands
> help
> adddomain [domainname] add domain to local domains
> addmapping [toUser@toDomain] [fromMapping] add mapping for the given
> emailaddress
> adduser [username] [password] add a new user
> countusers display the number of existing accounts
> deluser [username] delete existing user
> help displays this help
> listallmappings list all mappings
> listdomains list local domains
> listmapping [user@domain] list all mappings for the given
> emailaddress
> listusers display existing accounts
> memstat ([-gc]) shows memory usage. When called with -gc the garbage
> collector get called
> quit close connection
> removedomain [domainname] remove domain from local domains
> removemapping [toUser@toDomain] [fromMapping] remove mapping for the
> given emailaddress
> setpassword [username] [password] sets a user's password
> showalias [username] shows a user's current email alias
> showforwarding [username] shows a user's current email forwarding
> shutdown kills the current JVM (convenient when James is run as a
> daemon)
> unsetalias [user] unsets an alias for 'user'
> unsetforwarding [username] removes a forward
> user [repositoryname] change to another user repository
> verify [username] verify if specified user exist
>
> 7.2. Manage via JMX
> Launch jconsole (or any other JMX client) and connect on
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
>
> Step 8: Monitor
> ##############
>
> Monitor the ./log/james-server.log log file.
> Monitor via JMX (launch any JMX client and connect to
> URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>