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

/ 70 []
Download Presentation
(127) |   (0) |   (0)
Views: 228 | 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 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Slide 1

Installation and Operation ManualGanesha Digital Library(GDL Version 4.0)

Source :

Hub :


Institut Teknologi Bandung


Supported by YLTI and IDRC

Slide 2

Vision and Objectives


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


Unlock access to the local communities’ knowledge.

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

Slide 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

Slide 5

Installation Manual


Slide 6

Getting The Source Code

  • Files:




  • Download:


  • CD-ROM:

    • Send order to KMRG ITB,

  • GDL Directory Structure:

    • See this picture 

Slide 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\

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

Slide 9

Windows > Fresh Installation (3)

Open address http://localhost/

Do you cee dis page?

Congratulation !!

Slide 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’.

Slide 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

Slide 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!

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


Slide 14

Getting Started


Slide 15

Getting Started


Category tree address


Browse Categories

Slide 16


Login: superuser@localhost

Password: superuser

Slide 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

Slide 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

Slide 19

List of Metadata Titles

List of metadata titles under current category tree

Slide 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?

Slide 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

Slide 22

Advanced Search

Advanced Search for Organization collection type

Query formula passed to the SWISH-E

Slide 23

User Registration

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

Slide 24

User Account Activation (1)

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

Slide 25

User Account Activation (2)

Change Status to Active.

Activation by Administrator.

Slide 26

Registering the Node


Slide 27

Introduction to NeONs

Human Rights





Central Hub





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

Slide 28

Configuration of a Network (Cluster)

Human Rights

Hub Server




DL Network


Central Hub















Internet Cafe


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

Slide 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

Slide 31

Publishers Table at Hub Server

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

Slide 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

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

Slide 34



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

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

Slide 37

Language (3)

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

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

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

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

Slide 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

Slide 42

Schema XML Template

Slide 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#

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

Slide 45

Operation Manual


Slide 46

Repository Explorer

Current address of the category tree.

New…Click here to create new category or upload new metadata under current Address.

Slide 47

Create Root Folder for Organization Lists

Create Root Folder for Organization lists

Slide 48

Create Folder for New organization

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

Slide 49

Organization List in the Metadata Form

Organization folder automatically listed here.

Slide 50

Upload New Metadata (1)

Select the Metadata Form Schema.

Slide 51

Upload New Metadata (2)

Slide 52

Upload New Metadata (3)

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

Slide 53

Upload File (1)

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

Slide 54

Upload File (2)

Icon of the successfully uploaded file.

Slide 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

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

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

Slide 58



Slide 59

Export Metadata to a Compressed File

As administrator, click: Menu > Export & Import.

Click Export Metadata to export local metadata to a compressed file.

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

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

Slide 62

Importing Progress…

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

Slide 64



Connecting to Agri Hub Server.

If Success, the following message will be displayed.

Slide 65

Harvesting Node (Publisher) Records

It is recommended to harvest publisher data frequently before perform Send/Receive Metadata records

Harvesting progress bar…

Slide 66

Send/Receive Metadata Records (1)

If Outbox is 0, then continue with Harvesting Metadata.

Slide 67

Send/Receive Metadata Records (2)

Harvesting progress bar…

Slide 68

Result: Collection from Other Nodes

Collection from other Nodes of GENERAL Cluster Network at IndonesiaDLN

Slide 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


Slide 70


  • Ismail Fahmi



Don’t forget your family while coding…

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