$HELP::HEADER
Abstract
JaM uses a MySQL database to manage its data. It can create
a database for you or you use an existent database. With
the "Edit Database Information" dialog you configure the
database connection information and initialize a new database.
It is recommended to create a database especially for JaM,
otherwise table or index names may clash with existing objects.
1. Provide connection information
First of all enter the DBI Data Source, Username and Password
to connect your MySQL database. The default for DBI Data Source
is "dbi:mysql:jam", but you can change it, e.g. if your database
is not installed on localhost or behind a DBI::Proxy. Refer
to the manpage of DBD::mysql for information about DBI data
sources for MySQL databases.
This information will be stored in the file ~/.JaMrc, so JaM
will be able to connect the database without asking you again.
2. Test your configuration
Press the button "Test" to test your connection information. A
connection will be established and terminated immediately. If
everything works ok, a corresponding message will appear in the
"Status" area. Otherweise an error message will be displayed there.
3. Create your database
If you want to create a new database for JaM, press the "Create DB"
Button. You can skip this step, if you want to use an existent database.
If a database with this name does already exist, a error message
will be thrown and the existent database will not be touched.
4. Create tables
The last step is creating the tables for JaM. Press the "Create Tables"
button and they will be created inside the database you have chosen.
That's all, Folks
Almost ;) If you change the database connection information at runtime (not in
the initialization phase) you have to restart JaM.
$HELP::FOOTER