Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: javadocs instructions

...

Code Block
cd ~/dspace-src/
git commit [file]

# OR, to commit all changed files
git commit -a
 

Managing Website Content

Website / Splash page

  • Tomcat is configured to run on port 80
    • It is using 'jsvc' to start as 'root' and then switch to being owned by 'dspace'
    • Tomcat's startup settings are all located in ~dspace/.profile
  • DSpace Webapps are run from ~/dspace/webapps/ (configured in Tomcat's server.xml)
  • The main "splash" page (http://demo.dspace.org) is generated by Tomcat and is located at: ~/tomcat/webapps/ROOT/index.html

JavaDocs page

  • The JavaDocs pages (http://demo.dspace.org/javadocs/) are generated by Tomcat and are located at: ~/tomcat/webapps/javadocs/
  • These JavaDocs can be regenerated at any time by running the following (from the root source directory, [dspace-source]):
    • mvn javadoc:aggregate

    • The "javadoc:aggregate" command generates a single set of javadocs which aggregate the APIs of all DSpace modules.  See http://maven.apache.org/plugins/maven-javadoc-plugin/plugin-info.html
    • NOTE: We've encountered some oddities with the results when this is run from demo.dspace.org itself (the resulting CSS isn't right).  So, it's recommended to run this command from your local machine.

General Server Setup

Here's an overview of how everything is setup on the 'demo.dspace.org' server:

...

  • The server is currently running on DuraSpace's Amazon EC2 account with the following configurations:
    • Amazon AMI (EBS Image)
    • Ubuntu Linux 12.04 LTS server (64-bit)
    • Separate EBS volume mounted at /home/dspace
  • All DSpace requirements/software is installed in the 'dspace' user's home directory (/home/dspace):
    • Java: /usr/lib/jvm/java-1.7.0-openjdk-amd64 (NOTE: We also have Oracle Java 7 installed at /usr/lib/jvm/java-7-oracle but it is not used by default)
    • Ant: ~/ant (installed manually)
    • Maven: ~/maven (installed manually)
    • PostgreSQL: ~/pgsql (compiled from source)
    • Tomcat: ~/tomcat(installed manually)DSpace Source: ~/dspace-src
      • DSpace Install: ~/dspace

    Website / Splash page

        • Tomcat is configured to run on port 80
      • It is
        • (using 'jsvc'
        to start
        • running as
        'root' and then switch to being owned by 'dspace'
      • Tomcat's startup settings are all located in ~dspace/.profile
    • DSpace Webapps are run from ~/dspace/webapps/ (configured in Tomcat's server.xml)
    • The main "splash" page (http://demo.dspace.org) is generated by Tomcat and is located at:
      ~/tomcat/webapps/ROOT/index.html
    • Its content is also managed via the GitHub Repository at: http://github.com/DSpace/demo.dspace.org
    • Info on updating & pushing to GitHub can be found in the README at https://github.com/DSpace/demo.dspace.org
        • root)
      • DSpace Source: ~/dspace-src
      • DSpace Install: ~/dspace

     

    'dspace' user account

    • The 'dspace' user's ~/.profile initializes PATH/environment
    • The 'dspace' user has limited 'sudo' access on system.
    • The 'dspace' user's ~/bin/ includes various useful scripts

    ...