				Daffodil CRM Installation Guide


Pre-requisites


Before starting off with the installation of Daffodil CRM, make sure that J2SDK 1.4 or above is installed on your system.
If you dont have J2SDK, download from http://java.sun.com/j2se/1.4/download.html 

Daffodil CRM also requires any servlet enabled server like Tomcat 4.0.6 or above version for its working.
If you dont have Tomcat, download from http://jakarta.apache.org/tomcat/

It is recommended that you use Pentium (or equivalent) processor with a minimum of 128 MB RAM. 


User Guidelines for installing Daffodil CRM

1.	Set JAVA_HOME  JAVA_HOME is the directory path where you have installed J2SDK. Set JAVA_HOME in Environment Variables

2.	After extracting DaffodilCRM-1_x_beta.zip to an appropriate folder and you will find the following files:

(a)	daffodilcrm
(b)	crmdata
(c)	readme.txt

3.	Edit the file web.xml located in the directory  daffodilcrm/WEB-INF and add following parameters :

(a)	MailAccountURL* 
			Mail accounts from which you wish to receive mails should be listed in this parameter.
	You can specify as many number of mail accounts as you wish; each should be separated by a semicolon.
	For one mail account you need to specify the following four values:
	<username>:<password>@which POP3 server the account exists: at which port the POP3 server is running.

	Example:
	<context-param>
	<param-name>MailAccountURL</param-name>
	<param-value> User_Name1:Password@POP3Server:Port;User_Name2:Password@POP3Server:Port</param-value>
	</context-param>

(b)	SMTPServerURL* 
			This parameter points to the SMTP Mail server from which you will be sending mails for campaigning.
	You have to specify two values  name of the SMTP Mail server and the port on which it is running  in this parameter.

	Example:
	<context-param>
	<param-name>SMTPServerURL</param-name>
	<param-value>SMTPHost:port</param-value>
	</context-param>

(c)	POP3ServerURL* 
			This parameter points to the POP3 Mail server from which you wish to receive template mails
	for campaigning. You have to specify two values  name of the POP3 Mail server and the port
	on which it is running  in this parameter.
	
	Example:
	<context-param>
	<param-name>POP3ServerURL</param-name>
	<param-value>POP3Host:110</param-value>
	</context-param>

(d)	TemplateEMailAccountURL* 
			This parameter points to those mail accounts which contain template emails for campaigning.
	You can specify as many number of mail accounts as you wish; each should be separated by a semicolon.
	For one mail account you need to specify the values for username and password.

	Example:
	<context-param>
	<param-name>TemplateEMailAccountURL</param-name>
	<param-value>userName1:Password;UserName2:Password</param-value>
	</context-param>
 
	* You will not find the tags for the above four parameters in the web.xml file.
		 These user-specific parameters have to be manually added. 

(e)	DBConnectionURL 
			This parameter points to the database with which software establish connection.
	You have to specify the URL of database which comprises of database name(leads), its path and other details.
	Path is the absolute path where you have placed crmdata directory.

	Example:
	<context-param>
	<param-name>DBConnectionURL</param-name>
	<param-value>jdbc:daffodilDB_embedded:leads;path=<Absolute path of database>;create=false;</param-value>
	</context-param>


Note: The following three parameters are database (One$DB) specific. So you can use the examples provided therein without making any changes. 

(f)	Driver  
			This parameter represents the database driver class.
	
	Example:
	<context-param>
		<param-name>Driver</param-name>
		<param-value>in.co.daffodil.db.jdbc.DaffodilDBDriver</param-value>
	</context-param>
 
(g)	User 
			This parameter represents the database user name.
	Example:
	<context-param>
		<param-name>User</param-name>
		<param-value>daffodil</param-value>
	</context-param>

(h)	Password -
			This parameter represents the password for the above specified database user.
	Example:
	<context-param>
	<param-name>Password</param-name>
	<param-value>daffodil</param-value>
	</context-param>

4.	Place daffodilcrm directory in the document directory of your servlet enabled server.
	For example: In case of Tomcat server, place daffodilcrm in the webapps directory of tomcat.

5.	Run your servlet enabled server. (For example: Tomcat)

6.	Open any browser and type the following URL: http://serverIPAddress:port/daffodilcrm
	where serverIPAddress and port specifies the system name and port number where your 
	servlet server (tomcat) is running.

	Example:
	http://localhost:8080/daffodilcrm 

7.	You will get a login page. Do login with a valid user name and password.
	Default values for both the parameters are admin.


 
			Build Instructions for Daffodil CRM Community


		(Skip this section, if you have downloaded executable binary files)

Additional requirements for building Daffodil CRM

1.	One$DB Download now( http://www.daffodildb.com/download/index.jsp)
2.	Apache-ant-1.5.2 or higher. Download now(http://ant.apache.org/)


Installation Guidelines of One$DB

1.	Extract the zip file OneDollarDB3_4_1.zip to an appropriate folder.
2.	Run OneDollarDB3_4_1.jar to install Daffodil DB in your system.
	Either Double click on OneDollarDB3_4_1.jar or run the following command to initiate
	the installation process.
	java jar /path/OneDollarDB3_4_1.jar (Path is the absolute path of OneDollarDB3_4_1 folder)
	For example: If we have extracted the zip file to C:\, then the path will be 
	C:\OneDollarDB3_4_1.
	Now we can run the daffodil installer as follows:
	java jar /C:/OneDollarDB3_4_1/OneDollarDB3_4_1.jar

3.	The installation wizard will guide you through the rest of the process.
4.	During the installation, you will be prompted to choose JRE (Java Runtime Environment).
	Please select JRE v 1.4 or higher.

Extra step for Macintosh users

5.	You have to explicitly change the mode of all .command files located under
	the directory <installation path>/Tools using the command chmod as follows: 
	chmod 777 *.command


Project Build Steps

1.	Set the path for ant in the environment variables.

2.	Extract DaffodilCRM-src-1_x_beta.zip to an appropriate folder and you will find the following files:

(a)	daffodilcrm
(b)	build.xml
(c)	lib
(d)	src
(e)	daffodilcrmddl.sql
(f)	readme.txt

4.	Creation of database for application  Run the file ShellEmbedded.bat located in the
	directory OneDollarDB3_4\Tools.

5.	Command window that appears will prompt for the following:

(a)	Username:[default : daffodil]: <Enter the default value or any other valid user for
	the database>

(b)	Password :  [default : daffodil]: <Enter the password for the above specified user>

(c)	DaffodilDBHome(DataBase Path):[default: C:\OneDollarDB3_4\databases]: <Enter the path
	where you want to place your database>

(d)	ReadOnlyMode(true/false):[default: false]:<For this parameter, you have to specify
	the default value. So just press Enter>

(e)	Database name : [default: school]: <Enter database name as leads>

(f)	StackTrace [true/false] : [default: false]:<Just press Enter>

(g)	DatabaseOption [Standard/Custom] : [default: Standard]:<Just press Enter>

6.	Creation of table structure in the database  Run the script file daffodilcrmddl.sql
	available in DaffodilCRM-src-1_x_beta directory through Daffodil DB shell i.e. on
	SQL prompt, type the following: run <absolute path of DaffodilCRMddl.sql>

7.	Copy the files DaffodilDB_Common.jar and DaffodilDB_Embedded.jar available in the
	directory OneDollarDB3_4\lib and paste in the directory daffodilcrm\lib

8.	Edit and modify the file web.xml located in the directory daffodilcrm/WEB-INF.
	The steps are explained above.

9.	Compiling the project  Make sure that the file build.xml is present inside the
	directory DaffodilCRM-src-1_x_Alpha. From command prompt, run the following:
	<absolute path of DaffodilCRM-src-1_x_beta>ant 

10.	After compilation, you will find the file daffodilcrm.war in the directory
	DaffodilCRM-src-1_x_beta. Place daffodilcrm.war in the document directory of
	your servlet enabled server. For example: In case of Tomcat server, place daffodilcrm
	in the webapps directory of tomcat.

11.	Run your servlet enabled server. (For example: Tomcat)

12.	Open any browser and type the following URL: http://serverIPAddress:port/daffodilcrm
	where serverIPAddress and port specifies the system name and port number where your
	servlet server (tomcat) is running.

	Example:	http://localhost:8080/daffodilcrm

13.	You will get a login page. Do login with a valid user name and password. Default
	values for both the parameters are admin.
