SUNScholar/Guidelines/Step 3
Back to Guidelines
Assign the following persons to the project.
- A library repository manager and librarians, to be appointed permanently.
- An experienced (4yrs) IT Ubuntu Linux system administrator for installation, cutomisation, optimisation and upgrades.
- An experienced (4yrs) web 2.0 developer for website programming and styling.
Back to Guidelines
Back to Audit
Introduction
Efforts are underway to produce an institutional repository. For guidelines about building a good digital collection, see the links below.
Update 2013: See: http://web.lib.sun.ac.za/digital-collection for an archived copy. It seems the NISO website no longer hosts this document.
Critical Milestones
Please note: Items in italics are completed. Other items have completion dates and assigned action persons.
SUNScholar Workgroup
Establish a SUNScholar Workgroup. Completed: 03/02/2010. Members: Hilton Gibson, Ina Smith, Reggie Raju, Paulette Talliard, Philip de Villiers, Mimi Seyffert
Community Engagement
- SCESCAL Pre-conference workshop. See http://www.scecsal.org/conferences/2010/2010.html
- Botswana Digital Scholarship Conference, 25 - 27 May 2010. - Withdrawn
- Visit by Univ. of PTA, UNISA, Univ. of Jhb. 9-10 Sept. 2010.
- IR Wiki. See http://ir.sun.ac.za/wiki/index.php/Main_Page. (Superseded by http://bit.ly/goodir and http://bit.ly/garpir)
- Mailing lists in support digital scholarly research support from the library.
- General news and information: http://lists.lib.sun.ac.za/mailman/listinfo/scholar
- IR discussion for South Africa and Africa: http://lists.lib.sun.ac.za/mailman/listinfo/irtalk
- Technical discussion and help about DSpace and the future Duraspace: http://lists.lib.sun.ac.za/mailman/listinfo/duraspace
Marketing
- Setup website theme with extra help texts. Completed 24/02/2010. See: http://scholar.sun.ac.za
- Happy Hour Session: US research - cited more, preserved forever. Introduction to SUNScholar. Completed on 12/02/2010. See: http://hdl.handle.net/10019.1/379
- Completion of Marketing Material. Completed on 24/02/2010. See: http://bib.sun.ac.za/images/f/fd/Sunscholar_general.pdf
- Participate in Open Access Week 18/10/2010 - 24/10/2010. See http://www.openaccessweek.org/2010/02/02/save-the-date-oa-week-2010/.
- Visit individual departments (Roadshow).
- Faculty of Economic and Management Sciences. Faculty Board Meeting 07/05/2010.
- Faculty of Arts and Social Sciences. Bosberaad 04/06/2010.
- Faculty of Health Sciences. Pathology Research Committee Meeting 09/06/2010.
Communication
- Regular announcements on 'Yammer'. Continuous process.
- Create a dedicated e-mail account for SUNScholar. Completed 20/11/2009. E-mail: scholar@sun.ac.za
- Setup mailing list. Completed 24/02/2010. See: http://lists.lib.sun.ac.za/mailman/listinfo/scholar
- Setup news blog. Completed 24/02/2010. See: http://blogs.sun.ac.za/sunscholar.
- Setup Facebook profile. Completed 24/02/2010. See: http://www.facebook.com/pages/Stellenbosch-South-Africa/University-of-Stellenbosch-Scholar/181640938009
- Setup Twitter account. Completed 24/02/2010. See: http://twitter.com/usscholar
Policies
- Compile a Business Plan. Proposed completion date is 30/06/2010. Action: Ina Smith & Reggie Raju.
- Finalise 2010 Service Level Agreement with IT Department. Proposed finalisation date is 31/03/2010. Action: Hilton Gibson, Reggie Raju, Joe Smit and Wouter Klapwijk. See: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Capacity_Building
- Compile an Open Access Policy. Proposed completion date is 31/07/2010. Action: Ina Smith, Reggie Raju and Ellen Tise. Software for the golden route to open access is being evaluated here: http://neo.bib.sun.ac.za/ojs only available on campus.
- Compile a Copyright Guidelines Policy. Proposed completion date is 31/07/2010. Action: Ina Smith, Reggie Raju and Ellen Tise
- Compile a Digital Preservation Policy. Proposed completion date is 31/07/2010. Action: Ina Smith and Hilton Gibson
- Compile a Digitisation Policy. Proposed completion date is 31/07/2010. Action: Ina Smith, Reggie Raju, Hilton Gibson and Mimi Seyffert.
Progress Reports
- Theses & Dissertations. Completion date: 30/06/2010
- Problems experienced re theses & dissertations: 2008-March 2010. Completion date: 15/07/2010
Digital Assets
- Import old collections from lib.sun.ac.za. Completed on 24/02/2010.
- Import old collections from ir.sun.ac.za and import geospatial metadata schema. Proposed completion date is dependent on DSpace 1.6 release. Action: Ina Smith, Hilton Gibson and Wouter Klapwijk. Was released on 03/03/2010. Completed: 15/06/2010
- Conduct audit of digitisation projects on campus. Action: Ina Smith & Paulette Talliard
SUNeTD
See: http://bib.sun.ac.za/index.php/SUNeTD
DSpace and Ubuntu
- Setup technical documentation help wiki. Completed 01/11/2009 See: http://ir.sun.ac.za/wiki.
- Installation of DSpace and Ubuntu for SUNScholar. Completed 01/10/2009 with DSpace version 1.5.2 and Ubuntu version 8.04. See: http://ir.sun.ac.za/wiki/index.php/DSpace
- Implementation of web server security certificate. Completed 20/11/2009. See: http://ir.sun.ac.za/wiki/index.php/Internet_Security
- Registration of SUNScholar handle with CNRI handle server. Completed 20/11/2009. See: http://ir.sun.ac.za/wiki/index.php/Handle_Server
- Enabled campus logins and registration. Completed 01/12/2009. See: http://ir.sun.ac.za/wiki/index.php/User_Management
- Setup system backups and disaster recovery procedures. Completed 01/12/2009. See: http://ir.sun.ac.za/wiki/index.php/Disaster_Recovery
The upgrade to DSpace 1.6.1 is on hold. Tests on the development server did not go well. But the modifications for the XMLUI theme and the Atmire plugins will go ahead, in addition to the customisation for the Antarctic collection. New proposed completion date is: end of May 2010.
Researchers
- Update guidelines in annual year book re theses & dissertations. Action: Ina Smith, Research Office and Reggie Raju
- SUNScholar to feed data into research management system (RIMS). Action: Hilton Gibson, Wouter Klapwijk & Ralph Pina
- Compile and enable a SWORD-compliant GUI tool for large scale digital asset submissions. Action: Hilton Gibson, Wouter Klapwijk & Ina Smith. A test of OpenETD is in progress. See: http://neo.bib.sun.ac.za/etd available on campus only.
Training and Help
Materials
- Completion of SUNeTD help page in Afr/ Eng. Completed 11/01/2010. See: http://library.sun.ac.za/etd/index.htm
- Completion of online user help manual. Completed on 24/02/2010. See: http://bib.sun.ac.za/index.php/SUNScholar
- Completion of Submitter Training Materials. Completed on 24/02/2010. See: http://bib.sun.ac.za/index.php/SUNScholar_Submitters
- Completion of Faculty Librarian Training Materials. Action: Ina Smith. Completed on 27/05/2010. http://bib.sun.ac.za/images/1/11/Rolfb.pdf
- Completion of Cataloguer Training Materials.Completed on 24/02/2010. See: http://bib.sun.ac.za/index.php/SUNScholar_Metadata_Editors
- Completion of SUNScholar help web page. Action: Ina Smith.
Courses
- Completion of Submitter Training. Ongoing.
- 18/02/2010
- 04/03/2010
- 11/03/2010
- 25/03/2010
- 01/04/2010
- 08/04/2010
- 15/04/2010
- 22/04/2010
- 29/04/2010
- 27/05/2010
- 24/06/2010
- Completion of Faculty Librarian Training. Action: Ina Smith. Completed on 27/05/2010. Presentation: http://bib.sun.ac.za/images/d/d6/Fltraining_8june.pdf
- Completion of Cataloguer Training. Action: Ina Smith. Completed on 24/02/2010.
- 22/01/2010
- 08/02/2010
Web Analytics
- Register SUNScholar with search engines/harvesters. Action: Ina Smith. Proposed completion date 31/03/2010.
- Install Google Analytics. Action: Hilton Gibson & Ina Smith. Completed 01/03/2010
- Enable Google Webmaster Tools. Action: Hilton Gibson & Ina Smith. Completed 01/03/2010
- Register with: http://www.opendoar.org/suggest.php. Action: Hilton Gibson & Ina Smith. Completed 01/03/2010
- Register with: http://www.openarchives.org/Register/ValidateSite. Action: Hilton Gibson & Ina Smith. Completed 02/03/2010
- OAISTER/OCLC - Requested on 04/03/2010
- ROAR - Requested on 04/03/2010
- Webometrics (July 2010)
- ScientificCommons - Requested on 04/03/2010
- Wikipedia
- IRSpace
- eIFL.net
- DRIVER
- Google Scholar - Requested on 04/03/2010
- Google - Requested on 04/03/2010
- BASE Registry Watcher - Requested on 04/03/2010
- DSpace. Action: Hilton Gibson & Ina Smith. Completed 29/03/2010
- Scopus & Scirus
- UIUC OAI - Requested on 04/03/2010. Registered on 04/03/2010. http://gita.grainger.uiuc.edu/registry/details.asp?id=3404
- Darenet
- Europeana
- World Digital Library
- NDLTD
- OpenThesis
- Centre for Research Libraries
- ARROW
- ResearchNow
Release Activities
If critical milestones are completed, then SUNSCholar will be launched during Open Access Week 2010 18-24 October 2010.
- Activity 1: Video-clips from researchers voicing their opinions on how they benefitted from SUNScholar/ open access.
- Activity 2: Video-conference during launch with international presenter/ local high profile OA person.
- Activity 3: Arrange for "coming attraction" publications in "Die Matie" and with the "Boschtelegram".
- Activity 4: Open sessions on SUNScholar
- Activity 5: Exhibit in Die Neelsie
- Activity 6: Telepresence Conference
- Activity 7: Presentation by Prof Hauptfleisch (Drama) on OA wiki theatre encyclopedia
- Activity 8: Presentation by Prof Harms (Mechanical and Mechatronics Engineering) on OJ Journals (R & D Journal of the South African Institute for Mechanical Engineers)
- Resources on Open Access Week wiki: http://www.openaccessweek.org
Back to Guidelines
- Introduction
In the context of the library, the operational team provides information services, that are supported by the technical team using information systems, which are built and maintained in co-operation with the information technology department.
OPERATIONAL TEAM STRUCTURE AND COMPETENCIES
TECHNICAL TEAM STRUCTURE AND COMPETENCIES
- What is the difference between the operational and technical teams?
Let me try to explain by way of an analogy using something we are very familiar with, namely property development.
Property developers buy land prepared with roads and utilities by the local municipality and erect buildings for occupation by future businesses or residents.
- In the same way the technical team, prepares "roads and utilities" by constructing a "data center" which houses networking and server equipment.
- Then the technical team "erects buildings" by installing software on the servers.
- The software on the servers is utilised by the operational team, the equivalent of "businesses or residents" to complete a specific function.
See links below and above for more information about specific functions of the operational and technical teams.
- What are the functions of these people, with these new job descriptions?
There seems to be some confusion regarding the role and function of the people described in the links above.
Let me try to explain by way an analogy, using the medical services field as an example..
- Hospitals are full of specialists and administrators.
- Each is professionally trained to fulfil a specific task.
- The hospital administrator ensures the smooth functioning of the hospital, for the benefit of the specialists, in order to provide an excellent service to patients.
So it is, with the greatly expanded and currently expanding, technology and information sciences fields, in that, more specialisation is becoming the norm, as it was and is, in the medical field.
And now an attempt to translate the medical services definition to a library services definition, in support of academic research publishing and archiving.
- Academic libraries are full of librarians and directors.
- Each is professionally trained to fulfil a specific task.
- The open scholarship director ensures the smooth functioning of the open academic systems with the assistance of the operational and technical teams, in order to provide an excellent service to researchers.
- What else can these teams do for the library and the institution?
These same teams, with their skills, are also then capable of enabling other open systems for the institution, for example:
- An open journal system
- An open conference system
- An open research data management system
- An open research collaboration system
- An open educational resources system
- An open bibliography system
- An open library management system
- Communities of Practice (CoP)
In lieu of the lack of professional training venues for open online scholarly publishing practice, it is suggested that communities of practice (CoP) be formed for both the "soft" and "hard" skills mentioned above.
Below is a brief introduction to communities of practice.
Below are some web site examples.
http://www.force11.org http://adlsn.org http://www.itoca.org http://open-access.org.uk http://openaccess.jiscinvolve.org http://is4oa.org http://aoasg.org.au https://www.openaire.eu http://chorusaccess.org http://www.driver-community.eu http://www.medoanet.eu http://www.libereurope.eu/committee/scholarly-research https://www.coar-repositories.org/activities/repository-interoperability http://www.arl.org/focus-areas/shared-access-research-ecosystem-share
- Scholarly Publishing Links
http://jlsc-pub.org http://www.journalofelectronicpublishing.org http://www.openaccesspublishing.org http://www.librarypublishing.org http://hybridpublishing.org http://www.pubs-for-dev.info http://www.sparc.arl.org/theme/campus-based-publishing http://www.sspnet.org http://www.aaupnet.org
Click on the heading above for further references.
- 2016 - HGIBSON - CAPACITY BUILDING FOR SUSTAINABLE DIGITAL INFORMATION SERVICES IN AN ACADEMIC LIBRARY
- 2016 - HGIBSON - AN INTRODUCTION TO THE PRESERVATION OF THE SCHOLARY COMMUNICATION RECORD BY ACADEMIC LIBRARIES
- 2009 - IAP - PROGRAMME ON DIGITAL KNOWLEDGE RESOURCES AND INFRASTRUCTURE IN DEVELOPING COUNTRIES
- 2003 - IAP - STATEMENT ON SCIENTIFIC CAPACITY BUILDING
- Jobs
- News
- http://www.newindianexpress.com/education/edex/Libraries-in-The-Technology-Age/2014/12/29/article2589861.ece
- http://www.desmoinesregister.com/story/news/education/2014/12/28/harrison-inefuku-builds-iowa-state-digital-repository/20978135/
- References
- https://www.coar-repositories.org/activities/support-and-training/task-force-competencies
- http://www.arl.org/focus-areas/scholarly-communication/digital-scholarship-support
Give a person a fish and you feed that person for a day.
Teach a person to fish and you feed that person for a lifetime.
Complexity is easy to build, hard to use, and easy to charge for.
Simplicity is hard to build, easy to use, and hard to charge for.
Back to After Installation Tasks
EIFL Webinar
Tasks
The following tasks should be executed by an experienced Ubuntu Linux System Administrator.
- DISASTER RECOVERY
- DAILY ADMIN
- SERVER MAINTENANCE
- OPTIMISATIONS
- TROUBLESHOOTING
- SYSTEM UPGRADES
- RESTART DSPACE
- REBUILD DSPACE
- REBUILD INDEXES
- SQL TIPS
- REFERENCE ARCHITECTURE
Please Note:
During the long student vacations I update the software and do a server reboot to ensure the server machine will recover gracefully after an accidental loss of power in my absence.
References
- https://wiki.duraspace.org/display/DSPACE/SystemAdministrators
- https://wiki.duraspace.org/display/DSDOC5x/System+Administration
- https://wiki.duraspace.org/display/DSDOC4x/System+Administration
- https://wiki.duraspace.org/display/DSDOC3x/DSpace+Service+Manager
Back to Guidelines
Back to After Installation Tasks
EIFL Webinar
SOFTWARE DEVELOPMENT
Click on the heading above,
OPERATIONAL GUIDE
This customisation relates to the technical details involved in the customisation of features available with DSpace, not the customisation required when performing operational management of the research archive. For example, the creation of communities and collections is for the repository director/manager to determine. See: http://scholar.sun.ac.za for an example of a communities and collections hierarchy.
Please consult the OPERATIONAL GUIDE for recommendations regarding the operational management of a digital research archive using DSpace software.
CUSTOMISATION SCOPE AND CAPACITY
If the feature customisation is to be preserved on the repository system for the long term, then adequate resources must be provided to ensure continuity of the customisation during system upgrades. Depending on the amount of customisation, this could turn out to be VERY EXPENSIVE for the institution if using an external service provider and if upgrades are done on a yearly basis. Therefore, the rule of thumb, for resource scarce institutions that do not have the system capacity, is to keep customisation to the ABSOLUTE MINIMUM or acquire the resources to build adequate system capacity locally in-house.
README FIRST - Advanced Feature Customisation (Modules Overlay Method)
Please read about advanced customisation before starting any customisation work, as it is the basis for most of the customisation tasks.
The idea is to put all your customised code into the folder:
$HOME/source/dspace/modules
The source code is copied from the folder:
$HOME/source
*** What is this $HOME thing ***
This allows you to keep the source code intact and to keep your modifications in one separate place. Using this method also helps greatly during upgrades.
Also please note, that to apply these customisations you will usually have to rebuild DSpace.
See the official explanation below:
- https://wiki.duraspace.org/display/DSDOC5x/Advanced+Customisation
- https://wiki.duraspace.org/display/DSDOC4x/Advanced+Customisation
- https://wiki.duraspace.org/display/DSDOC3x/Advanced+Customisation
Introduction
All of the feature customisation and system administration documentation assumes:
- That DSpace has been installed according to: http://wiki.lib.sun.ac.za/index.php/SUNScholar/DSpace.
- That you are working as the "dspace" user, which was created during the installation of the Ubuntu server software.
Now that you have a working repository, you will probably want to make it your own using a proper change management system.
Below are links to help pages with detailed information on how to customise your repository, to make it fit for the purpose for which it was created.
For more information consult the official DSpace documentation and subscribe to the DSpace help mailing lists (see bottom of page below) so that you can ask the experts for help.
Before beginning customization using this guide, please familiarize yourself with command line editor, nano. See below for brief instructions.
- NANO Editor Help
| CTL+O | = Save the file and then press Enter |
| CTL+X | = Exit "nano" |
| CTL+K | = Delete line |
| CTL+U | = Undelete line |
| CTL+W | = Search for %%string%% |
| CTL+\ | = Search for %%string%% and replace with $$string$$ |
| CTL+C | = Show line numbers |
More info = http://en.wikipedia.org/wiki/Nano_(text_editor)
Director/Manager
Repository
Items
- Submission System
- Usage Statistics
- Media Filters (Item full text search and thumbnails)
- Digital Object Checksums
- Digital Object Identifier's
- Open Search
- RSS Feeds
Librarians
Users
- Researcher Authorisation (LDAP Server)
- Researcher Identification (ORCID Server)
Items
Interoperability
- Harvest Remote Collections (OAI Consumer)
- Allow Remote Harvesters (OAI Producer)
- Allow Remote Deposits (SWORD interface)
Mailing Lists
International DSpace Support
Before posting a request, please see: https://wiki.duraspace.org/display/DSPACE/Mailing+List+Etiquette first.
African Repository Support
- http://lists.lib.sun.ac.za/mailman/listinfo/irtalk
- http://lists.lib.sun.ac.za/mailman/listinfo/duraspace
References
Click on the heading above.
DSpace References
- https://wiki.duraspace.org/display/DSDOC5x/DSpace+Reference
- https://wiki.duraspace.org/display/DSDOC4x/DSpace+Reference
- https://wiki.duraspace.org/display/DSDOC3x/Appendices
Back to After Installation Tasks
Introduction
This wiki page details the major optimisations of the system performed at Stellenbosch University in an attempt to create a truly production optimised version of DSpace.
Recommended
- Server Hardware
- Tomcat Webapp Server
- ANSI SQL Database
- Java Virtual Machine
- Reduce system log sizes
- Bitstream checker
Optional
YouTube Video
References
- https://wiki.duraspace.org/display/DSPACE/SystemAdministrators
- https://wiki.duraspace.org/display/DSPACE/PostgresPerformanceTuning
- https://wiki.duraspace.org/display/DSDOC5x/Performance+Tuning+DSpace
- https://wiki.duraspace.org/display/DSDOC4x/Performance+Tuning+DSpace
- https://wiki.duraspace.org/display/DSDOC3x/Performance+Tuning+DSpace
- https://wiki.duraspace.org/display/FCREPO/Performance+Testing
- http://www.turnkeylinux.org/tomcat
- http://www.tecmint.com/how-to-install-and-setup-monit-linux-process-and-services-monitoring-program
- http://www.tecmint.com/command-line-tools-to-monitor-linux-performance
Back to System Admin
WE CANNOT ACCEPT RESPONSIBILITY FOR ANY DATA LOSS OR CORRUPTION
BEFORE PROCEEDING, DO EXTENSIVE TESTING ON SPARE INFRASTRUCTURE
*** YOU PROCEED AT YOUR OWN RISK ***
Introduction
Upgrading involves three systems.
- The repository software each year.
- The server software every 3 years.
- The server hardware every 4 years, if not virtualised or in the cloud.
EIFL Webinar
Change Management
Repository Software
Server Software
Server Hardware
References
- https://wiki.duraspace.org/display/DSDOC5x/Upgrading+DSpace
- https://wiki.duraspace.org/display/DSDOC4x/Upgrading+DSpace
- https://wiki.duraspace.org/display/DSDOC3x/Upgrading+a+DSpace+Installation
Back to Upgrading
WE CANNOT ACCEPT RESPONSIBILITY FOR ANY DATA LOSS OR CORRUPTION
BEFORE PROCEEDING, DO EXTENSIVE TESTING ON SPARE INFRASTRUCTURE
*** YOU PROCEED AT YOUR OWN RISK ***
Introduction
How do you manage changes so that they do not affect the uptimes of the production system too much and are controlled by all interested parties.
The following are the recommended procedures to follow.
Recommendations
- Build a test/development system on another server, typically an old retired server. At Stellenbosch University library we built: http://repository.sun.ac.za (Only available on-campus). This is the machine which you use to test changes and upgrades of software before you implement it on the production server.
- Try not to make major changes to the system during peak usage times of the year. Pick a time when there are very few users on the system.
- When you want to implement a change or upgrade you will need to inform submitters, reviewers and metadata editors. For this, setup a mailing list and ensure all submitters, reviewers and metadata editors join the list. For normal users, send a notification to the campus communications manager and then when the time arrives for the change, put the system into maintenance mode.
- Before changing anything on the production server ensure your backups are working. It is a good idea to keep incremental backups for a period of at least seven days.
- If you have service level agreements with the IT department, then inform them of changes that affect them at least two weeks ahead of the time.
References
- http://admin.sun.ac.za/cm/
- http://en.wikipedia.org/wiki/ITSM
- http://en.wikipedia.org/wiki/ITIL
- http://en.wikipedia.org/wiki/Change_Management_(ITSM)
- http://en.wikipedia.org/wiki/Release_management
- http://en.wikipedia.org/wiki/Configuration_management
- http://www.jiscinfonet.ac.uk/infokits/change-management/
PREVIOUS
NEXT