This step is necessary for all platforms. You have to create some databases for refdb to start with and you should make the refdb SGML/XML support files known to your system.
The refdb database contains common information that is shared by all reference databases. The refdbvar database is used to create temporary tables during queries.
Note: If mysqld (the MySQL database server) is installed on a remote box or if the security settings require it, you may have to use the -h hostname and/or the -u username/-p password options to run the mysql client as shown below. mysqld needs to be up and running and you need the appropriate permissions, of course. See the MySQL documentation for further details.
In a command line window, start mysql. This command will run the MySQL command line client in the interactive mode.
Run the commands:
mysql> create database refdb; |
mysql> create database refdbvar; |
Quit mysql by typing:
mysql> quit |
On the command line, run this command:
~$ mysql refdb < refdb.dump |
refdb.dump is in the scripts subdirectoy of the refdb sources. If necessary, use the full path. This SQL script will generate the necessary table definitions and fill in a few values.
Now is the time to create the global configuration files described in the configuration file section. Create these files in /usr/local/etc (or whatever you chose during configuration). It is recommended to copy and modify the commented example configuration files in the package data directory, usually /usr/local/share/refdb. These files are installed with the suffix ".example" to avoid overwriting existing configuration files. All required paths are automatically configured during the installation, so these files are a good starting point for your local modifications.
The refdb package comes with a few additional scripts and stylesheets for the creation of bibliographies. These files are installed in the package data directory (usually /usr/local/share/refdb) and its subdirectories, but you should spend a little time to integrate them into your SGML system.
To this end, add the catalog files dsssl/catalog and dtd/catalog to your SGML_CATALOG_FILES environment variable.
The refdb shell scripts (db2ris, refdbjade, runbib, refdbxml, and the Perl script tex2mail) were installed in /usr/local/bin unless you chose a different install root during configure. As refdb attempts to insert the correct settings during the build process, it should not be necessary to manually customize these scripts. If you still want to fiddle with the settings, the variables are clearly marked within a "user-customizable section" at the top of each script.