Kangaroo-egg is a new webserver, it use Java language developed. It followed HTTP1.1 protocol and has DQM script language and container (very like Servlet/JSP). So it can use in medium or small web application. We believe it will become a popular webserver soon.
This chapter will introduce kangaroo-egg basic elements and how to install and startup it.
Kangaroo-egg like JSP server, but it has own container to execute dynamic web page. This container name is DQM and dqm script language. DQM is a groupware must run at Java entironment, and this groupware is a part of kangaroo-egg web server. The function of DQM container is execute dynamic web page that coding by dqm script language. If you known asp, jsp and php then dqm like them, and dqm script language is very like jsp script language, if you known jsp use dqm is very easy.
Ok, what special functions we have? First dqm script language is very easy. Secondly DQM container run dynamic web page after compile it. Lastly DQM container support define web page's extended youself. Table 1-1-1 inform the difference of popular web script language.
|
Script language |
Container |
Dhtml ext name |
Execute process |
|
ASP |
Microsoft IIS |
.asp |
Translate |
|
JSP |
Tomcat |
.jsp |
Compile |
|
PHP |
Apache |
.php |
Translate |
|
DQM |
kangaroo-egg |
Any extended name that you want |
Compile |
Table 1-1-1
Kangaroo-egg web use Java tech, so can deploy at Windows, linux and unix OS, but we only test our server at Windows, redhat linux and Solaris10, so maybe will has some compatible problem at other OS.
You must install JDK1.5 before install kangaroo-egg. Please refer to other correlative document to get how to install JDK1.5.
|
Notice: Kangaroo-egg must run at JDK1.5 or later. |
You can download kangaroo-egg server from www.kangaroo-egg.com, it’s a ZIP file, uncompress this file you can see the folders like picture 1-2-1.
Picture 1-2-1
There are three folders, main program files at the “classes” folder, configuration files at the “conf” folder, and default web application files at the “webapp” folder.
Enter the “classes” folder you can see the two files run.bat and run.sh. The run.bat file is a startup script command under windows OS. The run.sh file is a startup script command under linux or unix OS. But these two files can’t execute now, because need config its first.
1. Open the run.bat, you will see:
Picture 1-2-2
Please notice “XXX” at red mark, change “XXX” to your JDK installed folder. For instance your JDK installed to “c:\jdk1.5” folder then you must change the “XXX” to:
Picture 1-2-3
Ok, now you can execute run.bat, you can see picture 1-2-4 when you startup successfully.
Picture 1-2-4
If you want to kangaroo-egg run at background, change “java” to “javaw”, like picture 1-2-5.
Picture 1-2-5
2. Open the run.sh, you will see:
Picture 1-2-6
Please notice “XXX” at red mark too, change “XXX” to your JDK installed folder. For instance your JDK installed to “/jdk1.5” folder then you must change the “XXX” to:
Picture 1-2-7
Ok, now you can execute run.sh, you can see same picture 1-2-4 when you startup successfully.
|
Notice: run.sh file’s attribute must be execute, if not it can’t be execute. |
If you want to kangaroo-egg run at background under lunix or unix OS, please use this command “./run.sh &”.
|
Notice: linux or unix OS has “nohup” command, this command can log console’s content to nohup.out file. Command: nohup ./run.sh & |