Page History

...

The following directions are for DSpace 1.5.x and above!

Directories:

• Wiki Markup
  {{\[dspace\]}} \- The DSpace Installation directory

• Wiki Markup
  {{\[dspace-source
  Code Block
  \]/dspace/}} \- The DSpace Assembly project within the DSpace source code

• Wiki Markup
  {{\[dspace-source
  Code Block
  \]/dspace/target/dspace-\[version\]-build.dir/}} \- The directory where the DSpace Assembly project builds a new installation package for DSpace.

• Wiki Markup
  {{\[Tomcat\]

  Tomcat

  Code Block
  /webapps/}} (Mac OSX Server:
  Code Block
  {{/library/jboss/3.2/deploy}})

• Note: JBOSS comes pre-installed with Mac OS X server. However, for both server and desktop editions Tomcat may be used as with other platforms.

...

1. Stop Tomcat (WARNING: this will bring down the website)

   • Wiki Markup
     (Linux / OS X / Solaris) {{\[Tomcat\]/bin/shutdown.sh}}

   • (Mac OS X Server) Use Server Admin to stop Tomcat ("Application Server")
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to stop Tomcat

1. Start Tomcat

   • Wiki Markup
     (Linux / OS X / Solaris) {{\[Tomcat\]/bin/startup.sh}}

   • (Mac OS X Server) Use Server Admin to start Tomcat ("Application Server")
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to start Tomcat

...

1. Log on to the server DSpace is running on (e.g. ssh). Make sure to login as the user who initially installed DSpace!

2. Wiki Markup
   Open a command prompt (if you don't have one already),

   and

   Code Block
   cd

   code

   and {{cd \[dspace-source
   Code Block
   \]/dspace/
   }}

3. mvn build (recompiles all DSpace code and rebuilds the DSpace installation package)

4. Wiki Markup
   {{cd {{\[

   Code Block
   cd

   dspace-source
   Code Block
   \]/dspace/target/dspace-\[version\]-build.dir/}} (move into the _target_ directory where DSpace has been rebuilt)
   Code Block

5. ant update(updates your DSpace install based on the newly built content in your target directory)

• Wiki Markup
  Alternatively, if you do not need to reinstall JAR files, you could instead

  run

  Code Block
  run {{ant update_webapps
  Wiki Markup
  }} (which just copies over web application changes to your {{\[dspace\]}})

1. Wiki Markup
   If you do not have Tomcat pointing at your

   dspace

   Code Block
   {{\[dspace\]/webapps/}} directory, you will also need to copy your final web application(s) into your

   Tomcat

   Code Block
   {{\[Tomcat\]/webapps/}} directory.

• Wiki Markup
  {{
  Code Block
  cp -R \[dspace\]/webapps/

  Tomcat

  Code Block
  \[Tomcat\]/webapps/}}

• (For Mac OS X Server) Code Blockcp build/*.war /library/jboss/3.2/deploy

1. Test your changes in DSpace

...

1. Log on to the server DSpace is running on (e.g. ssh). Make sure to log in as the user who initially installed DSpace!

2. Wiki Markup
   Open a command prompt (if you don't have one already),

   and

   Code Block
   cd

   and {{cd \[dspace-source
   Code Block
   \]/dspace/}}
   Code Block

3. mvn clean build (removes all old compiled code and recompiles all DSpace code and rebuilds the DSpace installation package)

4. Wiki Markup
   {{cd \[

   Code Block
   cd

   dspace-source
   Code Block
   \]/dspace/target/dspace-\[version\]-build.dir/}} (move into the _target_ directory where DSpace has been rebuilt)
   Code Block

5. ant update(updates your DSpace install based on the newly built content in your target directory)

• Wiki Markup
  Alternatively, if you do not need to reinstall JAR files, you could instead

  run

  Code Block
  run {{ant update_webapps
  Wiki Markup
  }} (which just copies over web application changes to your {{\[dspace\]}})

1. Wiki Markup
   If you do not have Tomcat pointing at your

   dspace

   Code Block
   {{\[dspace\]/webapps/}} directory, you will also need to copy your final web application(s) into your

   Tomcat

   Code Block
   {{\[Tomcat\]/webapps/}} directory.

• Wiki Markup
  {{
  Code Block
  cp -R \[dspace\]/webapps/

  Tomcat

  Code Block
  \[Tomcat\]/webapps/}}

• (For Mac OS X Server) Code Blockcp build/*.war /library/jboss/3.2/deploy

1. Test changes in DSpace

   • Wiki Markup
     To force Tomcat to recompile everything, you may also wish to remove any DSpace related web application directories created in

     Tomcat

     Code Block
     {{\[Tomcat\]/work/Catalina/localhost}}

2. Start Tomcat

   • Wiki Markup
     (Linux / OS X / Solaris) {{\[Tomcat\]/bin/startup.sh}}

   • (Mac OS X Server) Use Server Admin to start Tomcat ("Application Server")
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to start Tomcat
3. Test your changes in DSpace