Differences between revisions 1 and 9 (spanning 8 versions)
Revision 1 as of 2009-09-22 12:44:05
Size: 3754
Editor: TueLarsen
Comment:
Revision 9 as of 2010-08-16 10:25:09
Size: 1210
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Install/reinstall release package and start the system  This page describes how to Install/reinstall release package and start the system
Line 4: Line 3:
Optionally close an earlier instance of the system
Install a new instance
Start the new instance
This includes stopping existing old applications, emptying the JMS queues and move old data into a backup catalogs. Both bit-archive libraries and other old data are cleaned up. A pure and clean new installation is established.
Note: If there no tests have been executed on this port number before, then there might appear error messages about non-existing files etc. These errors are harmless.
This page describes how to
Line 10: Line 5:
 * Optionally close an earlier instance of the system
 * Install a new instance
 * Start the new instance.
 * Stop the instance.
This includes stopping existing old applications, emptying the JMS queues and move old data into a backup catalogs. Both bit-archive libraries and other old data are cleaned up. A pure and clean new installation is established.
Line 11: Line 11:
Do the following on kb-prod-udv-001.kb.dk as a test user:
Write the following in a prompt – note the relevant replacements
Note: If there no tests have been executed on this port number before, then there might appear error messages about non-existing files etc. These errors are harmless.
Line 14: Line 13:
export TESTX=TESTk (where k must be replaced with the test number you are about to run, e.g. TEST8)
export PORT=8076 (where 8076 with the given port number for the test)
export MAILRECEIVERS=tlr@kb.dk (where the mail address must be replaced by address(es) for the relevant mail receiver(s) – specified by comma separation if more than one)
And then select one of three possible install scenarios (scripts) (the first is the default scenario, used unless the test states otherwise). All three scripts makes a clean restart, which stops previous installations, cleans up, make new installation and starts it up again.
Do the following on kb-prod-udv-001.kb.dk as a test user: Write the following in a prompt – note the relevant replacements
Line 19: Line 15:
(1) The new default multi-bitapp test, where one of the Windows machines have 3 bitapps: export TESTX=TESTk (where k must be replaced with the test number you are about to run, e.g. TEST8)
Line 21: Line 17:
export PORT=8076 (where 8076 with the given port number for the test)
Line 22: Line 19:
all_test.sh
(2) The test scenario with a single replica and 'physical location' (also known as the 'one leg' scenario).
export MAILRECEIVERS= tlr@kb.dk (where the mail address must be replaced by address(es) for the relevant mail receiver(s) – specified by comma separation if more than one)
Line 25: Line 21:
cleanup_all_test.sh
Line 26: Line 23:
all_test_single.sh
(3) The old test, where all 'bar' machines have a single bitapp:
prepare_test_dedup_disabled.sh
Line 29: Line 25:
install_test.sh
Line 30: Line 27:
all_test_old.sh
All test-scripts (all_test.sh, all_test_single.sh, all_test_old.sh) includes as basis the following commands (these were the previous commands used to reinstall the system):


export TIMESTAMP=`ls -t /home/release_software_dist/releases/NetarchiveSuite-* | head -1 | cut -d- -f2 | cut -d. -f1`
cleanup_test.sh
prepare_test.sh
install_test.sh
Line 40: Line 29:

For installation of EARLIER PACKAGE VERSIONS do the following on kb-prod-udv-001.kb.dk:
Normally there is a new release package for the test to be installed. However, if you do NOT want to use the newest release package then write export TIMESTAMP=000 with the svn version from the created release package you want to run, e.g. export TIMESTAMP=274 for NetarchiveSuite-274.zip
If installation fails this may be because the setting files are not fitting the TIMESTAMP file. In this case check which versions the settings files have in CVS (test@kb-prod-udv-001.kb.dk:/home/cvsroot - projects/webarkivering/conf/) at the time of writing this includes:

it_conf_test.xml
settings.xml
log.prop
jmxremote.password
security.policy
Hint: look at the time of the version (TIMESTAMP) checkin in SVN, and take earlier version of the CVS files.
Now create a Prepare_test_step2 file for the TIMESTAMP in question on test@kb-prod-udv-001:

cd /home/test/bin
cp prepare_test_step2_settings.sh prepare_test_step2_settings_$TIMESTAMP.sh
And insert version reference in the relevant CVS checkout commands for example
  CVS_RSH=ssh cvs -d:ext:test@kb-prod-udv-001.kb.dk:/home/cvsroot checkout -P -d settings projects/webarkivering/conf/settings.xml
->
  CVS_RSH=ssh cvs -d:ext:test@kb-prod-udv-001.kb.dk:/home/cvsroot checkout -r1.95 -P -d settings projects/webarkivering/conf/settings.xml
Now the installation is done again (assuming TIMESTAMP is already set) STEP BY STEP:

cleanup_test.sh
prepare_test_step1_unpack.sh
prepare_test_step2_settings_$TIMESTAMP.sh
prepare_test_step3_modify.sh
prepare_test_step4_deploy.sh
install_test.sh
start_test.sh
stop_test.sh

Install/reinstall release package and start the system

This page describes how to

  • Optionally close an earlier instance of the system
  • Install a new instance
  • Start the new instance.
  • Stop the instance.

This includes stopping existing old applications, emptying the JMS queues and move old data into a backup catalogs. Both bit-archive libraries and other old data are cleaned up. A pure and clean new installation is established.

Note: If there no tests have been executed on this port number before, then there might appear error messages about non-existing files etc. These errors are harmless.

Do the following on kb-prod-udv-001.kb.dk as a test user: Write the following in a prompt – note the relevant replacements

export TESTX=TESTk (where k must be replaced with the test number you are about to run, e.g. TEST8)

export PORT=8076 (where 8076 with the given port number for the test)

export MAILRECEIVERS= tlr@kb.dk (where the mail address must be replaced by address(es) for the relevant mail receiver(s) – specified by comma separation if more than one)

cleanup_all_test.sh

prepare_test_dedup_disabled.sh

install_test.sh

start_test.sh

stop_test.sh

NetarkivInstall (last edited 2010-08-16 10:25:09 by localhost)