How to install Antville on a Windows XP desktop or laptop using Antclick
My grandmother needs her own gorgeous Antville to create as many blogs as she wants. Following this instruction she managed to install Antville within 10 minutes:
-
Download Java 2 Platform Standard Edition, the basis of Antville: Go to java.sun.com In row 'Windows (all languages, including English)' and column 'JRE' click DOWNLOAD. File size is 10 MB.
-
Install the downloaded file j2re-1_4_1_01-windows-i586-i.exe. Ignore the message 'Kernel.exe - Application Error' by clicking 'OK'.
-
Delete the new 'Java Web Start' icon from your desktop. You do not need it for Antville.
-
Download the latest version of Antclick from adele.helma.org , e.g. antclick-1.0pre4.zip (xxx.zip files are recommended for Windows, xxx.gz for Unix). Antclick file size is 5 MB and it includes all you need: Antville, Helma HOP, a web server and a database.
-
Uncompress (unzip) Antclick to C:\antclick-1.0pre4. That's it, there is NO setup.exe to click.
Optional you can choose another location on your harddisk, but be aware that NO space is allowed in the path to Antville. E.g. ‘C:\Program Files\antclick’ will NOT work because of the space between Program and Files. ‘C:\Program_Files\antclick’ will work.
- Start Antville by clicking C:\antclick-1.0pre4\hop.bat. A MS-DOS window will appear:
Starting HTTP server on port 8080
Serving applications from C:\antclick-1.0pre4
Starting Helma 1.2.1 (2002/12/17) on Java 1.4.1_01
Do NOT close this MS-DOS window. Closing it stops Antville.
- Type 127.0.0.1:8080 in the web browser and Antville greets you with a setup screen. Now you can configure your new shiny Antville server.
Remarks:
The address 127.0.0.1:8080 only works on the machine where you installed Antville.
To start Antville automatically after booting, create a shortcut of hop.bat in 'All Programs / Startup folder'.
Switch to Linux if Windows XP is crashing too often.
This instruction is based on Windows XP, Sun Java J2SE 1.4.1 and antclick-1.0pre4. February 2003.
Please tell us your own Antclick experience by placing your comment. Subscribers are allowed to edit this instruction to improve it.
So long, and thanks for all the ants, id
nex
this is cool, making the instructions so easy that everyone and their grandma can do it. very nice that you thought of the bug with spaces in the path.
i'm not feeling like changing the above now, but i'd like to add these comments:
it's okay to leave out instructions about security for XP, because it has a firewall pre-installed and turned on by default. however, i think there should be a warning nevertheless. if someone by chance has port 8080 open or switched her firewall off completely, there is the risk of someone else reading personal data or destroying it.
and i would let the user check if he has java installed (opening a console, typing 'java' and looking what happens should do), because installing it if it's already there would be more than pointless.
dieguteseite
to install antclick 1.0 on a windows XP desktop.
as discribed above i downloaded "j2re1.4.1_02".
the path is: "c:\Programme\java\j2re1.4.1_02\".
then i downloaded antclick 1.0.
the path is : "c:\Programme\helma\".
next was the editing of the "hop.bat".
the only changes i made where:
:: Uncomment to set HOP_HOME
set HOP_HOME=c:\Programme\helma
:: Uncomment to set JAVA_HOME variable
set JAVA_HOME=c:\Programme\Java\j2re1.4.1_02\
then i thought that this should be it. but after starting the hop.bat and trying to receive "http://localhost:8080/"
i get a 404-error "server or dns not found".
and i have no idea where to look for the bug.
can i somehow control if the local web-service is up?
how to debug the hop.bat? it vanishes so fast that i can`t read what really happens.
any idea is very welcomed. thank you in advance!
edit: maybe i should add that the ms-dos window closes immediately. not like it is discribed in the story above.
dieguteseite
meanwhile i figured out that how to debug the hop.bat.
just begin the script with "@echo" and end it with "pause".
this leads to this:
server already running at this port: 8080
when i try another script:
@echo
"c:\Programme\Java\j2re1.4.1_02\bin\java.exe" -server -Xmx128m -jar
"c:\Programme\helma\launcher.jar" -w 8080
pause
i get this:
but not even the javaw.exe process starts.
dieguteseite
finally it works. i'll try to find out exactly what was the problem and will post the solution later.
now i need a break. ;-)