Installation

Introduction

"Rainmail Server" works with Supplied Linux. The Supplied Linux can be installed on an ordinary IBM compatible PC. The hardware requirements for installing "Rainmail Server" are given below.

2.1 Hardware Requirements

• Pentium or better processor.
• 128MB of RAM (256MB recommended).
• 4GB of free hard disk space.
• Connectivity to ISP (External modem for dial up and router for Leased lines).
• Network card to connect to rest of your LAN*.
• VGA or better monitor*.
• CD-ROM Drive.

* The Network and VGA cards must be Linux compatible. For a list of Linux compatible card, visit http://www.getcloser.net/compatible.html.

2.2 Software Requirements

"Rainmail Server 1.8" can be installed on a system with Supplied Linux. The modem and network card must be working correctly with a working installation of Supplied Linux. In the following section, we talk about various things to check before proceeding with the Installation.

If you are installing the supplied linux on a new machine, please remember that you can assign any IP address to the machine and any name. "Rainmail Server" recognizes these IP addresses and maintains them the same during installation. However, we recommend assigning a private IP address like "192.168.1.1" if you are going to be connected to Internet using a dial-up medium. This would greatly enhance the security of your internal LAN.

2.3 Installing Supplied Linux

If you are installing Supplied Linux on a new machine, here are some general guidelines you can follow to make the installation smooth:

• We recommend selecting the default KDE installation.
• As "Rainmail Server" stores mail and proxy files in the "/var" directory, it is recommended that you allocate at least 1GB for the partition containing this directory (more if you have large number of users).
• "Rainmail Server" stores your file contents in "/usr/share/smb" directory. Therefore, we recommend allocating at least 1GB for the partition containing this directory.
• You can assign any free IP address in your network to this machine. "Rainmail Server" uses this IP address while installing. Generally, private networks with less than 100 machines are class C network and have IP addresses in the range 192.168.1.X (where X may range from 1-254). We recommend allocating an IP address of "192.168.1.1" to your "Rainmail Server".

2.4 Pre-Installation Check List

"Rainmail Server" rewrites a lot of your Linux network configuration upon installation. If you had any networking software, other than the ones installed by Supplied Linux on installation, please remember to take a back up of their configurations.

The following checklist ensures that various systems that "Rainmail Server" depends on is working. If any step fails, you can talk to your OS and/or hardware vendor to make sure that the hardware is functional.

• Modem: If you are connecting to Internet with a dialup line (Analog or ISDN Modem), ensure that the modem is installed and working in the system. If you are connecting to Internet with DSL, Cable Modem or a Leased line, you can skip over to the next step ("Network").

Ensure that modem is installed and working fine by following these steps:

1. In a new console (either xterm or a normal screen console), check that the modem device file exists by typing in

   "ls -al /dev/modem"

   If the system says that the file is not found, modem has not been installed on your machine. If the modem device exists, proceed to Step 3.

2. Find out the COM port the modem is connected to. Then create a link from the modem device to that COM port. Suppose the modem is connected to port COM1, you can create a modem device file by typing in

   "ln -s /dev/ttyS0 /dev/modem"(in Supplied Linux)

3. After making sure that the modem device file (/dev/modem) is present, you can test if modem is working by using minicom. Type in

   "minicom".

   minicom will try to initialize the modem and output the result of initialization. If you see the lines "OK", your modem setup has been correct so far.

4. Try dialing out by typing

   "ATDP<PHONENUMBER>"

   where <PHONENUMBER> is a phone number you know.

   You might have to replace "ATDP" with "ATDT" if your phone only supports Tone dialing. If the modem dials out, the test has been successful. To quit "minicom", you can press "Ctrl-A", "z" and then "x". For "minicom" help, you can press "Ctrl-A", "x".

• Network (Please skip this step if you are connecting to Internet using Analog or ISDN Modem): If you are connecting to Internet with DSL, Cable Modem or a Leased line, you will need some additional information to connect to Internet. However, you do not need this information at installation time. At Installation time, we will do the install for a dial up link. Once the installation is complete, you can use the configuration program to make "Rainmail Server" work with your Cable Modem, DSL or Leased line link. The advantage of this method is that if the permanent link fails, you can switch over to an analog or ISDN connection as a backup. For installation purpose, choose an unconnected serial port that you would connect a modem (in case of permanent link failure). Suppose it is COM1, you can set the link for modem as follows:

  "ln -sf /dev/ttyS0 /dev/modem" (in Supplied Linux).

• Network Card Ensure that the network card is working and configured correctly by typing

  "ping <ip address of client>"

  You can replace <ip address of client> by IP address of another machine in your LAN. If the command succeeds, your network card is working fine and has been configured properly.

2.5 Installation Information

Installation of "Rainmail Server" requires some information so that it can connect to your ISP and also offer many of its other facilities. Some of the information will be contained in the letter you received with the copy of this software (Please call technical support if the letter is missing). You will also require other information. The following section gives a list of all the information you will need to install "Rainmail Server" and gives a pointer to where the information can be found.

• Name of your installation's domain. Will be in letter accompanying this package.
• Name of your installation's email domain (if you chose to use email domain): Will be in letter accompanying this package.
• Your ISP account name: Contact your system administrator or ISP for this information.
• Your ISP account password: Contact your system administrator or ISP for this information.
• Your ISP Dialing number: Contact your system administrator or ISP for this information.
• Your ISP Name servers: Contact your system administrator or ISP for this information.
• Your ISP mail relay host: Contact your system administrator or ISP for this information.
• Your mail server address: Will be in letter accompanying this package.
• Your mail server account name: Will be in letter accompanying this package.
• Your mail server password: Will be in letter accompanying this package.
• Your ISP authentication information: Contact your system administrator or ISP for this information. If you cannot get this information, select "PAP" in the setup dialog. Most ISP's allow authentication using PAP and normally you should not have any problems connecting using the default. The web site http://www.getcloser.net contains a link to the type of authentication used by common ISP's.
• "Rainmail Server" license password: Will be in the letter accompanying this package.

Even if you are using only a DSL, Cable Modem or Leased line to connect to Internet, we recommend that you have valid values ready for above ISP information. You can buy an additional ISP dial up account and the values as above. This way, switching from your main link to backup and vice-versa becomes real easy.

"Rainmail Server" overwrites many configuration files when installed. Normally, there will be no need to get back to your current configuration. However, if you want to get back to your current configuration, you must make a backup copy of all your cofiguration files (all files from "/etc" and "/var" directories) before installing "Rainmail Server". You can ignore this warning if you are installing "Rainmail Server" on a fresh Supplied Linux installation.

2.6 Rainmail Package Selector

"Rainmail Server 1.8" (RIS 1.8) is an extension of RIS Standard that combines Carizen's Mailing Service solution (RIS Standard), Catch ALL and one -to one POP acccounts in a single setup program. "RIS 1.8" provides top level control for the installation process such as addition and removal of each module, licencse validation based on the type of email solution , future upgrades, future customization and expansion. It has two interfaces namely, Rainmail Package Selector and Rainmails Configuration Program. Package selector interface povides an interface to select and install the software packages. The Interface allows you to upgrade to other modules for future requirements. Rainmails Configuration Program configures the Rainmail Server.

"RIS 1.8" implements Package selection methodology wherein software packages are activated through Rainmail Package Selector Interface. Package selector installs the selected packages instead of simply installing the software. The Package selector interface consists of 12 modules. They are:

1. Email
2. Proxy
3. Antivirus
4. File
5. Web
6. Firewall
7. Fax
8. VPN
9. Dailin
10. Chat
11. Bandwidth Manager
12. Groupware

The Email module offers three different type of email services, in order to cater to different type of users, . They are outlined below:

• RIS Standard : This Mail service is provided by Rainmail Intranet Server.
• Catchall : This Mail service will fetch mails from a POP Server and delivers mails based on the Mail Header information. Headers can be changed depending on the Mail Service Provider. This option delivers all your email sent to your domain to your POP account, regardless of what name it is addressed to. So even if someone mispells your name, you do not lose email. You will get all mails addressed to your domain based on the header information. Thus "Catch-All" e-mail address allows you to set a default address, that recieves any mail sent to your domain. This is a handy way to ensure that you get all of your e-mail.
  
• POP : This Mail service is used to fetch POP boxes from other Mail Servers and then to deliver it locally. POP accounts can be enabled or disabled at any time. This option allows you to setup unlimited number of multiple POP accounts. Any additional POP accounts you setup for an user(s) can be checked or read using Open Web Mail. It pulls email from a POP3 account at your ISP (Internet Service Provider) and redirects messages to users on your local mail server.

"RIS 1.8" combines three different types of Mail Services RIS Standard, Catch-all and POP and then installs the packages depending on the selection. System Administrator can select the required modules at the time of installation. After installation , the Rainmail Configuration program GUI interface will display the Tree view of selected modules in addition to the six general modules. The six general modules are:

1. User Accounts
2. ISP Information
3. Modem/Dail Information
4. Network Information
5. Miscellaneous
6. Backup
   

2.7 Installation

Installation is relatively straightforward and is GUI driven. Following the given steps will ensure a trouble free and easy installation:

• Logon as root. "Rainmail Server" modifies your system configuration files and needs root permission to do them.
  
• Start X GUI (if not already started). This can be done by typing

  "startx"

  at command prompt. If it fails or locks up the screen for some reason, your GUI is configured incorrectly. Please contact your Hardware/OS vendor for correcting this problem.

• Open up a new terminal.

  In "KDE" and "GNOME", this can be done by clicking on the Start menu (on bottom left hand side of the screen) and selecting "Utilities" and then "Terminal".

• Place your "Rainmail Server" CD in the CD-ROM drive.

  Mount the CD by typing in the opened xterm

  "mount /dev/cdrom /mnt/cdrom"

  Please note that the CD must be mounted in /mnt/cdrom for the setup program to function properly.

  From the terminal, change directory to "/mnt/cdrom/rainmails" by typing

  "cd /mnt/cdrom/rainmails"

• Ensure that modem link is up. Set the link for modem as follows:

  ln -sf /dev/ttyS0 /dev/modem" (in Supplied Linux).

• Start the setup program by typing

  "bash setup".

One word of comfort before starting with the setup program: All the parameters you enter in the setup program (with the exception of email domain name in the second screen) can be changed even after installing the software. Therefore, there is no need to be afraid of entering invalid values during the setup phase. The values can always be corrected after the software is installed. However, entering the correct value during the setup phase is recommended.

The setup program is Java based. The program will check if you have Java installed on your machine and if not, will install it from the CD. After installing Java, setup program will begin to execute. The Rainmail Package Selector Interface appears.

2.7.1 Installation -RIS Standard Installation

1. The Package Selector Interface "Rainmail Server Package Selector" is a series of screens which allows the Administrator to select and install the software packages. The first screen displayed is the main installation screen, which shows a welcome message. When it starts up, you will see the following screen:
   
   
   
   
   
   
2. Package Selection
   When the user clicks "Next" the second screen appears which lists all the 12 packages allowing the user to choose the program to install. Check the "Email" checkbox. This will list the Email services. Select the radio button corresponding to the email service you have purchased. Checking the checkbox beside the package name marks it for installation.
   
   
   
   
   
   
3. Similarly select the packages you have purchased by marking the corresponding checkbox . Scroll down the window to view and select the packages.
   
   
   
   
   
   
4. Scroll down to view and select the remaining packages. The individual packages with a checkmark beside them are currently selected for installation. After selecting the packages press the "Next>>" button.
   
   
   
   Pressing the "<< Back" button will take you to the previous screen. Pressing the "Next >>" button will take you to the next screen.
   
   
   
   
5. Email Domain Information
   If your email address is of the form "user.emaildomain@domain.com" then in this screen enter the email domain assigned to your organization. This will be present in the letter that came with the software.
   
   
   
   
   
   
6. If you have an email domain, make sure that the check box "Use Email Domain" is checked. In this example, the name of the email domain is "icsoft.net". If your email address is of the form "user@domain.com", then you have to uncheck the "Use Email Domain" checkbox. When you do that, the email domain field becomes disabled. After entering a value for the email domain (or not - depending on your configuration), Press the "Next >>" button.
   
   
   
   
   
   
7. Global Domain
   In this screen you will need to enter the name of your actual Internet domain. You need to change it only if your letter specified a different domain. To validate your license, if you have purchased a 25 user license enter "25" in the Number of Users filed. Enter the 32 character License Key supplied in your letter in the Package Selector program. Press "Next >>" after entering the correct value for this field that have been provided in the letter.
   
   
   
   
   
   
8. Type of authentication
   In this screen, you will require to enter information about how your ISP authenticates. You can get this information from your ISP. Most ISP's support PAP and therefore the default should work fine. If you encounter any problems connecting to your ISP, you can try changing to "Login" later. Choose the default (PAP), unless you are sure that your ISP uses Login mechanism. You can also enter text to expect before sending user name, password and the "ppp" command if your ISP uses login authentication. Press "Next >>" after you enter the correct information. That will take you to the next screen.
   
   
   
   
   
   
9. ISP details
   In this screen, you will need to enter information that will help the computer connect to your ISP. You can also specify whether you want to allow Internet access to your clients (this can be changed later too) and if your telephone needs to dial using Pulse or Tone dialing. Information about ISP User ID and Password can be obtained from your system administrator or ISP. The default for other fields give the values used by VSNL Chennai. If you use a different ISP, you will need to fill in the values from your ISP (This information can also be obtained from your ISP). Please note that you have to enter your ISP password twice. This is necessary because the password does not appear on the screen when you type it in and it is easy to make mistakes if you type it in only once.

   By default, your modem is configured to dial in the Pulse mode by "Rainmail Server". Selecting the "Tone" radio button can change this setting. After entering the value for all the fields, you can proceed to the next screen by pressing the "Next >>" buttonYou need to change it only if your letter specified a different domain. Press "Next >>" after entering the correct value for this field. That will take you to the following screen: ISP details
   
   
   
   
   
   

10. Mail Server Details
    In this screen, you will need to enter information about your incoming POP mail server. All the information required in this screen will be supplied in the letter you received with the software. You will need to change the fields only when they do not match the ones in the letter.
    
    
    
    
    
    
11. SMTP Server details
    In this screen, you will need to enter yout ISP's SMTP server address.This will be present in the letter that came with the software. "Rainmail" gets installed with a default address of "203.199.212.2". You can also enable or disable SMTP relay authentication. Enter the new number in the "SMTP Mail Server" field. If your mail server has smtp relay authentication, Check "Enable SMTP Auth" field. Enter the username and password twice for relay authentication in the corresponding fields. If you want to disable smtp relay authentication, uncheck "Enable SMTP Auth" field .
    
    
    
    This is the final input screen in the setup program. If necessary, you can review your inputs by going back using the "<< Back" button. The setup program will start installing all the required software.
    
    
    
    
12. A progress bar on the screen will indicate the progress of installation. At end of installation, a message box will be displayed and on pressing "OK", the "Finish" button will be enabled.
    
    
    
    
    
    
13. Pressing the "Finish" button completes the installation.
    
    
    
    
    
    
14. Click "OK".
    
    
    
    
    
    
15. It is recommended that you reboot the machine after this installation. When a message box appears asking whether to reboot, save all your existing documents and press "Yes". That will automatically reboot the machine .
    
    
    
    

<Back> <Table Of Contents> <Next>