Differences between revisions 1 and 2
Revision 1 as of 2009-09-22 12:44:05
Size: 3754
Editor: TueLarsen
Comment:
Revision 2 as of 2009-09-22 12:45:03
Size: 3675
Editor: TueLarsen
Comment:
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 This page describes how to
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. 
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.
Line 10: Line 5:
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 11: Line 7:
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)
Line 14: Line 9:
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.
export PORT=8076 (where 8076 with the given port number for the test)
Line 19: Line 11:
(1) The new default multi-bitapp test, where one of the Windows machines have 3 bitapps: 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 21: Line 13:
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.
Line 22: Line 15:
all_test.sh
(2) The test scenario with a single replica and 'physical location' (also known as the 'one leg' scenario).
(1) The new default multi-bitapp test, where one of the Windows machines have 3 bitapps:
Line 25: Line 17:
all_test.sh (2) The test scenario with a single replica and 'physical location' (also known as the 'one leg' scenario).
Line 26: Line 19:
all_test_single.sh
(3) The old test, where all 'bar' machines have a single bitapp: 
all_test_single.sh (3) The old test, where all 'bar' machines have a single bitapp:
Line 29: Line 21:
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):
Line 30: Line 23:
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 start_test.sh
Line 33: Line 25:
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:
Line 34: Line 27:
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
start_test.sh
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:
Line 40: Line 29:
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
Line 41: Line 31:
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:
 . CVS_RSH=ssh cvs -d:ext: test@kb-prod-udv-001.kb.dk :/home/cvsroot checkout -P -d settings projects/webarkivering/conf/settings.xml
->
Line 45: Line 34:
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:
 . 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:
Line 53: Line 37:
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
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

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 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)

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.

(1) The new default multi-bitapp test, where one of the Windows machines have 3 bitapps:

all_test.sh (2) The test scenario with a single replica and 'physical location' (also known as the 'one leg' scenario).

all_test_single.sh (3) The old test, where all 'bar' machines have a single bitapp:

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 start_test.sh

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

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