FreeMED Installation Instructions on a Slackware 10.2 Server

HOWTO Install FreeMED and Remitt on Slackware 10.2:

1) Make sure that MySQL and all of its libraries are properly installed on
your system. If you are planning on using a MySQL server located on
another box, be sure that the client libraries are installed on your
FreeMED box.

2) Make sure that PHP is installed, with MySQL support. Most distributions
require a separate module (php4-mysql, php-mysql) for MySQL support.

3) Install the FreeMED package:

# cd /usr/share
# tar zxvf /location/to/tarball/freemed-version.tar.gz

which will extract the .tar.gz file to /usr/share/freemed/. If you run
Redhat or Debian, you can use the precompiled packages, which will
render instructions 6 through 9 unnecessary.

You can also install from the subversion repository:

# cd /usr/share
# svn co http://svn.freemedsoftware.org/freemed/branches/0.8.x freemed

will install the development version.

4) Edit the /usr/share/freemed/lib/settings.php file to make sure that all
settings are correct for your machine. (There is a setup wizard in the
works that performs this step for you, using a web browser.)

5) Edit your Apache configuration files to associate .php files with php, as
well as setting index.php to be one of the default indexes. Also set up
access and a directory alias for FreeMED. This is accomplished with the
following lines:

DirectoryIndex index.php index.php (et cetera...)

AddType application/x-httpd-php .php
Alias /freemed /usr/share/freemed

Options Indexes Includes ExecCGI MultiViews FollowSymLinks
AllowOverride All
Order allow,deny
allow from all

6) HUP apache (killall -1 httpd) to force it to reload its configuration
files. Optionally you can use "/etc/init.d/apache2 restart" or its equivalent
in your distribution.

7) NOTE: THIS STEP IS SUPPOSED TO BE PERFORMED BY FREEMED. IF IT IS NOT, YOU
WILL HAVE TO DO THIS MANUALLY.
Create the database with the command "mysqladmin -p create freemed"
(if you are using MySQL). (The setup wizard also does this.) Please
note that if you do not give FreeMED's MySQL user permission to the
FreeMED database, it will generate an error. Check MySQL's manual for
the "GRANT" command for more information on this.
Adjust the memory limit in your php.ini file to be 64M. It is by
default set to 8M, which causes errors, since FreeMED requires more
memory than that for some of its functions.

8.A.) create a user called freemed on the Slackware server and on mysql

8.B.) logged in as the new user freemed on the Slackware server create the freemed database:
mysqladmin -p create freemed

8.C.) Try to load http://localhost/freemed/ in your web browser. This should
take you through a wizard which will help you set up FreeMED.
You may now use FreeMED. Congratulations!

9) Download the following packages into a same directory:
http://slackware.osuosl.org/slackware_source/d/perl/

DBD-mysql-3.0002.tar.gz
DBI-1.48.tar.gz
XML-Parser-2.34.tar.gz
perl-5.8.7.tar.bz2
perl.SlackBuild
slack-desc

10) edit perl.SlackBuild and unconment the line below:
USE_THREADS="-Dusethreads -Duseithreads"

11) Save the file and run ./perl.Slackbuild to install perl automatically

12) cd /usr/share/remitt

13) perl -MCPAN -e shell

14) cpan> install DBD::SQLite

15) cpan> install Compress::Zlib

16) ./bin/remitt_server.pl

17) cd /etc/rc.d/

18) ln -s /usr/share/remitt/debian/init.d rc.remitt

19) chmod 777 rc.remitt

20) ./rc.remitt start

21) cd /usr/share/remitt/

22) Create a user and passwd for remitt (I've used the same user and passwd I used to create for freemed on mysql:
./bin/sqlite_user_admin.pl create remitt_username remitt_password

23) enter the same info as above in FreeMED under REMITT in System Configuration:
Main->Administration Menu->System Configuration->Remitt Billing System
add the Remitt-username, the Remitt-password, the host (127.0.0.1) and the port on which the server runs(7688).

That's it, please let me know if this doesn't work. You should have both FreeMED and Remitt running now.