Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Notes on giving access to AIPs for public download

...

  1. Install a fresh (empty) copy of DSpace on your local server.
  2. Configure it to have the same handle prefix as demo.dspace.org (handle prefix: 10673) & setup an initial administrative user (ideally 'dspacedemo+admin@gmail.com' which is the Demo Administrator on demo.dspace.org).
  3. Download the existing AIPs from this directory, e.g.

    Code Block
    scp dspace@demo.dspace.org:~/AIP-restore/* .


  4. Use the downloaded AIPs to "restore" content to your local server's empty DSpace, e.g.

    Code Block
    \[dspace\]/bin/dspace packager -r -a -f -t AIP -e [admin-email] -i 10673/0 /full/path/to/SITE@10673-0.zip


  5. Update your DSpace's content as you see fit (adding/removing/changing objects)
  6. Export a fresh set of AIPs, by performing a full SITE export e.g.

    Code Block
    \[dspace\]/bin/dspace packager -d -a -t AIP -e [admin-email] -i 10673/0 -o includeBundles=ORIGINAL,LICENSE -o passwords=true SITE@10673-0.zip
    • The above example just exports ORIGINAL & LICENSE bundles into AIPs, and also exports user passwords into AIPs (so that they can also be restored).
  7. Upload those newly updated AIPs to demo.dspace.org, e.g.

    Code Block
    scp . dspace@demo.dspace.org:~/AIP-restore/
    • NOTE: Before putting them on demo.dspace.org, you may want to do your own test restore using these AIPs, just to ensure there are no issues.

How to share AIPs for public download

At this time, sharing AIPs is not automated.  It's also not currently possible to share them from the default ~/AIP-restore/ location, so this is a bit of a "temporary hack" that needs fixing in the future.

  1. First, copy all the AIPs to a shareable location.  Below, we chose /usr/share/dspace/AIP-restore folder:

    Code Block
    sudo mkdir -p /usr/share/dspace/AIP-restore
    cd /usr/share/dspace/AIP-restore/
    sudo cp ~dspace/AIP-restore/* .
    sudo chown -R dspace:dspace /usr/share/dspace/AIP-restore/


  2. Next, update the Apache configuration for demo.dspace.org to provide access to that shareable location:

    Code Block
    sudo nano /etc/apache2/sites-available/25-demo.dspace.org.conf
    
    
    ## ADD THE FOLLOWING INTO THAT FILE (inside the <VirtualHost>)
    <VirtualHost *:80>
    
    
      ...
    
    
      # Define path /aip to point at shareable AIP-restore location
      Alias "/aip" "/usr/share/dspace/AIP-restore"
      <Directory "/usr/share/dspace/AIP-restore">
        # Allow viewing file listing
        Options Indexes
        # Don't allow access to README, logs or parent link (..)
        IndexIgnore README* *.log ..
        # Allow access to all
        Order allow,deny
        Allow from all
      </Directory>
      # Don't proxy /aip paths to Tomcat
      ProxyPass /aip !
    
    
      ...
    </VirtualHost>
    
    


  3. Reload Apache and test it out:

    Code Block
    sudo service apache2 reload


  4. Assuming everything works, here's a wget command that can be used to download the AIPs to a local computer 

    Code Block
    # This recursively downloads all files (except index.html file) into an "aip" directory
    wget -r -np -nH -R "index.html*" --execute="robots=off" http://demo.dspace.org/aip/


Reset "News" sections every night

...