Pada tulisan kali ini, instalasi OpenAdmin disini akan membahas bagaimana untuk setting database yang diperlukan untuk OpenAdmin.
Database yang digunakan adalah MySQL. Disini diasumsikan bahwa MySQL sebelumnya sudah terinstall dengan baik dan sudah berjalan untuk service-nya.

Berikut adalah langkah yang diperlukan untuk setting database OpenAdmin :
1. Buat database untuk OpenAdmin sekolah anda
# mysqladmin -u root -pMySQLRootPassword create NamaDBSekolah

2. Create table untuk database anda menggunakan file blank.mysql.325 yang ada di folder utility OpenAdmin
# cd /tmp/openadmin-3.25/utility/sql
# mysql -u root -pMySQLRootPassword NamaDBSekolah < blank.mysql.325
Jika sukses anda dapat mencoba untuk masuk ke command mysql, dan melihat tables-nya
# mysql -u root -pMySQLRootPassword NamaDBSekolah
mysql > show tables; (sampai tahap ini anda harusnya dapat melihat table - table yang ada di database tersebut
mysql > quit;


3. Update data dictionary untuk database meta data
# mysql -u root -pMySQLRootPassword NamaDBSekolah < meta250.sql.CDN

4. Reload configurasi MySQL anda & Restart service MySQL anda
# mysqladmin -u root -pMySQLRootPassword reload
# /etc/rc.d/rc.mysqld restart


Sampe pada tahap ini, instalasi OpenAdmin anda harusnya berjalan dengan baik.
Selamat mencoba

Referensi :
http://richtech.ca/openadmin/
http://minitutorials.com/apache/apache_222_3.shtml
http://forums.fedoraforum.org/showthread.php?t=179896

Tulisan ini adalah lanjutan tahap instalasi OpenAdmin School.
Pada part 2 akan dibahas bagaimana mengkonfigurasi web server yang diperlukan untuk menjalankan OpenAdmin.
Untuk keperluan web server saya menggunakan apache, dan tulisan ini adalah panduan bagi yang menggunakan apache sebagai aplikasi web server-nya.

Ok langsung saja, berikut adalah langkah – langkah konfigurasi Apache sebagai web server untuk OpenAdmin :
1. Edit konfigurasi dari apache anda
# vim /etc/httpd/httpd.conf

2. Berikan comment pada entry berikut sehingga entry tersebut diabaikan (cek tiap entry dari httpd.conf dari atas ke bawah tambahkan yang tidak ada dan edit jika sudah ada ) :
#DocumentRoot "/srv/httpd/htdocs"

#<Directory />
# Options FollowSymLinks
# AllowOverride None
# Order deny,allow
# Deny from all
#</Directory>


#<Directory "/srv/httpd/htdocs">
# Options Indexes FollowSymLinks
# AllowOverride None
# Order allow,deny
# Allow from all
#</Directory>


Berikut adalah entry yang perlu anda tambahkan :
<IfModule dir_module>
DirectoryIndex index.html index.shtml index.php
</IfModule>


DefaultType text/plain
<IfModule mime_module>
AddType text/html .shtml
AddHandler server-parsed .shtml
AddOutputFilter INCLUDES .shtml
</IfModule>


# School hosts
Include /etc/httpd/httpd-school.conf
Include /etc/httpd/mod_php.conf

3. Copykan file httpd-school.conf yang terletak di folder utiliy dari OpenAdmin ke dalam direktori dari konfigurasi apache anda.
# cp /tmp/openadmin-3.25/utility/httpd-school.conf /etc/httpd

4. Berikut ini adalah isi dari httpd-school.conf milik saya, sesuaikan dengan kepunyaan anda :
NameVirtualHost *:80

# Start of Admin Site
<VirtualHost *:80>
ServerAdmin me@mysite.net
DocumentRoot /opt/openadmin/namasekolah/admin
ServerName namasekolaha.namasekolah.com


AddType text/html .shtml
AddHandler server-parsed .shtml
DirectoryIndex index.shtml


ErrorLog /var/log/httpd/namasekolaha-error_log
CustomLog /var/log/httpd/namasekolaha-access_log commom
ScriptAlias /cgi-bin/ "/opt/openadmin/namasekolah/cgi/"
<Directory /opt/openadmin/namasekolah/admin>
AuthType Basic
AuthName "Admin"
AuthUserFile /etc/httpd/auth_users/namasekolahadmin
Require valid-user
</Directory>


<Directory /opt/openadmin/namasekolah/cgi>
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>


</VirtualHost>
# End of Admin Site


# Start of Teacher Site
<VirtualHost *:80>
ServerAdmin me@mysite.net
DocumentRoot /opt/openadmin/namasekolah/tadmin
ServerName namasekolaht.namasekolah.com


DirectoryIndex index.shtml

ErrorLog /var/log/httpd/namasekolaht-error_log
CustomLog /var/log/httpd/namasekolaht-access_log common
ScriptAlias /cgi-bin/ "/opt/openadmin/namasekolah/tcgi/"


<Directory /opt/openadmin/namasekolah/tadmin>
AuthType Basic
AuthName "Teacher"
AuthUserFile /etc/httpd/auth_users/namasekolahteacher
require valid-user
</Directory>


<Directory /opt/openadmin/namasekolah/tcgi>
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
# End of Teacher Site


# Parent Site
<VirtualHost *:80>
ServerAdmin me@mysite.net
DocumentRoot /opt/openadmin/namasekolah/padmin
ServerName namasekolahp.namasekolah.com


<Directory /opt/openadmin/namasekolah/padmin>
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

<Directory /opt/openadmin/namasekolah/pcgi>
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
ErrorLog /var/log/httpd/namasekolahp-error_log
CustomLog /var/log/namasekolahp-access_log common
ScriptAlias /cgi-bin/ "/opt/openadmin/namasekolah/pcgi/"
</VirtualHost>
# End of Parent Site.

4. Buat user untuk admin access dan teacher access, menggunakan htpasswd
# mkdir /etc/httpd/auth_users
# htpasswd -c [NamaFile] [Username]
contoh :
# htpasswd -c namasekolahadmin admin
# htpasswd -c namaskolahteacher teacher1
Perhatikan opsi -c disini, anda hanya perlu menggunakan opsi -c jika file tersebut belum ada dan baru akan pertama kali dibuat, untuk berikutnya anda hanya perlu menggunakan command seperti ini untuk menambah user menggunakan htpasswd :
# htpasswd namasekolahadmin admin2
# htpasswd namasekolahteacher teacher2

5. Edit file /etc/hosts, agar sesuai dengan keperluan OpenAdmin
# vim /etc/hosts
Tambahkan entry berikut ini :
192.168.0.1 namasekolaha.namasekolah.com
192.168.0.1 namasekolaht.namasekolah.com
192.168.0.1 namasekolahp.namasekolah.com

6. Jika sudah selesai, restart service apache anda
# /etc/rc.d/rc.httpd restart

selamat mencoba

OpenAdmin School adalah sebuah program administrasi sekolah berbasis web yang bersifat open source.
OpenAdmin menggunakan bahasa perl untuk pemrogramannya, jadi anda mungkin akan memerlukan perl terinstall dengan baik di Linux anda.
Untuk menggunakan OpenAdmin, setidaknya mesin Linux anda sudah harus ada beberapa program berikut :
- Apache
- Perl
- Mysql atau Postgresql
- Tex and PdfLatex (PDFLatex secara default sudah terinstall di distro Slackware)
Saya menggunakan distro Slackware 12.1 dan semuanya sudah terinstall secara default.
Untuk database saya menggunakan MySQL.

Berikut adalah langkah – langkah untuk install OpenAdmin School :
1. Download paket openadmin disini, versi paling baru saat tulisan ini dibuat adalah openadmin-3.25

2. Download perl modules yang diperlukan berikut disini, dan extract filenya :
- CGI
- DBI
- Text::CSV_XS
- XML::LibXML
- Date::Business
- Time::JulianDay
- FreezeThaw (install ini sebelum CGI::Session)
- CGI::Session
- Data::Password
- Crypt::GeneratePassword

3. Installkan perl modules yang sudah anda download dengan command berikut :
# cd /[path]/[to]/[perlmodules]
# perl Makefile.PL
# make
# make test
# make install


4. Pindahkan hasil download openadmin anda tersebut, misal ke /tmp dan lakukan extract disana
# cp /[path]/[to]/OA325-1218786932.tgz /tmp
# cd /tmp
# tar -xzvf OA325-1218786932.tgz

5. Masuk ke direktori hasil extract tadi
# cd /tmp/openadmin-3.25
Lihat di dalam folder ini, terdapat beberapa folder, dan kita hanya akan gunakan untuk folder school (yang akan menjadi folder untuk sekolah anda) dan folder global (untuk settingan global)

6. Buat direktori untuk file openadmin untuk situs sekolah anda, biasanya untuk default-nya gunakan saja di dalam direktori /opt
# mkdir /opt/openadmin

7. Pastikan anda saat ini anda berada di dalam direktori tempat anda melakukan extract dari openadmin tadi yang terletak di /tmp, lalu kopi-kan folder school ke dalam /opt/openadmin lalu diikuti dengan nama sekolah anda.
# cp -R /tmp/openadmin-3.25/school /opt/openadmin/namasekolah (ganti namasekolah dengan nama dari sekolah anda)


8. Kopikan settingan global ke direktori /opt/openadmin
# cp -R /tmp/openadmin-3.25/global /opt/openadmin/

9. Ganti permission dan owner dari direktori sekolah anda, untuk owner ganti menjadi user apache dan group apache untuk distro slackware
# chown -R apache:apache /opt/openadmin/global
# chown -R apache:apache /opt/openadmin/namasekolah
# chmod -R 755 /opt/openadmin/global
# chmod -R 755 /opt/openadmin/namasekolah
# chmod -R 777 /opt/openadmin/namasekolah/admin/download
# chmod -R 777 /opt/openadmin/namasekolah/tadmin/download


10. Copy Logo dari sekolah anda ke directory /opt/openadmin/namasekolah/admin/images dan beri nama menjadi logo.gif (Harus dalam format GIF)

11. Edit konfigurasi dari file admin.conf yang terletak di direktori /opt/openadmin/namasekolah/etc
# vim /opt/openadmin/namasekolah/etc/admin.conf
Berikut adalah contoh dari admin.conf (saya hanya menampilkan beberapa entry yang perlu anda edit ) :
# Basic Constants for the database
$user = 'UsernameDatabaseOpenAdmin';
$password = 'PasswordDatabase';
$dbase = 'NamaDatabase';
$dbtype = 'mysql'; # mysql or Pg (postgresql; watch case!)

# CGI areas - normal file paths; cgi is main admin, tchcgidir is teacher
# These are the pathnames ON YOUR SERVER! (not part of the URL)
$cgidir = '/opt/openadmin/namasekolah/cgi';
$tchcgidir = '/opt/openadmin/namasekolah/tcgi';
$parcgidir = '/opt/openadmin/namasekolah/pcgi';

# CGI URL's - for self referencing scripts
# part of Apache configuration, not server filesystem.
$cgiurl = '/cgi-bin';
$tcgiurl = '/cgi-bin';

# Picture Directories and URL's
# dir is actual filesystem pathname, url is apache config.
$picdir = '/opt/openadmin/namasekolah/admin/pic-big';
$picdirurl = '/pic-big';

# Picture area for thumbnails
$tndir = '/opt/openadmin/namasekolah/admin/pic-sm';
$tndirurl = '/pic-sm';

# Full path to download folders; used by scripts to copy files there.
# Actual pathname ON YOUR SERVER!
$downloaddir = '/opt/openadmin/namasekolah/admin/download';
$tchdownloaddir = '/opt/openadmin/namasekolah/tadmin/download';

# Web location of download (put into URL)
# Apache configured values. Part of the URL.
$webdownloaddir = '/download';
$tchwebdownloaddir = '/download';

# CSS File locations and name
$css = '/admin.css';
$tchcss = '/tadmin.css';
$parcss = '/padmin.css';

# Location of global config file to integrate school databases.
# Actual filesystem location of the file ON YOUR SERVER.
$globdir = '/opt/openadmin/global';

# Path for PDFLatex Executable
$pdflatex = "/usr/share/texmf/bin/pdflatex"; (DEFAULT LOKASI PDFLATEX DARI SLACKWARE)

# The school year;
$schoolyear = "2008-2009";
$schoolstart = "2008-08-28";
$schoolend = "2009-06-27";

Sampe pada tahap ini Part 1 dari instalasi Openadmin sudah selesai, part selanjutnya akan segera saya buat dalam tulisan saya berikutnya