Date: Tue, 19 Mar 2024 06:40:42 -0400 (EDT) Message-ID: <1468377061.9023.1710844842697@lyrasis1-roc-mp1> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_9022_1236854838.1710844842696" ------=_Part_9022_1236854838.1710844842696 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
In the notes below [dspace]
refers to the install directory=
for your existing DSpace installation, and [dspace-source]
to=
the source directory for DSpace 1.8. Whenever you see these path reference=
s, be sure to replace them with the actual path names on your local system.=
You should also check the =EF=BB=BFDSpace Release 1.8.0 Notes to see what change=
s are in this version.
Changes to the DSpace 1.8 Upgrade / Co= nfiguration Process
In DSpace 1.8.0, there have been a few significant changes to how you up= grade and configure DSpace. Notably:
[dspace]/config/modules/
directory.=
=20
[dspace]/config/modules/authentication*.cfg=
files[dspace]/config/m=
odules/bulkedit.cfg
file[dspace]/config/modules/discovery.cfg
file[dspace]/config/modules/oai.cfg
file[dspace]/config/modules/solr-statistics.cfg=
file[dspace]/config/modules/sword*.cfg
filesdsp=
ace.cfg
configuration file.ant up=
date
upgrade command now defaults to replacing any =
existing configuration files (though the existing configuration files will =
first be backed up to a file with the suffix *.old
).=20
ant update
command would leave existing configuration files intact (and you would ha=
ve to manually merge in new configuration settings, which would be in a fil=
e with the suffix *.new
). If you prefer this previous behavior=
, you can still achieve the same result by running:=20
ant -Doverwrite=3Dfalse update
ant -Doverwrite=3D=
false update
please be aware that this will not auto-upgrade any of =
your configuration files. This means you must closely watch the output of t=
his command, and ensure you manually upgrade all configuration files in the=
[dspace]/config/
directory as well as all Solr configurations=
/schemas in the [dspace]/solr/search/conf/
and [dspace]/=
solr/statistics/conf/
directories.Before you start your upgrade, it is strongly recommended that you creat= e a backup of your DSpace instance. Backups are easy to recover from; a bot= ched install/upgrade is very difficult if not impossible to recover from. T= he DSpace specific things to backup are: configs, source code modifications= , database, and assetstore. On your server that runs DSpace, you might addi= tionally consider checking on your cron/scheduled tasks, servlet container,= and database.
Make a complete backup of your system, including:
pg_dump= -U [database-user] -f [backup-file-location] [database-name]
[dspace]/assetstore
 =
;by default, and any other assetstores configured in the [dspace]/con=
fig/dspace.cfg
"assetstore.dir" and "assetstore.dir.#" settings)[dspace]/co=
nfig
.[dspace-source]/dspace/modules/jspui/src/mai=
n/webapp/
[dspace-source]/dspace/modules/xmlui/src/mai=
n/webapp/
[dspace]/config
cd [dspace-source]/dspace/ mvn -U clean package
[dspace-source]/dspace/target/dspa=
ce-[version]-build.dir
. Inside this directory is the compiled binar=
y distribution of DSpace. Before rebuilding DSpace ('package'), the above c=
ommand will clean out any previously compiled code ('clean') and ensure tha=
t your local DSpace JAR files are updated from the remote maven repository.=
$CATALINA_HOME/shutdown.sh
script. (Many Uni=
x-based installations will have a startup/shutdown script in the /etc=
/init.d
or /etc/rc.d
directories.)cd [dsp= ace-source]/dspace/target/dspace-[version]-build.dir ant -Dconfig=3D[dspace]/config/dspace.cfg update
Changes to the behavior of the 'ant up= date' script
The ant update
script has changed slightly as of DSpace 1.8=
. It now defaults to replacing your existing configuration files (after bac=
king them up first). See the C=
hanges to the DSpace 1.8 Upgrade / Configuration Process note at the to=
p of this page for more details.
[dspace= ]/bin/dspace index-init
[dspace]/webapps
directory to the s=
ubdirectory of your servlet container (e.g. tomcat):=20
cp -R [= dspace]/webapps/* [tomcat]/webapps/