Freemed Installation Guide Under Linux, Fedora Distribution Alberz Akrawi, alberz@kth.se
Table of contents TABLE OF CONTENTS... 2 1 FREEMED INSTALLATION FOR FEDORA... 3 1.1 OVERVIEW... 3 1.1.1 What we ll need?... 3 1.1.2 Start point... 4 2 INSTALL FROM FEDORA DVD OR CD... 4 2.1 APACHE... 4 2.2 PHP... 16 2.3 MYSQL... 17 2.4 FREEMED... 22
1 FreeMed Installation for Fedora 1.1 Overview 1.1.1 What we ll need? Fedora distribution installed on your system Fedora download page: http://fedora.redhat.com/ Apache HTTPD Web Server This is the web server we ll be installed for this project. o Apache HTTPD Web Server Download Page: http://httpd.apache.org/download.cgi PHP This will be used to develop under the PHP programming language. o PHP Download Page: http://www.php.net/downloads.php MySQL Database Server This will be used to run our MySQL databases. o MySQL Download Page: http://www.mysql.org/ PhpMyAdmin Database Manager This will be used to manager our MySQL databases(voluntary installation). o phpmyadmin Download Page: http://www.phpmyadmin.net/home_page/downloads.php FreeMed software This is the main program and there are two versions of this software o TeleMed Product download page: http://csd.ssvl.kth.se/ o FreeMed Default download Page: http://www.freemed.org/
1.1.2 Start point There are two ways to install Apache, PHP, MySQL under linux. Make sure that you figure out this before you are going on with installation. If you have Fedora distribution DVD/CD then you can install all packages from this DVD/CD easy without problem and later you can upgrade this software. If you don t have this software installed on your system then you can download the latest versions of this software from scratch(see addresses above) and install everything in that way. I choose to download all software from Fedora DVD/CD. Upgrading this software is not relevant for us but you can do that if you want to. 2 Install from Fedora DVD or CD 2.1 Apache 1 Log on your fedora system as root because everything have to be done by administrator. This is the administrator who let you to use these resources. 2 Make sure if you have apache installed already on your system or not. Open you command shell and write rpm aq grep I httpd If you don t get any information then you know that you don t have apache installed in your system and have to install that. From the Menu select System Settings -> Add/Remove. As shown bellow. Applications. Make sure you select Web Server.
You will be asked to insert DVD&CD of Fedora. So do that. Then you can check it again if you have done everything correct.
Before you start the Apache you have to edit its configuration file httpd.conf found at: /etc/httpd/conf/httpd.conf Using a simple text editor(gedit), open the file /etc/httpd/conf/httpd.conf and go to this Line. Uncomment this Line first and replace the host name with your machine name( for example localhost). As above: #ServerName new.host.name:80 add this line: ServerName <your machine name>:80 Since my machine is called alberz I will set the ServerName directive to alberz. You choose your own computer name for his section. If you don't know your computer's name type hostname at the command prompt, or you could use localhost. [root@alberz ~]# The next step is to allow users to have access to their own webpages on your machine. I prefer to do this since I only use the root account for administrative features. Navigate to the section that says UserDir disable. You should see the screen dump below as the default.
I the same file make sure that u have something like that: and
We have finished with this file. SAVE IT!!!!! We now need to restart the Apache service (httpd daemon) to instigate the features we have edited. Write the command bellow on your command shell. /etc/rc.d/init.d/httpd restart The first fail is probably due to the fact that httpd wasn't started in the first place, hence the fail. But there is nothing stopping you typing /etc/arc.d/init.d/httpd restart again. At this stage we should make sure that httpd is started each time the computer is started. For this you will need to use the services command. Open the services command from the menu. ie System Settings -> Server Settings.
You will be presented with the screen dump shown below. Make sure you 1. Check the box next to httpd. 2. Click the SAVE ICON. This is important DON'T FORGET IT! Make sure the service is running by looking at the Status pane. Your service needs to run if you want to use it. Also you can restart the service and SAVE the configuration each time you edit a configuration file.
Now we have to create a user who can use these resources from your system. Let's create the user alberz with password and place the user alberz in a group called home. From the menu select System Settings -> Users and Groups as shown below.
Select the New Group Icon and type home. Then click OK. Click the Add User icon and type in the user details. The details for user alberz is shown below. I have unchecked the Create a private group for user check box since I want my user to be a member of the home group.
Highlight the user you have just created, in my case alberz and click the Properties Icon. Move to groups tab and check whether option home is selected there, if not select this home option. If home option does not exist there then go back to User Manager screen and select Add Group icon and create new group named home and click ok button. Make the user alberz primary group home, rather than the default user. Can check it from user manager screen. There will be the list of user and their specifications under different headings and there will be one heading named Primary group, if your username exists under Primary Group then this user can work as Primary user and if there exists user under Primary Group heading then you are a default user. In some versions of Fedora there are options to create Primary or default user. If you have created a user while installing Fedora 4 then that user is a Primary User.
Open a browser and type http://machine_name, in my case its http://alberz. You should see the Fedora Core Apache test page below. If not, try restarting the httpd service again. After you have created a user, you will need to created a public_html directory under the user's home directory to that the user can display their web pages. Go to
/home/<your user> and write mkdir public_html you will need to change the permissions of the user's home directory along with the user's public_html directory. The home directory requires permission 711, while the user's public_html directory requires permissions 755. Do this recursively using the -R option. Move to home directory and type this command chmod 711 -R Alberz now type this command chcon R t httpd_sys_content_t Alberz Move to <User name> directory in my case it is Alberz and type this command chmod 755 -R /public_html (Remove / ) then use this command from the same prompt and under same directories. chcon R t httpd_sys_content_t public_html The tricky bit is that Fedora has new security content with users' public_html directories. You can hange it with the chcon command. Type in the command below otherwise ay changes is done after the commands above. If everything works ok, you will not receive any sort of Messages from linux. Open u browser and write http// alberz/~<your user> Note: Don t forget to put tilda sign (~) before typing username in above URL.
2.2 PHP The chances are that when you installed Apache you would have automatically installed PHP as well. Open a terminal window and type the following then you know that PHP is installed. Actually PHP is installed along with php-pear and php-ldap. And this is what we need. Try these commands on terminal as a root user Rpm qa grep i php Don t specify -i option with the above command: should be like Rpm -qalgrep -i php and then locate for these files from the list of files files after executing this command:phppear,php-mysql, php (version number),php-idap. Otherwise you have to install this package as I wrote above. But first check if it works. Under public_html crete a file phptest.php and write: <?php phpinf();?> and save it..
Open browser and write http// alberz/~<your user>/phptest.php if u can se php version and other information so that s good. PHP is working. 2.3 MySQL First check if you have MySQL on your system rpm qa grep I mysql
if u don t have it go to System Settings -> Add/Remove Applications. Find the section for Database Server and make sure you select the right package. Once you have done this, perform another package check for MySQL.
At this stage MySQL has not been started as a service so you will need to start it using the Service Configuration. Recall that this was also the case with Apache! So open Service Configuration and select MySQL. Don't forget to SAVE the new configuration. Now start MySQL. It should now be running as a service. Don't forget to SAVE the new configuration!
The next step is to create a root password for MySQL root user. Open a terminal window and at a command prompt type mysqladmin -u root password '<your password>' We are using MySQL's powerful mysqladmin command to set a root password. It s good do this! Once you have set the root password for the MySQL server you can now log into the MySQL database server. Open a terminal window and type mysql -u root -p The screen dump below should be displayed.
Notice that the prompt changes to mysql>. This means you are now logged into the MySQL server. To exit the server type \q or ctrl->x. Just like your Fedora machine we only use the root account for MySQL for administrative purposes. So your next step is to create a MySQL user account and a database for the new MySQL user. Because this installation is for Freemed. We have to create this user for freemed and name the database for this user. I am going to create a new database called freemed for root for the momemt. If there are another user like alberz who want to have this database then you have to give tis user permissions and It's not necessary that the user have the same username/password as the Linux username /password but it make your ever increasing password list just a bit shorter. Root have FULL ACCESS to the database freemed, that means he can edit, delete, alter etc. the database. Open a text editor(gedit) and type the following: FLUSH PRIVILEGES; DROP DATABASE IF EXISTS freemed; CREATE DATABASE freemed; GRANT ALL ON freemed.* TO root@localhost IDENTIFIED BY ''; GRANT ALL ON freemed.* TO root@'%' IDENTIFIED BY ''; Save it as mysql_createfreemeddatabase.sql under root folder and then log on mysql under root and write: \. createfreemeddatabase.sql to create this database.
2.4 FreeMed As I said before there are two versions of FreeMed software: o TeleMed Group Software o FreeMed Default Software In this tutorial I m going to install our product, TeleMed Group Software, which is a further developing software from FreeMed Default Software. The needed files are: First you have to download the zip file of FreeMed software from our homepage or FreeMed Product CD for Linux. After that you have to download the new FreeMed database. Log on your linux system as root or user and download these zip files. I have created a folder freemedsoftware under /home/<your user>/public_html and downloaded everything there. After you did it you have to unpack these to files. You can do that under the same folder: /home/<your user>/public_html/freemedsoftware
Move the freemed folder from /home/<your user>/public_html/freemedsoftware to /home/<your user>/public_html/ and now you have this structure for this software> /home/<your user>/public_html/feemed. Go to freemed\lib and open settings.php to edit this rows. define ('INSTALLATION', "Stock FreeMED Install"); // installation name define ('DB_HOST', "localhost"); // database (SQL) host location define ('DB_NAME', "freemed"); // database name define ('DB_USER', "root"); // SQL server username define ('DB_PASSWORD', ""); // SQL server password define ('PHYSICAL_LOCATION', "c:/apache/htdocs/freemed"); PHP needs more memory for starting this application. Go to php-configuration file under php folder. And change memory_limit from 8M to 64M or 200M in some case.
Open your browser and write: http//localhost/~<your user>/index.php First time you have to register yourself. Database Username : root Database Password : <<anything here>> Admin Account Password : admin Confirm Admin Account Password : <<write any password you want>> After that every time you want to access freemed you have to write your account information. In my case: Username: <<your Admin Account Password >> Password: <<your Confirm Admin Account Password>>
Now you can access freemed but we are not clear with freemed database yet so you can t access any data from freemed databse. Now you have to stop mysql database. There are different way to stop mysql. If you have followed these instructions you have installed mysql as service and now you have to stop this service. Go to Root/sbin/ and stop the mysql service with: service mysqld stop and now go to /home/<your user>/public_html/freemedsoftware and copy all files from there. Go to Root/Var/bin/mysql/freemed/ and overwrite thede files there because we have already some of these file with old versions there.
Now you have to access everything