Difference between revisions of "Development environment"
Jump to navigation
Jump to search
(→Run) |
(→Update) |
||
| Line 43: | Line 43: | ||
*Change Directory to the archivematica SVN directory. | *Change Directory to the archivematica SVN directory. | ||
<pre>cd ~/archivematica/</pre> | <pre>cd ~/archivematica/</pre> | ||
| − | *<pre> | + | *<pre>./dev-helper</pre> |
| − | *<pre> | + | *<pre>"Would you like to svn up?" (y/N) y</pre> |
| − | *<pre> | + | *<pre>"Would you like to recreate the databases?" (y/N) y</pre> |
| − | * | + | **Note: this command will remove any processing sips/transfers. |
| − | *<pre> | + | *<pre>"Would you like to restart archivematica services?" (y/N) y</pre> |
| − | *<pre> | + | *<pre>"Would you like to re-create gui-scripts editor file?" (y/N) y</pre> |
| − | + | *<pre>"Would you like to update Qubit (trunk) and restart its qubit-sword service?" (y/N) y</pre> | |
| − | |||
| − | *<pre> | ||
=Troubleshooting= | =Troubleshooting= | ||
Revision as of 13:33, 4 January 2012
Main Page > Development > Development Environment
This page explains how you can configure and use a standard Linux system as an Archivematica development environment. The Archivematica development environment is available for developers that want the ability to customize or enhance their own Archivematica installation and/or contribute code back to the Archivematica project.
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 the install and helper scripts.
cd archivematica
./dev-installer
- Answer Y to all prompts.
./dev-helper
- Answer Y to all prompts.
- Restart the machine.
cd archivematica
./dev-helper
- Answer Y to all prompts.
- You may need to restart the services (see below for instructions)
- Open the [dashboard http://localhost]
Run
- Start Archivematica MCP Server & Client
- Open a terminal and type in the following commands:
sudo stop openoffice-service; sudo start openoffice-service
sudo stop archivematica-mcp-server; sudo start archivematica-mcp-server
sudo stop archivematica-mcp-client; sudo start archivematica-mcp-client
- Open a terminal and type in the following commands:
- To start processing a SIP:
- Open Thunar file manager
- if using sample SIPs, 'export' the SIP directory
svn export sampledata ~/sampledata
- OR run the dev-helper script, and hit yes on the option to export the sample data.
- 'cut' the SIP directory and paste into the receiveSIP directory
- Open the Firefox browser and type 'localhost' as the address to view SIP processing progress via the Dashboard
Update
To pull down the latest code commits from the repository, navigate to the directory where Archivematica trunk has been checked out:
- Change Directory to the archivematica SVN directory.
cd ~/archivematica/
./dev-helper
"Would you like to svn up?" (y/N) y
"Would you like to recreate the databases?" (y/N) y
- Note: this command will remove any processing sips/transfers.
"Would you like to restart archivematica services?" (y/N) y
"Would you like to re-create gui-scripts editor file?" (y/N) y
"Would you like to update Qubit (trunk) and restart its qubit-sword service?" (y/N) y
Troubleshooting
- If you get this error error starting service:
sudo start archivematica-mcp-server
start: Unknown job: archivematica-mcp-server
- Then reboot the machine.
- If a SIP processing fails, it will move it to the 'failed' directory which is located:
var/archivematica/sharedDirectory/watchedDirectories/failed
- if ArchivematicaServer freezes
sudo restart archivematica-mcp-server
sudo restart archivematica-mcp-client
- if ArchivematicaClient freezes (in terminal kill command)
sudo restart archivematica-mcp-client
- Updates to the Dashboard may require an Apache webserver restart:
sudo /etc/init.d/apache2 restart
- If you find a problem running the Dashboard and you want to get a detailed error log to report us, please switch it to debug mode following these instructions.