Installation and Operation Manual
: http://gdl.itb.ac.id
: http://gdlhub.IndonesiaDLN.org
Ganesha Digital Library
(GDL Version 4.0)
KMRG
Source
Hub
Institut Teknologi Bandung
YLTI
Supported by YLTI and IDRC
Vision and Objectives
Vision:
Becoming the bridge for the digital
divide and knowledge sharing
among local communities.
Mission:
Unlock access to the
local communities’
knowledge.
The Use of GDL4.0

GDL4.0 can be used for the following purposes:






Managing scholar resources: theses, dissertations,
research reports, journal, publication, etc.
Promoting the SME’s products: E-Mall (currently the etransaction is not supported).
Managing the art work and heritage resources: pictures,
songs, videos, etc.
Managing the expertise directory of people and
organizations.
Etc.. You can extend the metadata schema for other
purposes easily.
And the most important, develop distributed knowledge
respository network.
Table Of Contents






Installation Manual
 Getting the source code & the file system structure
 Fresh Installation
 Virtual Host Installation
Getting Started
Registering the Node
 Introduction to NeONs (Network of Networks)
 Registering Node
 Generate Node Configuration Data
 Edit Node Configuration
Modification
 Language
 Header and interfaces
 Add New metadata schemas
Operation Manual
 User
 Administrator
Synchronization
 Export & Import
 Connect, Send & Receive Records
Installation Manual
YLTI
Getting The Source Code

Files:




Download:


http://gdl.itb.ac.id
CD-ROM:


Gdl40-nt-xp-xxx.zip
Gdl40-win98-xxx.zip
Gdl40-htdocs-xxx.zip
Send order to KMRG ITB,
[email protected]
GDL Directory Structure:

See this picture 
Windows > Fresh Installation (1)

Installation files:



Gdl40-win98-xxx.zip for Windows 98
Gdl40-nt-xp-xxx.zip for Windows NT, 2000, and XP.
Directory structure of the archive:

C:\gdl40\

Apache\





…
htdocs\  contain the GDL4.0 scripts.
…
Mysql\
PHP\
Windows > Fresh Installation (2)

Installation steps:



Extract the installation (zip) file according to your Windows
version, to C:\ directory.
Browse the C:\gdl40\ directory, like this figure.
Click ‘install.bat’ to start installation.


Starting the GDL Server:


Click the ‘gdlstart-nt.bat’ file to start the
Apache and MySQL server.
Stopping the GDL Server:


This will copy ‘expat.dll’ and ‘sablot.dll’
to the system32 directory, and create
c:\tmp directory.
Click the ‘gdlstop-nt.bat’ file to stop
the server.
You may create shortcut for both files on
your desktop.
Windows > Fresh Installation (3)
Open address http://localhost/
Do you cee dis
page?
Congratulation
!!
Linux/Windows > Virtual Host Installation (1)

Requirements:



Assumptions:



Windows or Linux RH 7.0
Other OS: you need to recompile SWISH-E according to
your OS platform, then copy it to ./bin/ directory.
Your PC already has had Apache, MySQL, and PHP
installed.
You want to create new DL site (virtual host), e.g.
http://digilib.acme.org.
Steps:

Extract ‘gdl40-htdocs-xxx.zip’ to virtual host document
root, such as at ‘htdocs-gdl40’.
Linux/Windows > Virtual Host Installation (2)

Steps (cont’d):



Configure your apache.conf to include the new virtual
host (not discussed).
Configure your DNS for new virtual host (not discussed).
Configure GDL database connection file:



File: conf/dbconn.inc
Set variables: dbhostname, dbuser, dbpassword, and
dbname according to your existing installation.
Configure GDL system configuration file:


File: conf/system.conf
Important variable sections for modification:





Operating system
Application & Network
Proxy
Collection_folder
Default language
Linux/Windows > Virtual Host Installation (3)

Steps (cont’d):


Restart your
web server.
Install database
for the first time:


Open web
browser.
Open
http://digilib.acme.org
Do you cee
dis page?
Good, pollow the
instruction there!
Linux/Windows > Virtual Host Installation (4)
Congratulation!!
Now you can use
your new DL
selvel. Don’t wolly
with dis initdb.php
page. I have lock it
for next uses.
Happy?
Getting Started
YLTI
Getting Started
Login
Search
Category tree
address
Browse Categories
Login
Login: [email protected]
Password: superuser
Node List under a Network
Network name
Click Node ID for
local browsing
Click Node Name for direct
access to the remote Node
server
Browse Collections
conf/system.conf:
$conf[collection_folder]
This is the Root Folder
Name to store
collections from other
Nodes. Don’t store your
folder and metadata
under this folder.
Network name
Network name
Other Node ID
List of Metadata Titles
List of metadata titles under
current category tree
Read Metadata
Click Upload/Update to modify
the metadata and files
Click this icon to
download the file
Hei, can you see my
dad?
Quick Search
Quick Search to all
collection types
Advanced Search for
each collection type
Search result using
different display
format for each
collection type
Search powered by
SWISH-E
Instruction to update
the Search Index file
Advanced Search
Advanced Search for
Organization collection
type
Query formula passed
to the SWISH-E
User Registration
After submitting the
form, user will receive
Activation Code via
email (if server support
SMTP).
User Account Activation (1)
Activation by User, by
entering account
(email) and the code.
User Account Activation (2)
Change Status to
Active.
Activation by
Administrator.
Registering the Node
YLTI
Introduction to NeONs

This GDL4.0 version support the development of
NeONs, Network of Networks.
Human
Rights
Children
Heritage
Agriculture
ETD
Central
Hub
Schools
Health
Environmen
t
Religion
Configuration of a Network (Cluster)
Human
Rights
Childre
n
Heritag
e
Agricul
ture
ETD
Central
Hub
School
s
Health
Environ
ment
Religio
n
Hub Server
DL Network
UNCEN
ITB
IAIN
Institution
Internet Cafe
Unsyiah
UMM
Binus
UAJ
IPB
UNHAS
personal
System Configuration Setting

System Configuration setting:




Edit the system configuration file: conf/system.conf.
$conf[neon_name] = Name of the Mother Network
(alphanumeric, no space). Example: IDLN
(IndonesiaDLN).
$conf[network] = Name of the Cluster Network
(alphanumeric, no space). Example: ETD (Electronic
Theses and Dissertation).
$conf[role] = HUB. Role of the server, set as HUB server
for the Cluster Network. For nodes, set as NODE.
Register New Node at Hub Server
Click this icon to add
new Node
As Superuser, click
Menu, then click
Publisher
Serial Number is
generated
automatically. Change
the Cluster Network
name (e.g. GENERAL)
according to the
Network name.
Publishers Table at Hub Server
Click the ‘mail’ icon to
generate Node
configuration data.
Generate Configuration for Node
Copy this configuration and
send to Node administrator.
At the Node side, copy
this portion of the
publisher configuration.
To edit publisher
configuration file, click:
Tools & Configuration
 Configure Your
Server Registry
Set The Publisher/Node Configuration File
Copy and Paste your
publisher configuration data
in to this form. After you
submit, file ‘conf/publisher.ini’
will be updated.
Organization identity will be
set automatically using this
configuration.
Modification
YLTI
Language (1)


You can add new language for the interface.
Currently only languages that use Roman script
are supported.
Edit the language configuration file:
languages/lang.cfg.
Add your language
here. Language ID
should be maximum
3 characters long.
Language (2)


Create new directory which is the same with the
language ID.
Create these files:






form-options.inc
info-export.inc
[langID].inc
error_[langID].inc
help_[langID].inc
Just learn and follow the
existing sample.
Language (3)

Edit file src/box_search.inc to display the
language switch for user.
Tools & Configuration
Click Menu > Tools
& Configuration >
Setting Other
Options.
You can set
language, page
caching, browse &
search display, and
the trusted host.
List of languages is
generated
automatically from
the lang.cfg
configuration file.
Header Images



You can change the header image using your
institution logo.
Create new header image, and copy to costumize/
directory.
Edit the header.inc file and change the image file
name.
Height must be 65
pixels.
Width is not specified.
Metadata Schemas
This installation comes
with four pre-defined
metadata schema.
You can ADD your own
metadata schema.
The metadata and files
upload steps.
Schema Configuration Files
Each metadata schema requires the
following files (at schemas/
directory):
 XML Template:



Entry Forms:




form_upload_[schema].inc
form_upload_[schema]_validate.
inc
Add schema link in this file:
form_upload_selection.inc.
Detail Display:


[schema].xml
[schema].xml-values.inc
box_metadata_[schema].inc
Advanced Search:


Edit search.cfg.
result_[schema].inc
Schema XML Template
Example of XML Template
Example for dc_article
schema. This template
is used to render the
metadata XML to be
stored in the XMLDATA
field of the
METADATA_XML table.
Can you see the similarity
beween Element Name
and Element Value
Template?
For example:
<subject><keywords> 
#SUBJECT_KEYWORDS#
Table Structure for Metadata
The XMLDATA field of
the METADATA_XML
table is used to store
ALL OF METADATA in
XML format. So that,
new metadata schema
will not require new
table or fields.
Operation Manual
YLTI
Repository Explorer
Current address of the
category tree.
New…
Click here to create new
category or upload new
metadata under current
Address.
Create Root Folder for Organization Lists
Create Root Folder for
Organization lists
Create Folder for New organization
Create Folder for new
organization. Don’t
forget to set the
Type=organization.
Organization List in the Metadata Form
Organization folder
automatically listed here.
Upload New Metadata (1)
Select the Metadata
Form Schema.
Upload New Metadata (2)
Upload New Metadata (3)
Set number of files to be
uploaded related to this
metadata.
Upload File (1)
Select the file, give
description, and then
click Upload button.
Upload File (2)
Icon of the successfully
uploaded file.
Show Metadata Detail
Click the metadata
identifier in the Address
box to print the detail.
Click Upload/Update to
modifiy the metadata and
files
Updating Search Index File
SWISH-E is not
automatically index any
new metadata records.
The administrator must
perform indexing
manually or set the cron
job for it.
Indexing on Windows
Using command line, go
to bin/ directory of your
DL server, and execute
command ‘progidx.bat’.
You can see the
indexing process.
Synchronization
YLTI
Export Metadata to a Compressed File
As administrator, click:
Menu > Export & Import.
Click Export Metadata to
export local metadata to
a compressed file.
Give Metadata Archive to other Nodes
You can download the compressed
metadata archive, and then send to
Hub server, other Nodes server, or
you friends.
It’s handy, using Floppy, CD-ROM, or
Email.
Import Other Nodes Metadata Archives
Select and upload the
compressed
metadata archive
from other Nodes or
Hub server.
Click import to start
importing the
associated
metadata archive
file.
Importing Progress…
Setting Synchronization Options
Set the remote server name that will
be connected. Note: The target server
should have record about your server
publisher configuration, including the
Serial Number. Other wise, it will not
recognize your server.
Connect
Experimental:
Connecting to Agri Hub
Server.
If Success, the following
message will be displayed.
Harvesting Node (Publisher) Records
It is recommended to
harvest publisher data
frequently before perform
Send/Receive Metadata
records
Harvesting
progress bar…
Send/Receive Metadata Records (1)
If Outbox is 0, then
continue with
Harvesting
Metadata.
Send/Receive Metadata Records (2)
Harvesting
progress bar…
Result: Collection from Other Nodes
Collection from other
Nodes of GENERAL
Cluster Network at
IndonesiaDLN
More Information

Knowledge Management Research Group ITB



IndonesiaDLN






[email protected]
http://www.kmrg.itb.ac.id
Contact General Secretary: Arif Rifai Dwiyanto
[email protected]
Mailing list: [email protected]
http://www.IndonesiaDLN.org (Official web site)
http://gdlhub.IndonesiaDLN.org (Hub server)
Swish-E


Index and Search engine application
www.swish-e.org
Author

Ismail Fahmi


[email protected]
http://netmon.itb.ac.id/~ismail
Don’t forget your family while coding…
Descargar

Recommending a Strategy