Merge pull request #2 from lcdhoffman/master

Update source repo with Brian's repo

.gemrc

@@ -0,0 +1 @@
+--no-rdoc --no-ri

.gitignore

@@ -1,23 +1,27 @@
-ASpaceClient.php
-ASpaceCopyUtil.php
-ASpaceEnumUtil.php
-ASpaceMapper.php
-LICENSE
-SourceRemoteConnection.php
-admin/
-adminthemes/
-common.inc.php
-config.inc.php
-cryptorblank.inc.php
-footer.inc.php
-go-pear.phar
-header.inc.php
-includes.inc.php
-includes/
-incoming/
-index.php
-lib/
-nbproject/
-packages/
-start.inc.php
-themes/
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile '~/.gitignore_global'
+
+# Ignore bundler config.
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+/db/*.sqlite3-journal
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+
+# Ignore vendor and downloads directories
+/vendor
+/downloads
+
+# Ignore the 'ignore' directory
+/ignore
+
+
+batch_trace*
+config_local.rb

Gemfile

@@ -0,0 +1,34 @@
+source 'https://rubygems.org'
+
+gem 'arel'
+gem 'atomic'
+gem 'builder'
+gem 'bundler'
+gem 'coffee-script'
+gem 'coffee-script-source'
+gem 'erubis'
+gem 'execjs'
+gem 'jsmin'
+gem 'json'
+gem 'json-schema', '= 1.0.10'
+gem 'lrucache'
+gem 'mime-types'
+gem 'minitest'
+gem 'multi_json'
+gem 'net-http-persistent'
+gem 'puma'
+gem 'rack'
+gem 'rack-protection'
+gem 'rack-test'
+gem 'rake'
+gem 'rdoc'
+gem 'rspec'
+gem 'rubyzip'
+gem 'sass'
+gem 'sdoc'
+gem 'sinatra'
+gem 'sinatra-assetpack'
+gem 'thread_safe'
+gem 'tilt'
+gem 'tzinfo'
+gem 'uglifier'

README.md

@@ -1,4 +1,69 @@
-archon-migration
+Archon2ArchivesSpace README
 ================
+# Installing the service
+
+Checkout the project from Github:
+
+    git clone https://github.com/lcdhoffman/archon-migration.git
+    cd archon-migration
+
+Run a script to download the necessary ArchivesSpace libraries:
+
+./scripts/import\_client\_libs.sh v1.0.0RC1
+
+This will attempt to download the ArchivesSpace source code for ArchivesSpace v1.0.0RC1.
+
+Install the gems in the Gemfile:
+
+    gem install bundler
+    bundle install
+
+Now run the application:
+
+    ruby app/main.rb
+
+(You'll probably want to daemonize or disown this.)
+
+# Using the Service
+
+The service is designed to be used in a browser window. Make sure you have a 
+running Archon instance and a running ArchiveSpace instance. You will also need 
+account credentials for each service. It is recommended that you create a 
+separate account called 'migration_user' and assign this user the required 
+permissions in each application.
+
+Point your browser to, e.g.,  http://localhost:4568 and fill out the web form. 
+
+# Configuration Options
+
+The best way to configure the application is to create a local config file:
+
+    touch config/config_local.rb
+
+To change, for example, the port that application runs on, add the following
+line
+
+    Appdata.port_number 4568
+
+# Notes
+
+A typical migration can take several hours and will cause ArchivesSpace's 
+indexer to get backed up. Migrated records may not appear right away in browse or search results in ArchivesSpace. Consider running ArchivesSpace with the indexer
+turned off to speed up the migration process.
+
+A large migration may fail because of an expiration of the migration tool's session in ArchivesSpace. Avoid this by setting a 10 hour session expiration threshold in the ArchivesSpace configuration file:
+
+	AppConfig[:session_expire_after_seconds] = 36000
+
+Do not run a migration process against an ArchivesSpace instance that already
+contains data.
+
+Do not allow Archon users to create or edit data while the migration is running.
+
+You can optimize the performance of the migration tool by adjusting the number of
+pages of Archon data that are cached. For example, if your largest Archon collection contains 50,000 Content records, and you are running the migration tool in an environment that can afford around 300MB of memory, you might want to add this line to your config_local.rb file:
+
+    Appdata.archon_page_cache_size 500
+
+There's no (or little) advantage to setting the cache size to a value larger than the number of Content records in the largest Collection, divided by 100.
 
-Archon to ArchivesSpace Migration code

app/css/main.css

@@ -0,0 +1,22 @@
+
+.error {
+    background: #faa;
+}
+
+#status-console {
+    font-family: Consolas, 'Liberation Mono', Courier, monospace;
+    background: #ddd;
+}
+
+p {
+    padding-left: 10px;
+    padding-right: 10px;
+}
+
+p.aspace {
+    color: blue;
+}
+
+p.warn {
+    color: red;
+}