org.apache.derbyTesting.functionTests.tests.upgradeTests

Class _Suite

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.apache.derbyTesting.junit.BaseTestCase

org.apache.derbyTesting.functionTests.tests.upgradeTests._Suite

All Implemented Interfaces:

junit.framework.Test

public class _Suite
extends BaseTestCase

Run the full upgrade suite. This is the only way to run tests in this package. A set of tests are run against a number of previous releases, see the static OLD_VERSIONS field in this class. Each test against the old release consists of following phases:

1. Create database with the old release.
2. Boot the database with the new release in soft upgrade mode. Try to execute functionality that is not allowed in soft upgrade.
3. Boot the database with the old release to ensure the database can be booted by the old release after soft upgrade.
4. Boot the database with the new release in hard upgrade mode, specifying the upgrade=true attribute.
5. Boot the database with the old release to ensure the database can not be booted by the old release after hard upgrade.

The class PhaseChanger is the decorator that sets up the fixtures to run in a given phase.

The test fixtures themseleves are in JUnit test classes that are sub-classes of UpgradeChange. The set of fixtures in BasicSetup is general setup and the changes per release are in classes of the form Changes10_1 etc.

The class UpgradeRun hooks up the test fixtures for a set of runs against a single old release into a single suite. Each fixture is run multiple times, once per phase against each old release.

See Also:

UpgradeRun, UpgradeChange

Field Summary

Fields

Modifier and Type	Field and Description
private static int[][]	old List of the versions to test against.
(package private) static java.lang.String	OLD_JAR_URL The saved location in svn at apache for older releases for testing
(package private) static java.lang.String	OLD_RELEASE_PATH_PROPERTY Property that indicates the location of the old releases.
(package private) static java.lang.String	OLD_VERSIONS_PATH_PROPERTY Property that gives the location of a file listing old versions to be tested.

Fields inherited from class org.apache.derbyTesting.junit.BaseTestCase

DEFAULT_DB_DIR, DERBY_LOG, ERRORSTACKTRACEFILE

Constructor Summary

Constructors

Modifier	Constructor and Description
private	_Suite(java.lang.String name) Use suite method instead.

Method Summary

Modifier and Type	Method and Description
static junit.framework.Test	suite()

Methods inherited from class org.apache.derbyTesting.junit.BaseTestCase

alarm, assertDirectoryDeleted, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertExecJavaCmdAsExpected, assertLaunchedJUnitTestMethod, assertLaunchedJUnitTestMethod, assertSecurityManager, assertThrowableEquals, currentDirectory, execJavaCmd, execJavaCmd, fail, getClassVersionMajor, getEmmaJar, getFailureFolder, getFilesWith, getJavaExecutableName, getSystemProperty, getTestConfiguration, getTestResource, hasInterruptibleIO, isCVM, isIBMJVM, isJ9Platform, isJava5, isJava7, isJava8, isPhoneME, isPlatform, isSunJVM, isWindowsPlatform, openTestResource, println, printStackTrace, readProcessOutput, removeDirectory, removeDirectory, removeFiles, removeSystemProperty, runBare, runsWithEmma, runsWithJaCoCo, setSystemProperty, sleep, sleepAtLeastOneTick, traceit

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runTest, setName, setUp, tearDown, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

OLD_VERSIONS_PATH_PROPERTY

static final java.lang.String OLD_VERSIONS_PATH_PROPERTY

Property that gives the location of a file listing old versions to be tested. To be able to override default values hard-coded for OLD_VERSIONS.

See Also:

Constant Field Values

OLD_RELEASE_PATH_PROPERTY

static final java.lang.String OLD_RELEASE_PATH_PROPERTY

Property that indicates the location of the old releases.

See Also:

Constant Field Values

OLD_JAR_URL

static final java.lang.String OLD_JAR_URL

The saved location in svn at apache for older releases for testing

See Also:

Constant Field Values

old

private static int[][] old

List of the versions to test against. The tests look for the jar files in each releasae in the folder: ${derbyTesting.oldReleasePath}/M.m.f.p If derbyTesting.oldReleasePath is not set then it is assumed the files can be accessed from the svn repository at apache. If this location is not available, then the test will fail. If the property is set, but ${derbyTesting.oldReleasePath}/M.m.f.p does not exist for a specific release then those sets of tests will be skipped. One can also set derbyTesting.oldReleasePath to a checked out version of the jars from the Apache svn repo. E.g. cd $HOME mkdir derby_upgrade cd derby_upgrade svn co https://svn.apache.org/repos/asf/db/derby/jars Then set derbyTesting.oldReleasePath as: -DderbyTesting.oldReleasePath=$HOME/derby_upgrade/jars when running tests.

Constructor Detail

_Suite

private _Suite(java.lang.String name)

Use suite method instead.

Method Detail

suite

public static junit.framework.Test suite()