Installation and Operation Manual Ganesha Digital Library (GDL Version 4.0) - PowerPoint PPT Presentation

Installation and operation manual ganesha digital library gdl version 4 0 l.jpg
1 / 70

  • Uploaded on
  • Presentation posted in: General

Installation and Operation Manual Ganesha Digital Library (GDL Version 4.0). Source : Hub : KMRG. Institut Teknologi Bandung . YLTI. Supported by YLTI and IDRC. Vision and Objectives. Vision:

I am the owner, or an agent authorized to act on behalf of the owner, of the copyrighted work described.

Download Presentation

Installation and Operation Manual Ganesha Digital Library (GDL Version 4.0)

An Image/Link below is provided (as is) to download presentation

Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author.While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server.

- - - - - - - - - - - - - - - - - - - - - - - - - - E N D - - - - - - - - - - - - - - - - - - - - - - - - - -

Presentation Transcript

Installation and operation manual ganesha digital library gdl version 4 0 l.jpg

Installation and Operation ManualGanesha Digital Library(GDL Version 4.0)

Source :

Hub :


Institut Teknologi Bandung


Supported by YLTI and IDRC

Vision and objectives l.jpg

Vision and Objectives


Becoming the bridge for the digital divide and knowledge sharing among local communities.


Unlock access to the local communities’ knowledge.

The use of gdl4 0 l.jpg

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 e-transaction 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 l.jpg

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 l.jpg

Installation Manual


Getting the source code l.jpg

Getting The Source Code

  • Files:




  • Download:


  • CD-ROM:

    • Send order to KMRG ITB,

  • GDL Directory Structure:

    • See this picture 

Windows fresh installation 1 l.jpg

Windows > Fresh Installation (1)

  • Installation files:

    • for Windows 98

    • 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 l.jpg

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.

      • This will copy ‘expat.dll’ and ‘sablot.dll’to the system32 directory, and createc:\tmp directory.

  • Starting the GDL Server:

    • Click the ‘gdlstart-nt.bat’ file to start theApache and MySQL server.

  • Stopping the GDL Server:

    • Click the ‘gdlstop-nt.bat’ file to stopthe server.

  • You may create shortcut for both files onyour desktop.

Windows fresh installation 3 l.jpg

Windows > Fresh Installation (3)

Open address http://localhost/

Do you cee dis page?

Congratulation !!

Linux windows virtual host installation 1 l.jpg

Linux/Windows > Virtual Host Installation (1)

  • Requirements:

    • 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.

  • Assumptions:

    • Your PC already has had Apache, MySQL, and PHP installed.

    • You want to create new DL site (virtual host), e.g.

  • Steps:

    • Extract ‘’ to virtual host document root, such as at ‘htdocs-gdl40’.

Linux windows virtual host installation 2 l.jpg

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/

      • 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 l.jpg

Linux/Windows > Virtual Host Installation (3)

  • Steps (cont’d):

    • Restart your web server.

    • Install databasefor the first time:

      • Open webbrowser.

      • Open

Do you cee dis page?

Good, pollow the instruction there!

Linux windows virtual host installation 4 l.jpg

Linux/Windows > Virtual Host Installation (4)


Now you can use your new DL selvel. Don’t wolly with dis initdb.php page. I have lock it for next uses.


Getting started l.jpg

Getting Started


Getting started15 l.jpg

Getting Started


Category tree address


Browse Categories

Login l.jpg


Login: superuser@localhost

Password: superuser

Node list under a network l.jpg

Node List under a Network

Network name

Click Node Name for direct access to the remote Node server

Click Node ID for local browsing

Browse collections l.jpg

Browse Collections



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 l.jpg

List of Metadata Titles

List of metadata titles under current category tree

Read metadata l.jpg

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 l.jpg

Quick Search

Advanced Search for each collection type

Quick Search to all collection types

Search result using different display format for each collection type

Search powered by SWISH-E

Instruction to update the Search Index file

Advanced search l.jpg

Advanced Search

Advanced Search for Organization collection type

Query formula passed to the SWISH-E

User registration l.jpg

User Registration

After submitting the form, user will receive Activation Code via email (if server support SMTP).

User account activation 1 l.jpg

User Account Activation (1)

Activation by User, by entering account (email) and the code.

User account activation 2 l.jpg

User Account Activation (2)

Change Status to Active.

Activation by Administrator.

Registering the node l.jpg

Registering the Node


Introduction to neons l.jpg

Introduction to NeONs

Human Rights





Central Hub





  • This GDL4.0 version support the development of NeONs, Network of Networks.

Configuration of a network cluster l.jpg

Configuration of a Network (Cluster)

Human Rights

Hub Server




DL Network


Central Hub















Internet Cafe


System configuration setting l.jpg

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 l.jpg

Register New Node at Hub Server

Click this icon to add new Node

Serial Number is generated automatically. Change the Cluster Network name (e.g. GENERAL) according to the Network name.

As Superuser, click Menu, then click Publisher

Publishers table at hub server l.jpg

Publishers Table at Hub Server

Click the ‘mail’ icon to generate Node configuration data.

Generate configuration for node l.jpg

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 l.jpg

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 l.jpg



Language 1 l.jpg

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 l.jpg

Language (2)

  • Create new directory which is the same with the language ID.

  • Create these files:



    • [langID].inc

    • error_[langID].inc

    • help_[langID].inc

  • Just learn and follow the existing sample.

Language 3 l.jpg

Language (3)

  • Edit file src/ to display the language switch for user.

Tools configuration l.jpg

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 l.jpg

Header Images

  • You can change the header image using your institution logo.

  • Create new header image, and copy to costumize/ directory.

  • Edit the file and change the image file name.

Height must be 65 pixels.

Width is not specified.

Metadata schemas l.jpg

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 l.jpg

Schema Configuration Files

Each metadata schema requires the following files (at schemas/ directory):

  • XML Template:

    • [schema].xml

    • [schema]

  • Entry Forms:

    • form_upload_[schema].inc

    • form_upload_[schema]

    • Add schema link in this file:

  • Detail Display:

    • box_metadata_[schema].inc

  • Advanced Search:

    • Edit search.cfg.

    • result_[schema].inc

Schema xml template l.jpg

Schema XML Template

Example of xml template l.jpg

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 l.jpg

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 l.jpg

Operation Manual


Repository explorer l.jpg

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 l.jpg

Create Root Folder for Organization Lists

Create Root Folder for Organization lists

Create folder for new organization l.jpg

Create Folder for New organization

Create Folder for new organization. Don’t forget to set the Type=organization.

Organization list in the metadata form l.jpg

Organization List in the Metadata Form

Organization folder automatically listed here.

Upload new metadata 1 l.jpg

Upload New Metadata (1)

Select the Metadata Form Schema.

Upload new metadata 2 l.jpg

Upload New Metadata (2)

Upload new metadata 3 l.jpg

Upload New Metadata (3)

Set number of files to be uploaded related to this metadata.

Upload file 1 l.jpg

Upload File (1)

Select the file, give description, and then click Upload button.

Upload file 2 l.jpg

Upload File (2)

Icon of the successfully uploaded file.

Show metadata detail l.jpg

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 l.jpg

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 l.jpg

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 l.jpg



Export metadata to a compressed file l.jpg

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 l.jpg

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 l.jpg

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 l.jpg

Importing Progress…

Setting synchronization options l.jpg

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 l.jpg



Connecting to Agri Hub Server.

If Success, the following message will be displayed.

Harvesting node publisher records l.jpg

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 l.jpg

Send/Receive Metadata Records (1)

If Outbox is 0, then continue with Harvesting Metadata.

Send receive metadata records 2 l.jpg

Send/Receive Metadata Records (2)

Harvesting progress bar…

Result collection from other nodes l.jpg

Result: Collection from Other Nodes

Collection from other Nodes of GENERAL Cluster Network at IndonesiaDLN

More information l.jpg

More Information

  • Knowledge Management Research Group ITB



  • IndonesiaDLN

    • Contact General Secretary: Arif Rifai Dwiyanto


    • Mailing list:

    • (Official web site)

    • (Hub server)

  • Swish-E

    • Index and Search engine application


Author l.jpg


  • Ismail Fahmi



Don’t forget your family while coding…

  • Login