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

1. Installation and Operation ManualGanesha Digital Library(GDL Version 4.0) Source : http://gdl.itb.ac.id Hub : http://gdlhub.IndonesiaDLN.org KMRG Institut Teknologi Bandung YLTI Supported by YLTI and IDRC

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

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.

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

5. Installation Manual YLTI

6. Getting The Source Code • Files: • Gdl40-nt-xp-xxx.zip • Gdl40-win98-xxx.zip • Gdl40-htdocs-xxx.zip • Download: • http://gdl.itb.ac.id • CD-ROM: • Send order to KMRG ITB, kmrg@kmrg.itb.ac.id • GDL Directory Structure: • See this picture 

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

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.

9. Windows > Fresh Installation (3) Open address http://localhost/ Do you cee dis page? Congratulation !!

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. http://digilib.acme.org. • Steps: • Extract ‘gdl40-htdocs-xxx.zip’ to virtual host document root, such as at ‘htdocs-gdl40’.

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/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

12. Linux/Windows > Virtual Host Installation (3) • Steps (cont’d): • Restart your web server. • Install databasefor the first time: • Open webbrowser. • Open http://digilib.acme.org Do you cee dis page? Good, pollow the instruction there!

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

14. Getting Started YLTI

15. Getting Started Login Category tree address Search Browse Categories

16. Login Login: superuser@localhost Password: superuser

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

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

19. List of Metadata Titles List of metadata titles under current category tree

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?

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

22. Advanced Search Advanced Search for Organization collection type Query formula passed to the SWISH-E

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

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

25. User Account Activation (2) Change Status to Active. Activation by Administrator.

26. Registering the Node YLTI

27. Introduction to NeONs Human Rights Children Heritage Agriculture ETD Central Hub Schools Health Environment Religion • This GDL4.0 version support the development of NeONs, Network of Networks.

28. Configuration of a Network (Cluster) Human Rights Hub Server Children Heritage Agriculture DL Network ETD Central Hub personal Schools Health Environment Religion Binus UAJ IAIN IPB Unsyiah UNCEN UNHAS UMM ITB Internet Cafe Institution

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.

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

31. Publishers Table at Hub Server Click the ‘mail’ icon to generate Node configuration data.

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

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.

34. Modification YLTI

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.

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

37. Language (3) • Edit file src/box_search.inc to display the language switch for user.

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.

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

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.

41. Schema Configuration Files Each metadata schema requires the following files (at schemas/ directory): • XML Template: • [schema].xml • [schema].xml-values.inc • Entry Forms: • form_upload_[schema].inc • form_upload_[schema]_validate.inc • Add schema link in this file: form_upload_selection.inc. • Detail Display: • box_metadata_[schema].inc • Advanced Search: • Edit search.cfg. • result_[schema].inc

42. Schema XML Template

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#

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.

45. Operation Manual YLTI

46. Repository Explorer Current address of the category tree. New…Click here to create new category or upload new metadata under current Address.

47. Create Root Folder for Organization Lists Create Root Folder for Organization lists

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

49. Organization List in the Metadata Form Organization folder automatically listed here.

50. Upload New Metadata (1) Select the Metadata Form Schema.