Installing James 2.1.3

Installing James 2.1.3

Information:
none

Operating system used:
Windows XP Home Edition Version 5.1 SP 2

Software prerequisites:
Java 2 Standard Edition (J2SE) SDK, version 1.3 or higher.

Note: If J2SE SDK 1.4.x is installed, please remove xerces.jar from Phoenix's lib dir. This is because J2SE SDK 1.4.x comes with xerces, and Phoenix may object to two versions in the classpath.

Procedure:

1. Download and unzip james-2.1.3.zip
e.g.: C:\Tools\james-2.1.3

2. For security reasons change the root username and password:
cd C:\Tools\james-2.1.3\apps\james\SAR-INF

3. Edit config.xml. Change the following:

into (this is an example)


4. To execute James, enter command:
C:\Tools\james-2.1.3\bin run.bat

You should see:
Using PHOENIX_HOME: C:\Tools\james-2.1.3
Using PHOENIX_TMPDIR: C:\Tools\james-2.1.3\temp
Using JAVA_HOME: C:\Tools\java\j2sdk1.4.2_01

Phoenix 4.0.1

James 2.1.3
Remote Manager Service started plain:4555
POP3 Service started plain:110
SMTP Service started plain:25
NNTP Service started plain:119
Fetch POP Disabled

5. James should be configured by first adding users, to do this telnet to port 4555:
telnet 127.0.0.1 4555

You should see:
JAMES Remote Administration Tool 2.1.3
Please enter your login and password
Login id:

6. Use the previously changed root username (e.g.: jamesroot) and password (e.g.: jamesmysecret) to log in. Once logged in, you should see:
Welcome root. HELP for a list of commands

Note: If you type help, you will get the following list of commands:

command Description
help Display this help.
listusers Display existing accounts
countusers Display the number of existing accounts.
adduser [username] [password] Add a new user.
verify [username] Verify if specified user exist.
deluser [username] Delete existing user.
setpassword [username] [password] Sets a user's password.
setalias [alias] [user] Locally forwards all email for 'alias' to 'user'
unsetalias [alias] Unsets an alias.
setforwarding [username] [emailaddress] Forwards a user's email to another email address.
unsetforwarding [username] Removes a forward.
user [repositoryname] Change to another user repository.
shutdown Kills the current JVM (convenient when James is run as a daemon).
quit Close connection.


7. To add a new user, type: adduser mailuser mymailsecret

8. Test James by sending emails to the previously added users.

Note: All emails received by James can be found in:
C:\Tools\james-2.1.3\apps\james\var\mail\inboxes.

9. To setup James as a windows service:
C:\Tools\james-2.1.3\bin>wrapper -i ..\conf\wrapper.conf

you should see:
wrapper | James Mail Server 2.1 installed.

To remove James as a windows service:
C:\Tools\james-2.1.3\bin>wrapper -r ..\conf\wrapper.conf

you should see:
wrapper | Service is running. Stopping it...
wrapper | Waiting to stop...
wrapper | James Mail Server 2.1 stopped.
wrapper | James Mail Server 2.1 removed.

Note: To get more information about the wrapper command, type: C:\Tools\james-2.1.3\bin>wrapper

10. Specify the DNS server. To find out, type:
ipconfig /all

you should see:
DNS-servers . . . . . . . . . . . : 10.0.0.2

11. To stop James press CTRL+C