Dear List members,<br><br>Recently I was involved in setting up a federated library system using koha for African parliamentary libraries. See <a href="http://fpl.apkn.org/">http://fpl.apkn.org/</a><br>In this set up all the libraries (18) are using a single database<br>
<br>If you visit the particpating libraries found at <a href="http://fpl.apkn.org/">http://fpl.apkn.org/</a> you will notice that they all have there own look and feel as well as different addresses for both the opac and staff interface. For example the opac for the Parliament of Kenya library is accessed using <a href="http://ke.fpl.apkn.org">http://ke.fpl.apkn.org</a> and its staff interface is at <a href="http://ke.fpl.apkn.org:8080">http://ke.fpl.apkn.org:8080</a>; whereas the opac for the Uganda Parliamentary Library is accessed using <a href="http://ug.fpl.apkn.org">http://ug.fpl.apkn.org</a> and its staff interface is at <a href="http://ug.fpl.apkn.org:8080">http://ug.fpl.apkn.org:8080</a>. Using these addresses these libraries are able to search only their collection.<br>
<br>With this mail I intend to share with you how I achieved this, just in case someone may want to develop the same or even help me improve.<br><br>The illustration below is limited to the creation of a single participating library, however, the steps described were peroformed for all the 18 libraries. The default koha installation serves as the Federated Parliamentary Library interface<br>
<br>After successfully installing koha: <br><ul><li style="font-family: arial,helvetica,sans-serif;"><font size="2">I duplicate the perl scripts located in koha/opac/cgi-bin/opac and koha/intranet/cgi-bin/.</font></li><li style="font-family: arial,helvetica,sans-serif;">
<font size="2">I duplicated the templates located in /koha/opac/cgi-bin/opac/htdocs/opac-tmpl/prog/en/modules and koha/intranet/htdocs/intranet-tmpl/prog/en/modules</font></li><li style="font-family: arial,helvetica,sans-serif;">
<font size="2">I duplicated the files located in koha/opac/htdocs/opac-tmpl/prog/en/includes and koha/intranet/htdocs/intranet-tmpl/prog/en/includes</font></li><li style="font-family: arial,helvetica,sans-serif;"><font size="2">I duplicated the file opac.css located in koha/opac/htdocs/opac-tmpl/prog/en/css</font></li>
<li style="font-family: arial,helvetica,sans-serif;"><font size="2">I duplicated the file Auth.pm located in koha/lib/C4</font></li><li style="font-family: arial,helvetica,sans-serif;"><font size="2">I identified a two letter code to represent the individual libraries e.g. "ug" for Uganda and "ke" for kenya. These codes were also used in distinguishing the opac and staff interface URLs</font></li>
<li style="font-family: arial,helvetica,sans-serif;"><font size="2">I renamed all the duplicated files, adding the two letter code e.g. "ug" as a suffix to the file names i.e a file like <a href="http://opac-main.pl">opac-main.pl</a> becomes <a href="http://opac-mainug.pl">opac-mainug.pl</a>, masthead.inc becomes mastheadug.inc; opac-main.tmpl, becomes <a href="http://opac-mainug.pl">opac-mainug.pl</a> and opac.css becomes opacug.css</font></li>
<li style="font-family: arial,helvetica,sans-serif;"><font size="2">I edited all the renamed files and modified all links in each of them to reflect the new file names e.g. a reference to a file like /cgi-bin/koha/<a href="http://opac-search.pl">opac-search.pl</a> was modified to /cgi-bin/koha/<a href="http://opac-searchug.pl">opac-searchug.pl</a>; opac-bottom.inc was modifed to opac-bottomug.inc etc in all files in which it occurs</font></li>
<li style="font-family: arial,helvetica,sans-serif;"><font size="2">In the perl scripts I change C4::Auth; to C4::Authug; and C4::Auth qw; to C4::Authug qw; in all ocurances<br></font></li><li style="font-family: arial,helvetica,sans-serif;">
<font size="2">I created a new DNS record for the new library e.g <a href="http://ug.fpl.apkn.org">ug.fpl.apkn.org</a> for the Uganda Parliament Library and enabled the "Repeat this virtualhost stanza" found in /koha/etc/</font><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 12"><meta name="Originator" content="Microsoft Word 12"><link rel="File-List" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_filelist.xml"><link rel="themeData" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_themedata.thmx"><link rel="colorSchemeMapping" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_colorschememapping.xml"><style>
<!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;
mso-font-charset:0;
mso-generic-font-family:roman;
mso-font-pitch:variable;
mso-font-signature:-1610611985 1107304683 0 0 415 0;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-520092929 1073786111 9 0 415 0;}
@font-face
{font-family:Candara;
panose-1:2 14 5 2 3 3 3 2 2 4;
mso-font-alt:"Maiandra GD";
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-1610611985 1073783883 0 0 415 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-unhide:no;
mso-style-qformat:yes;
mso-style-parent:"";
margin:0cm;
margin-bottom:.0001pt;
text-align:justify;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Candara","sans-serif";
mso-fareast-font-family:Calibri;
mso-bidi-font-family:Candara;
mso-fareast-language:EN-US;}
.MsoChpDefault
{mso-style-type:export-only;
mso-default-props:yes;
mso-ascii-font-family:Calibri;
mso-fareast-font-family:Calibri;
mso-hansi-font-family:Calibri;}
.MsoPapDefault
{mso-style-type:export-only;
margin-bottom:10.0pt;
line-height:115%;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:70.85pt 70.85pt 70.85pt 70.85pt;
mso-header-margin:36.0pt;
mso-footer-margin:36.0pt;
mso-paper-source:0;}
div.WordSection1
{page:WordSection1;}
-->
</style><font size="2">koha-httpd.confSavitra's advice see <a href="http://old.nabble.com/Re%3A-Koha-as-a-federated-library-p28289266.html">http://old.nabble.com/Re%3A-Koha-as-a-federated-library-p28289266.html</a>) (thanks to </font></li>
<li style="font-family: arial,helvetica,sans-serif;"><font size="2">I created new virtual host entries for the new library opac and staff interfaces in </font><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 12"><meta name="Originator" content="Microsoft Word 12"><link rel="File-List" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_filelist.xml"><link rel="themeData" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_themedata.thmx"><link rel="colorSchemeMapping" href="file:///C:%5CUsers%5CAnselm%5CAppData%5CLocal%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_colorschememapping.xml"><style>
<!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;
mso-font-charset:0;
mso-generic-font-family:roman;
mso-font-pitch:variable;
mso-font-signature:-1610611985 1107304683 0 0 415 0;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-520092929 1073786111 9 0 415 0;}
@font-face
{font-family:Candara;
panose-1:2 14 5 2 3 3 3 2 2 4;
mso-font-alt:"Maiandra GD";
mso-font-charset:0;
mso-generic-font-family:swiss;
mso-font-pitch:variable;
mso-font-signature:-1610611985 1073783883 0 0 415 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-unhide:no;
mso-style-qformat:yes;
mso-style-parent:"";
margin:0cm;
margin-bottom:.0001pt;
text-align:justify;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Candara","sans-serif";
mso-fareast-font-family:Calibri;
mso-bidi-font-family:Candara;
mso-fareast-language:EN-US;}
.MsoChpDefault
{mso-style-type:export-only;
mso-default-props:yes;
mso-ascii-font-family:Calibri;
mso-fareast-font-family:Calibri;
mso-hansi-font-family:Calibri;}
.MsoPapDefault
{mso-style-type:export-only;
margin-bottom:10.0pt;
line-height:115%;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:70.85pt 70.85pt 70.85pt 70.85pt;
mso-header-margin:36.0pt;
mso-footer-margin:36.0pt;
mso-paper-source:0;}
div.WordSection1
{page:WordSection1;}
-->
</style><font size="2"> /koha/etc/koha-httpd.conf</font></li><li style="font-family: arial,helvetica,sans-serif;"><font size="2">I restarted the apache server</font></li><li style="font-family: arial,helvetica,sans-serif;">
<font size="2">I accessed the individual library opac e.g. the uganda Parliamentary library opac using <a href="http://ug.fpl.apkn.org">http://ug.fpl.apkn.org</a></font></li><li style="font-family: arial,helvetica,sans-serif;">
<font size="2">I created logo and banner images and transfered them to koha/opac/htdocs/opac-tmpl/prog/images and koha/intranet/htdocs/intranet-tmpl/prog/img</font></li><li><span style="font-size: 11pt; font-family: "Candara","sans-serif";"><font style="font-family: arial,helvetica,sans-serif;" size="2">I edited mastheadxx.inc, opacxx.css, loginxx.css and staff-globalxx.css to achieve required look and feel</font><br>
</span></li></ul>I hope this may help anyone who might need to achieve the same kind of library with koha.<br><br>I will be glad to provide any clarification and receive advise from you all.<br><br>Thanks <br><br>Anselm O<br>
<br>