antville/antville
antville/antville
1
1
Fork 0
Code Issues 51 Pull requests 9 Projects Releases 9 Wiki Activity Actions

rewrote installation instructions

Browse source
This commit is contained in:
Robert Gaggl 2003-01-13 11:52:04 +00:00
parent 76b32c6598
commit 0f00567693
1 changed files with 47 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

73
readme.txt
View file

@ -77,30 +77,35 @@ installations or if you need advanced features like URL rewriting).
INSTALLATION
============
The Antville-distribution contains two main directories: "antville"
and "db_support". Put the first one (which is the application itself)
Unpack the distribution file. Move the resulting directory "antville"
into the directory "apps" of your Helma Object Publisher installation.
The second directory, "db_support", contains database-related files,
Inside the directory "antville" you will find a zipped archive called
"db_support.zip". This archive contains all database-related files,
ie. several SQL scripts for creating the database needed by the
application. Antville comes with scripts for MySQL
(antville_mysql.sql) and for Oracle databases (antville_oracle.sql) -
the third one, antville_mckoi.sql, is only used for the Mckoi database
used in the AntClick distribution.
application. So first unpack db_support.zip which will create a
directory called "db_support". Change to that directory.
Each of these scripts are not only creating the tables, indexes and
initial records, but also the account used by the application to
communicate with the database. Both, the default username and password
of this account are "antville", so you probably want to change that
(you should!). Open the appropriate script and scroll down to the
section called "Database-User". Search for "identified by" and change
Antville comes with scripts for MySQL (antville_mysql.sql) and for
Oracle databases (antville_oracle.sql) - the third one,
antville_mckoi.sql, is only used for the Mckoi database used in the
AntClick distribution.
Each of these scripts are not only creating the tables, indexes and
initial records, but also the account used by the application to
communicate with the database. Both the default username and password
of this account are "antville", so you probably want to change that
(you should!). Open the appropriate script and scroll down to the
section called "Database-User". Search for "identified by" and change
the value in quotes to the password of your choice.
Please refer to the documentation of your database on how to run the
Please refer to the documentation of your database on how to run the
appropriate script. After done so you'll have to tell Antville how it
can access your database. This is done in a configuration file named
"db.properties". Antville comes with two templates, one for MySQL
(antville_mysql.sql) and one for Oracle (antville_oracle.sql). Open
"db.properties".
Antville comes with two templates for db.properties, one for MySQL
(db.properties.mysql) and one for Oracle (db.properties.oracle). Open
the template for your database and ensure that the line beginning with
"antville.url=" points to the server that runs the database (for MySQL
this will in most cases look like http://localhost:3306/antville,
@ -114,20 +119,36 @@ overwrite it).
NOTE: If you're using Oracle you need to install the JDBC driver for
your database by placing the appropriate zip file into the
subdirectory "lib/ext" located in Helma's installation directory. The
driver for MySQL is already contained in the distribution of Helma
subdirectory "lib/ext" located in Helma's installation directory (you
can download the JDBC driver for your Oracle-database at
http://technet.oracle.com/software/tech/java/sqlj_jdbc/content.html).
The driver for MySQL is already contained in the distribution of Helma
Object Publisher.
Finally, open the file "apps.properties" located in the directory
where you installed Helma and append the word "antville" (without
quotes) in a new line. Then start up Helma, and after pointing your
browser to http://localhost/antville (assuming that Helma is running
on the same machine and uses port 80) you should see Antville's
welcome page. It will tell you about the two additional configuration
steps necessary: you need to register to gain system administration
Next you need to copy the default images of Antville to the
appropriate place. If you are planning to use the embeded webserver of
Helma Object Publisher, change to the directory "static" of your Helma
installation. Create a directory called "antville" and in there two
subdirectories: "images" and "files" (of course you can use any other
schema too, you just need to adapt the application properties in the
next step). Unpack the archive "images.zip" located in the application
directory of Antville to your newly created directory images. NOTE:
Don't place your images outside the directory "static" if you're using
Helma's embedded webserver, otherwise it won't find them.
Open the file "apps.properties" located in the directory where you
installed Helma and append the word "antville" (without quotes) in a
new line. Then start up Helma, and after pointing your browser to
http://localhost:8080/antville (assuming that Helma is running on the
same machine and uses port 8080) you should see Antville's welcome
page. It will tell you about the two additional configuration steps
necessary: you need to register once to gain system administration
rights and then you must configure the basic preferences (like
language settings, date formats etc.)
If everything went fine you can safely delete the directory
"db_support".
=====================================
DOCUMENTATION AND FURTHER INFORMATION
=====================================
@ -164,5 +185,5 @@ there will also be other ways to participate.
© 2002, antville@helma.org
http://project.antville.org
This document was last modified on Tuesday 6 January 2003 by
This document was last modified on Tuesday 12 January 2003 by
robert@helma.org