Installing elementalClinic in 5 minutes.

Submitted by Alex Kroman on Fri, 01/09/2009 - 14:49

We've been hard at work this week making the installation of elementalClinic easier. It used to take a lot of Linux knowledge to get emC set up for your clinic but this week we've released it as an Ubuntu Hardy package so if you're comfortable installing applications in Linux you should be able to get it up and running in less than 5 minutes.

Here's how you can get it running:

GPG Key Import

Before using the repository the GPG key must be imported into your local apt GPG keyring.

wget -q -O- http://svn.opensourcery.com/public/ubuntu/87CB6495.gpg | sudo apt-key add -

Add our Ubuntu Repository

Edit your /etc/apt/sources.list file and add the following line at the bottom.

deb http://svn.opensourcery.com/public/ubuntu hardy main

Installing elementalClinic

sudo aptitude update
sudo aptitude install elementalclinic

Initialize the database

createuser elementalclinic
createdb elementalclinic
psql elementalclinic < /usr/share/database/testdata-jazz.sql

Edit the configuration file /etc/elementalclinic/config.yaml

replace DATABASE with elementalclinic
replace USER with elementalclinic
replace PASSWORD with elementalclinic

Edit /etc/hosts and add:

127.0.0.1 elementalclinic

Enable the Apache vHost

sudo a2ensite elementalClinic.conf
sudo /etc/init.d/apache2 reload

You can now visit the site at:

http://elementalclinic

How to upgrade to most recent version

sudo aptitude safe-upgrade
sudo perl /usr/share/elementalclinic/bin/migration.pl

Hopefully this guide helped you to get elementalClinic running. Please feel free to shoot me an email if you have any questions.

Comments

Repository install doesn't work

Submitted by Visitor on Sat, 01/31/2009 - 12:09.

Unfortunately, trying to use the new (and potentially cool) repository install is not working for me. I tested on a Hardy Kubuntu machine via both the Adept Manager and the recommended aptitude command. Both result in Broken installs. Here's the message from the aptitude attempt:

Reading package lists... Done
Building dependency tree
Reading state information... Done
Reading extended state information
Initializing package states... Done
Writing extended state information... Done
Building tag database... Done
The following packages are BROKEN:
elementalclinic
The following NEW packages will be automatically installed:
libappconfig-perl libbit-vector-perl libcarp-clan-perl libcgi-session-perl libcgi-validop-perl libcompress-raw-zlib-perl
libcompress-zlib-perl libdata-optlist-perl libdata-transformer-perl libdate-calc-perl libdate-manip-perl libdbd-pg-perl
libdevel-stacktrace-perl libdevice-modem-perl libdevice-serialport2-perl libdigest-sha-perl libexpect-perl
libio-compress-base-perl libio-compress-zlib-perl libio-pty-perl libio-stty-perl libipc-shareable-perl libjson-perl
liblist-moreutils-perl liblog-dispatch-filerotate-perl liblog-dispatch-perl liblog-log4perl-perl libparams-util-perl
libparams-validate-perl libpdf-reuse-perl libsub-exporter-perl libsub-install-perl libtemplate-perl libx12-parser-perl
libyaml-syck-perl
The following NEW packages will be installed:
libappconfig-perl libbit-vector-perl libcarp-clan-perl libcgi-session-perl libcgi-validop-perl libcompress-raw-zlib-perl
libcompress-zlib-perl libdata-optlist-perl libdata-transformer-perl libdate-calc-perl libdate-manip-perl libdbd-pg-perl
libdevel-stacktrace-perl libdevice-modem-perl libdevice-serialport2-perl libdigest-sha-perl libexpect-perl
libio-compress-base-perl libio-compress-zlib-perl libio-pty-perl libio-stty-perl libipc-shareable-perl libjson-perl
liblist-moreutils-perl liblog-dispatch-filerotate-perl liblog-dispatch-perl liblog-log4perl-perl libparams-util-perl
libparams-validate-perl libpdf-reuse-perl libsub-exporter-perl libsub-install-perl libtemplate-perl libx12-parser-perl
libyaml-syck-perl
0 packages upgraded, 36 newly installed, 0 to remove and 0 not upgraded.
Need to get 7482kB of archives. After unpacking 32.3MB will be used.
The following packages have unmet dependencies:
elementalclinic: Depends: libtest-taint-perl which is a virtual package.
Resolving dependencies...
The following actions will resolve these dependencies:

Keep the following packages at their current version:
elementalclinic [Not Installed]

Score is -9879

Accept this solution? [Y/n/q/?

> Dan Evans, Seattle

Install comments

Submitted by Visitor on Mon, 04/06/2009 - 19:59.

Great work Alex. Here are some comments to make the process even more user friendly.

Begin with: Install Hardy 8.04.2 LTS
Install apache2, postgresql, modules (such as libapache2-mod-perl2, libpg-perl, you know, whatever makes them integrate and function.)
I believe perl is in the base install for Hardy.

Now do the GPG Key Import and svn download.

Under "Initialize the database" begin with *sudo su postgres*
last step * psql elementalclinic < /usr/share/elementalclinic/database/testdata-jazz.sql*
Then *exit*

Next under enable Apache vHost
sudo a2ensite elementalclinic.conf must use a lowercase c

2 remaining problems
My virtual host won't run CGI scripts
User elementalclinic is created without a password but the config.yaml supplies a password. Can this work?

This install is way much better than the old instructions. thanks so much.
Jack Cahn

Client-server install - it works!

Submitted by Visitor on Sat, 04/18/2009 - 07:28.

Here is a network (server:client) install of emC for those who don't want to deal with installation and config of the dependencies of apache, perl and postgresql. It is based on ubuntu Hardy 8.04.2. It also has a low server overhead (no kde or gnome).

First download and burn this .iso:
http://www.turnkeylinux.org/appliances/lapp
or
wget http://hivelocity.dl.sourceforge.net/sourceforge/turnkeylinux/turnkey-la...

Install the appliance on your server. There are prompts for passwords.

After install use the "Advanced Menu" to assign a fixed IP address (no reboot).

Everything else is from your workstation
ssh root@[IPaddress]
apt-get update
apt-get upgrade
shutdown -r now
exit (ASAP)

Reconnect
ssh root@[IPaddress]
apt-get install wget gnupg aptitude
wget -q -O- http://svn.opensourcery.com/public/ubuntu/87CB6495.gpg | sudo apt-key add -
vim /etc/apt/sources.list.d/sources.list
Add to the end of file: deb http://svn.opensourcery.com/public/ubuntu hardy main
aptitude update

***this next part is so cool - nice going Alex***
aptitude install elementalclinic

su postgres
createuser -P -e -s elementalclinic (you will be prompted for a password - use elementalclinic)
createdb -O elementalclinic elementalclinic
psql elementalclinic < /usr/share/elementalclinic/database/testdata-jazz.sql
exit

Edit the configuration file:
vim /etc/elementalclinic/config.yaml
* replace DATABASE with elementalclinic
* replace USER with elementalclinic
* replace PASSWORD with elementalclinic

vim /etc/hosts
add the line
[server IPaddress] elementalclinic (you assigned a fixed IP address earlier. 127.0.0.1 will not work here)

a2ensite elementalclinic.conf (no uppercase letter)
/etc/init.d/apache2 reload

Extra step - this is not needed to function. If you don't want to see this message:
"Could not reliably determine the server's fully qualified domain name, using 127.0.1.1for ServerName"
then insert this line:

vim /etc/apache2/httpd.conf
ServerName foobox (or whatever)

Open your browser and go to http://[server IPaddress]

Maybe not 5 minutes but not bad!

Missing file: testdata-jazz.sql

Submitted by Visitor on Wed, 05/13/2009 - 15:58.

Sorry, I couldn't locate the following file:
/usr/share/database/testdata-jazz.sql
It's missing.

Is there any way to get it from somewhere?

Everything else went pretty smoothly. Thank you!

"(en) Please come back later" message

Submitted by Visitor on Wed, 05/13/2009 - 16:43.

I get the following message from emC when I access http://elementalclinic:

(en) Please come back later

I think this is because the testdata-jazz.sql was missing...