From af74a6270d6ab6badf04a97495a6ef8ccded9b4b Mon Sep 17 00:00:00 2001 From: ramverma Date: Tue, 31 Jul 2018 18:25:39 +0100 Subject: Adding first set of apex-pdp document changes Adding document changes for auth, context, core, model, services & the main apex-pdp module. Change-Id: Id0d026baa258f1dc6998978f9911f3c4a73b5b3b Issue-ID: POLICY-867 Signed-off-by: ramverma --- .../adoc/fragments/howto-build/with-tests.adoc | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 src/site-docs/adoc/fragments/howto-build/with-tests.adoc (limited to 'src/site-docs/adoc/fragments/howto-build/with-tests.adoc') diff --git a/src/site-docs/adoc/fragments/howto-build/with-tests.adoc b/src/site-docs/adoc/fragments/howto-build/with-tests.adoc new file mode 100644 index 000000000..f8d300c45 --- /dev/null +++ b/src/site-docs/adoc/fragments/howto-build/with-tests.adoc @@ -0,0 +1,57 @@ +// +// ============LICENSE_START======================================================= +// Copyright (C) 2016-2018 Ericsson. All rights reserved. +// ================================================================================ +// This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE +// Full license text at https://creativecommons.org/licenses/by/4.0/legalcode +// +// SPDX-License-Identifier: CC-BY-4.0 +// ============LICENSE_END========================================================= +// +// @author Sven van der Meer (sven.van.der.meer@ericsson.com) +// + +== Build with standard Tests + +Use Maven to for a standard build with standard tests. + +[IMPORTANT] +.Some tests have specific timing Requirements +==== +Some of the tests have very specific timing requirements. +If run on a low-powered build machine, or if the build machine is on high load, those tests might fail and the whole build might fail as well. +If this happens, reduce the load on your build machine and restart the build. +==== + +[width="100%",options="header",cols="5a,5a"] +|==================== +| Unix, Cygwin | Windows +| +[source%nowrap,sh,numbered] +---- +# cd /usr/local/src/apex +# mvn clean install +---- +| +[source%nowrap,bat,numbered] +---- +>c: +>cd \dev\apex +>mvn clean install +---- +|==================== + +The build takes about 5-6 minutes with tests on a standard development laptop. +It should run through without errors, but with a lot of messages from the build process. +If build with tests (i.e. without `-DskipTests`), there will be error messages and stack trace prints from some tests. +This is normal, as long as the build finishes successful. + +When Maven is finished with the build, the final screen should look similar to this (omitting some `success` lines): + +[source%nowrap,sh,numbered,subs="attributes+"] +---- +include::{adsite-main-dir}/site-docs/adoc/fragments/screens/mvn-install-skiptests.txt[mvn build, with tests] +---- + +The build will have created all artifacts required for an APEX installation. + -- cgit 1.2.3-korg