Development environment

From Archivematica
(Difference between revisions)
Jump to: navigation, search
(Setup: cron job needs to run as archivematica user, or root.)
(Run: some modules require only generated files in a directory. The hidden .svn files will cause problems.)
Line 38: Line 38:
 
*To start processing a SIP:
 
*To start processing a SIP:
 
**Open Thunar file manager
 
**Open Thunar file manager
**if using sample files, 'copy' the SIP directory
+
**if using sample SIPs, 'export' the SIP directory
 +
<pre>svn export buildVM/includes/sampledata ~/sampledata</pre>
 
**'cut' the SIP directory and paste into the AcquireSIP directory
 
**'cut' the SIP directory and paste into the AcquireSIP directory
 
**Open the Firefox browser and type 'localhost' as the address to view SIP processing progress via the Dashboard
 
**Open the Firefox browser and type 'localhost' as the address to view SIP processing progress via the Dashboard
***note: until polling is enables, you will have to hit the browser refresh button to get latest Dashboard updates
+
***note: until polling is enabled, you will have to hit the browser refresh button to get latest Dashboard updates
  
 
=Update=
 
=Update=

Revision as of 16:01, 3 December 2010

Main Page > Development > Development Environment

This page explains how you can configure and use an Ubuntu Linux system to use as a basic Archivematica development environment.

Contents

Setup

  • Use Subversion to checkout Archivematica code
    • If you have commit access, use the private repository
    • If you have read-only access, use the public GoogleCode repository
svn checkout http://archivematica.googlecode.com/svn/trunk/ archivematica
  • Run localDevSetup scripts.
    • cd archivematica/localDevSetup/
    • ./installLocalDevRequirements.sh
    • ./createArchivematicaUserAndGroupForLocalDev.sh
    • ./createLocalDevDirectories.sh
    • cd createDatabases
    • ./postBuildRun.sh
    • This will create links in your local Ubuntu environment back to the relevant Archivematica scripts in your SVN checkout, allowing you to run a local Archivematica version which can continue to pull down revision updates from the code repository
    • If you have commit access, you can work on the files in the checkout directory, make changes and commit those back to SVN repository, while also running Archivematica locally to test your changes and commits from other developers.
  • Additional local environment configuration
    • Edit the sudoers file to give archivematica execution rights.
    • sudo echo "archivematica ALL=NOPASSWD:/bin/mv,/bin/chown,/bin/chmod,/usr/bin/unoconv,/usr/bin/gs" >> /etc/sudoers 
    • Add Crontab for quarantine check
    • sudo crontab -e
    • * * * * * flock -xn /var/lock/quarantine.lock /usr/lib/archivematica/MCPServer/delay/delay.sh 1 "/var/archivematica/sharedDirectory/watchedDirectories/quarantined" "/var/archivematica/sharedDirectory/watchedDirectories/unquarantine/."

Run

  • Start Archivematica MCP Server & Client
    • Open a seperate terminal for each and type:
      • runArchivematicaMCPServer.sh
      • runArchivematicaMCPClient.sh
  • Start unoconv service (for Open Document format transcoding)
    • unoconv --listen
  • To start processing a SIP:
    • Open Thunar file manager
    • if using sample SIPs, 'export' the SIP directory
svn export buildVM/includes/sampledata ~/sampledata
    • 'cut' the SIP directory and paste into the AcquireSIP directory
    • Open the Firefox browser and type 'localhost' as the address to view SIP processing progress via the Dashboard
      • note: until polling is enabled, you will have to hit the browser refresh button to get latest Dashboard updates

Update

To pull down the latest code commits from the repository, navigate to the directory where Archivematica trunk has been checked out:

  • svn up

Troubleshooting

  • If a SIP processing fails, it will move it to the 'failed' directory which is located:
    • var/archivematica/sharedDirectory/watchedDirectories/failed
  • if ArchivematicaServer freezes (in terminal kill command)
    • CTRL + \
  • if ArchivematicaClient freezes (in terminal kill command)
    • CTRL + C
  • Updates to the Dashboard might require an Apache webserver restart:
    • sudo /etc/init.d/apache2 restart
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox