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

/ 70 []
Download Presentation
(127) |   (0) |   (0)
Views: 261 | Added:
Rate Presentation: 0 0
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:
Installation and Operation Manual Ganesha Digital Library (GDL Version 4.0)

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

Download Policy: Content on the Website is provided to you AS IS for your information and personal use only and may not be sold or licensed nor shared on other sites. SlideServe reserves the right to change this policy at anytime. 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 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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

Installation and Operation ManualGanesha Digital Library(GDL Version 4.0)

Source :

Hub :


Institut Teknologi Bandung


Supported by YLTI and IDRC

Vision and objectives l.jpgSlide 2

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.jpgSlide 3

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.jpgSlide 4

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.jpgSlide 5

Installation Manual


Getting the source code l.jpgSlide 6

Getting The Source Code

  • Files:




  • Download:


  • CD-ROM:

    • Send order to KMRG ITB,

  • GDL Directory Structure:

    • See this picture 

Windows fresh installation 1 l.jpgSlide 7

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.jpgSlide 8

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.jpgSlide 9

Windows > Fresh Installation (3)

Open address http://localhost/

Do you cee dis page?

Congratulation !!

Linux windows virtual host installation 1 l.jpgSlide 10

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.jpgSlide 11

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.jpgSlide 12

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.jpgSlide 13

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.jpgSlide 14

Getting Started


Getting started15 l.jpgSlide 15

Getting Started


Category tree address


Browse Categories

Login l.jpgSlide 16


Login: superuser@localhost

Password: superuser

Node list under a network l.jpgSlide 17

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.jpgSlide 18

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.jpgSlide 19

List of Metadata Titles

List of metadata titles under current category tree

Read metadata l.jpgSlide 20

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.jpgSlide 21

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.jpgSlide 22

Advanced Search

Advanced Search for Organization collection type

Query formula passed to the SWISH-E

User registration l.jpgSlide 23

User Registration

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

User account activation 1 l.jpgSlide 24

User Account Activation (1)

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

User account activation 2 l.jpgSlide 25

User Account Activation (2)

Change Status to Active.

Activation by Administrator.

Registering the node l.jpgSlide 26

Registering the Node


Introduction to neons l.jpgSlide 27

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.jpgSlide 28

Configuration of a Network (Cluster)

Human Rights

Hub Server




DL Network


Central Hub















Internet Cafe


System configuration setting l.jpgSlide 29

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.jpgSlide 30

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.jpgSlide 31

Publishers Table at Hub Server

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

Generate configuration for node l.jpgSlide 32

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.jpgSlide 33

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.jpgSlide 34



Language 1 l.jpgSlide 35

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.jpgSlide 36

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.jpgSlide 37

Language (3)

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

Tools configuration l.jpgSlide 38

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.jpgSlide 39

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.jpgSlide 40

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.jpgSlide 41

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.jpgSlide 42

Schema XML Template

Example of xml template l.jpgSlide 43

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.jpgSlide 44

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.jpgSlide 45

Operation Manual


Repository explorer l.jpgSlide 46

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.jpgSlide 47

Create Root Folder for Organization Lists

Create Root Folder for Organization lists

Create folder for new organization l.jpgSlide 48

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.jpgSlide 49

Organization List in the Metadata Form

Organization folder automatically listed here.

Upload new metadata 1 l.jpgSlide 50

Upload New Metadata (1)

Select the Metadata Form Schema.

Upload new metadata 2 l.jpgSlide 51

Upload New Metadata (2)

Upload new metadata 3 l.jpgSlide 52

Upload New Metadata (3)

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

Upload file 1 l.jpgSlide 53

Upload File (1)

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

Upload file 2 l.jpgSlide 54

Upload File (2)

Icon of the successfully uploaded file.

Show metadata detail l.jpgSlide 55

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.jpgSlide 56

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.jpgSlide 57

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.jpgSlide 58



Export metadata to a compressed file l.jpgSlide 59

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.jpgSlide 60

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.jpgSlide 61

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.jpgSlide 62

Importing Progress…

Setting synchronization options l.jpgSlide 63

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.jpgSlide 64



Connecting to Agri Hub Server.

If Success, the following message will be displayed.

Harvesting node publisher records l.jpgSlide 65

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.jpgSlide 66

Send/Receive Metadata Records (1)

If Outbox is 0, then continue with Harvesting Metadata.

Send receive metadata records 2 l.jpgSlide 67

Send/Receive Metadata Records (2)

Harvesting progress bar…

Result collection from other nodes l.jpgSlide 68

Result: Collection from Other Nodes

Collection from other Nodes of GENERAL Cluster Network at IndonesiaDLN

More information l.jpgSlide 69

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.jpgSlide 70


  • Ismail Fahmi



Don’t forget your family while coding…

Copyright © 2015 SlideServe. All rights reserved | Powered By DigitalOfficePro