[karaf] rename gshell to shell and rename submodules to avoid having the parent module name in their names
git-svn-id: https://svn.apache.org/repos/asf/felix/trunk@816769 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/karaf/RELEASE-NOTES b/karaf/RELEASE-NOTES
new file mode 100644
index 0000000..1c1c785
--- /dev/null
+++ b/karaf/RELEASE-NOTES
@@ -0,0 +1,373 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+ Apache ServiceMix Kernel 1.1.0
+ ==============================
+
+ Overview
+ --------
+
+ The Apache ServiceMix Kernel 1.1.0 release brings a lot of new features enhancements and bug fixes:
+ * remote connection using SSH protocol
+ * provisioning enhancements: versioning / hot deployment of features
+ * new commands, including OSGi related commands for the Configuration Admin and Package Admin services
+ * improved spring integration: upgrade to spring 2.5.6 and spring-dm 1.2.0-m2, the osgi/list command
+ now displays spring applications status
+ * container level locking for master / slave deployments
+ * support for JAXP 1.4 on all platforms
+ * improved JMX support for managing the OSGi framework and features
+ Note that the commands syntax has changed due to the upgrade to the latest gshell version.
+
+ Known issues
+ ============
+
+ * [SMX4KNL-141] - The config/edit command changes does not takes precedence over configuration files in the etc folder at restart
+ * [SMX4KNL-183] - features/uninstall behaves different in version selection than features/install
+ * [SMX4KNL-189] - Shell completion works only in the root shell
+ * [SMX4KNL-200] - The client jar / ssh daemon should support direct commands
+ * [SMX4KNL-227] - Full support of fragment bundles
+ * [SMX4KNL-228] - Warning messages when using OpenSSH 5.1 to connect to ServiceMix Kernel
+ * [SMX4KNL-231] - Unable to log into ServiceMix Kernel using OpenSolaris SSH client
+ * [SMX4KNL-232] - Unable to log into ServiceMix Kernel using Windows putty SSH client
+
+ Changelog
+ ---------
+
+ The following list shows the bug fixes and enhancements included in this release:
+
+ ** Bug
+ * [SMX4KNL-72] - If there is no etc/startup.properties, the kernel hangs without displaying any error
+ * [SMX4KNL-79] - When starting the kernel, a log entry states "Can not install feature ''"
+ * [SMX4KNL-86] - When running integration tests, the container classpath contains all the test bundles which may cause problems
+ * [SMX4KNL-87] - Problems with batch files on windows
+ * [SMX4KNL-95] - kernel build failed in testing/itests
+ * [SMX4KNL-96] - package missing for felix.config.properties
+ * [SMX4KNL-97] - Dissociate the name and the location of ServiceMix Kernel instances managed by the admin shell
+ * [SMX4KNL-100] - The client does not close when running "osgi shutdown" command
+ * [SMX4KNL-102] - The file monitor should use ${servicemix.base} for default polling locations
+ * [SMX4KNL-104] - When using a remote connection, errors are not reported correctly
+ * [SMX4KNL-105] - Features are reinstalled on restart of servicemix
+ * [SMX4KNL-112] - gshell pom needs to include gshell-config and gshell-packages modules
+ * [SMX4KNL-115] - config.properties for SMX-Kernel needs to be updated
+ * [SMX4KNL-117] - The Smx testing platform should take into account the boot delegation packages specified in the configuration file
+ * [SMX4KNL-118] - The configuration file for felix comes from 3 different places in the svn tree, only one copy should be used
+ * [SMX4KNL-122] - When using the client and trying to connect to another instance using the "admin connect" command, the console hangs
+ * [SMX4KNL-123] - XML parsing does not work on non Sun JVMs and Sun's SAAJ bundle requires Sun's JAXP implementation
+ * [SMX4KNL-124] - Issuing command "log d" fails with NullPointerException on AIX.
+ * [SMX4KNL-126] - The user is no more authenticated with the new gshell integration
+ * [SMX4KNL-128] - Remove OBR support from default distribution
+ * [SMX4KNL-132] - osgi/list command should display the spring application state
+ * [SMX4KNL-133] - jaxp-ri bundle miss javax.xml.datatype.DatatypeFactory factoryId under META-INF/services
+ * [SMX4KNL-134] - XPathFactoryFinder in jaxp api should use factoryId to load the spi class in osgi enviroment
+ * [SMX4KNL-135] - Remote shell missing help resources
+ * [SMX4KNL-138] - No command history with Shell console
+ * [SMX4KNL-140] - Shell commands references not cleaned up when bundle uninstalled
+ * [SMX4KNL-142] - Starting a new instance that was created with admin on windows fails to start
+ * [SMX4KNL-145] - java.lang.IllegalStateException: Streams not registered for thread
+ * [SMX4KNL-148] - OPS4J maven repo missing form default search list
+ * [SMX4KNL-149] - Build failure due to new sshd snapshot
+ * [SMX4KNL-150] - Shell group name variable doesn't resolve
+ * [SMX4KNL-151] - Update displayed version in Shell to be 1.1.0-SNAPSHOT for trunk
+ * [SMX4KNL-153] - Stopping one of the "core" bundles of the servicemix engine block the server
+ * [SMX4KNL-155] - Error changing manifest while bundle is deployed
+ * [SMX4KNL-162] - The default jaas realm uses the config admin to store clear password
+ * [SMX4KNL-164] - features/removeUrl does not remove the repository
+ * [SMX4KNL-165] - Initial provisioning using features is very slow especially when using snapshots
+ * [SMX4KNL-170] - Unknown protocol: org.apache.servicemix.kernel.gshell
+ * [SMX4KNL-172] - the new command optional/cat from gshell can't support mvn/http protocol
+ * [SMX4KNL-174] - NoClassDefFoundError jline/ConsoleReader when invoking servicemix-client
+ * [SMX4KNL-176] - 'features/install xxx' tries to install version 0.0.0 instead of the latest one
+ * [SMX4KNL-177] - Some of the Optional commands have moved to different packages in the latest snapshot of geronimo gshell
+ * [SMX4KNL-178] - Remove debug log statements when booting
+ * [SMX4KNL-180] - features/install xxx barfs when using non osgi compliant versions
+ * [SMX4KNL-181] - osgi/install -s throws a NPE if the bundle can not be resolved
+ * [SMX4KNL-182] - Upon restart, the list of previously installed features is not available anymore
+ * [SMX4KNL-185] - Features JMX view does not reload persistent state on restart
+ * [SMX4KNL-187] - Features JMX view making too much log noise
+ * [SMX4KNL-188] - Gshell itests fail on windows
+ * [SMX4KNL-190] - Deployment / Startup of spring xml configurations doesn't work correctly
+ * [SMX4KNL-192] - ServiceMix Kernel startup blocks
+ * [SMX4KNL-198] - The console / server / client arguments to servicemix shell script are broken
+ * [SMX4KNL-199] - Missing resource bundle for obr shell
+ * [SMX4KNL-201] - The client jar does not exit when running with --help argument
+ * [SMX4KNL-202] - Startup of a pending to deploy Spring config file fails when all required bundles got installed
+ * [SMX4KNL-204] - OsgiConfiguration.unregister() throw NPE when exit smx
+ * [SMX4KNL-205] - "ld | grep WARN" does not filter while "log/display | grep WARN" does
+ * [SMX4KNL-207] - features/install should install latest feature version for any dependency that does not explicitly specify a dependency
+ * [SMX4KNL-208] - Bundle#loadClass sometimes return null instead of throwing a CNFE
+ * [SMX4KNL-212] - Exceptions are displayed in the console when trying to load default xml catalogs
+ * [SMX4KNL-215] - Don't attempt to stop fragments in filemonitor
+ * [SMX4KNL-218] - Can't find bundle for base name org.apache.servicemix.kernel.gshell.wrapper.InstallCommand, locale fr_BE
+ * [SMX4KNL-220] - The org.apache.servicemix.kernel.management bundle should not use DynamicImport-Package=*
+
+ ** Improvement
+ * [SMX4KNL-36] - Investigate having a different bootstrap mechanism for a remote client to not start all the bundles installed (maybe by not using osgi)
+ * [SMX4KNL-62] - Enhance admin shell create command to allocate unique ports to new instances.
+ * [SMX4KNL-74] - When using the spring deployer, allow the customization of the OSGi manifest entries
+ * [SMX4KNL-78] - Small refactoring of the Feature interface
+ * [SMX4KNL-85] - Extend Shell#waitForFrameworkToStart to wait 60 seconds instead of 5 seconds.
+ * [SMX4KNL-101] - Reduce the amount of logging issued by mina
+ * [SMX4KNL-106] - Support for container level lock to support master/slave deployments
+ * [SMX4KNL-114] - prompt should print username@instance-name when using remote shell
+ * [SMX4KNL-119] - Use boot delegation instead of listing sun packages for jaxp / url handlers
+ * [SMX4KNL-120] - The ServiceMix Kernel testing platform should use the servicemix kernel main jar instead of the felix one
+ * [SMX4KNL-121] - Improve the Main class to easily embed the whole ServiceMix Kernel distribution in another web application
+ * [SMX4KNL-125] - Show command environment in kernel shell
+ * [SMX4KNL-127] - Add the update command in the osgi shell
+ * [SMX4KNL-130] - Support configurable lock directory for container level locking (for master/slave deployments).
+ * [SMX4KNL-136] - Upgrade to pax logging 1.2.0
+ * [SMX4KNL-154] - some Action moved from to another package cause kernel start up failed
+ * [SMX4KNL-158] - Move jline into its own bundle instead of using a private package in gshell-core
+ * [SMX4KNL-169] - Use the start level to implement the container level locking
+ * [SMX4KNL-184] - Align the commands name with the gshell ones
+ * [SMX4KNL-186] - features/uninstall should select the right version if only one version has been installed
+ * [SMX4KNL-191] - Upgrade to pax-logging 1.3.0
+ * [SMX4KNL-203] - When installing a feature, the service should first install all bundles, then start them all in order
+ * [SMX4KNL-206] - Felix version in servicemix-kernel-1.1.0-snapshot doesn't seem to support fragment bundles.
+ * [SMX4KNL-216] - Display fragments informations in the osgi list command
+ * [SMX4KNL-230] - Log statements using java.util.logging are logged into both stderr and data/log/servicemix.log file
+
+ ** New Feature
+ * [SMX4KNL-28] - Create a config command to administer the ConfigAdmin service
+ * [SMX4KNL-33] - Enhance admin shell to provide commands to start / stop / list / connect to known ServiceMix instances
+ * [SMX4KNL-60] - Versionning of features
+ * [SMX4KNL-76] - support to install/uninstall different version of features
+ * [SMX4KNL-90] - Create new commands to leverage the PackageAdmin OSGi service
+ * [SMX4KNL-94] - Provide a JMX frontend on top of the features service
+ * [SMX4KNL-107] - Create a new "admin connect" command to easily connect to a named instance of servicemix
+ * [SMX4KNL-108] - Add a new 'log de' command that displays the last exception from the log
+ * [SMX4KNL-109] - Include the pax wrapper url handler in the kernel for ease of use of non osgi third party dependencies
+ * [SMX4KNL-111] - Add a "starting" state to the admin list command
+ * [SMX4KNL-113] - Upgrade to Felix 1.2.1
+ * [SMX4KNL-116] - Allow repository descriptors to reference other repository descriptors
+ * [SMX4KNL-131] - Include JAXP 1.4 API
+ * [SMX4KNL-143] - Provide a way to make BouncyCastle work in ServiceMix Kernel
+ * [SMX4KNL-144] - Use SSH as a remoting protocol to connect to a servicemix kernel
+ * [SMX4KNL-147] - Upgrade to spring-DM 1.2.0-m2
+ * [SMX4KNL-152] - The version number displayed in the console should be extract from resources (using maven filtering + properties file) but the branding should be easy to change so that people embedding the Kernel can define their own
+ * [SMX4KNL-156] - Move core management feature to the kernel
+ * [SMX4KNL-157] - Add a JAAS realm for authenticating users from SSH and JMX
+ * [SMX4KNL-163] - Provide default jdbc lock impl for master/slave deployments
+ * [SMX4KNL-167] - Upgrade to spring 2.5.6
+ * [SMX4KNL-171] - Include RFC0139 (JMX management of OSGi)
+ * [SMX4KNL-179] - Upgrade to felix 1.5.0-SNAPSHOT
+ * [SMX4KNL-214] - Hot deployment of features through the deploy folder
+
+ ** Task
+ * [SMX4KNL-43] - Upgrade to latest gshell
+ * [SMX4KNL-93] - Extract the admin commands in their own module
+ * [SMX4KNL-98] - Use dependency management section for all dependencies
+ * [SMX4KNL-99] - Remove ant from the kernel distribution and replace its use in the filemonitor
+ * [SMX4KNL-129] - Make sure aliases and links commands work with the new gshell integration
+ * [SMX4KNL-166] - Move the embedded smx demo into trunk
+ * [SMX4KNL-168] - Downgrade to junit 3.8
+ * [SMX4KNL-196] - gshell-core source jar should use the shade plugin to include the gshell sources
+ * [SMX4KNL-197] - The client source jar should include the slf4j sources using the shade plugin
+ * [SMX4KNL-211] - Remove one of jmock or easymock from the kernel
+
+
+
+
+ Apache ServiceMix Kernel 1.0.0
+ ==============================
+
+ Overview
+ --------
+
+ This release is the first GA release of ServiceMix Kernel. A few bugs and enhancements have been done
+ to the Kernel since the second release candidate. The most two important fixes from a user point of view
+ are SMX4KNL-70 which makes sure the bundles provided in the distribution are used first instead of the ones
+ from the user's local maven repository and SMx4KNL-77 which allows artifacts in the /deploy folder to be
+ started when the needed dependencies have been installed successfully (the previous behavior was to fail
+ if there were missing bundles when the artifact is processed).
+ See the change log below for more informations.
+
+ Changelog
+ ---------
+
+ The following list shows the bug fixes and enhancements included in this release:
+
+ ** Bug
+ * [SMX4KNL-70] - Bundles in /system folder should take precedence over local Maven repository
+ * [SMX4KNL-79] - When starting the kernel, a log entry states "Can not install feature ''"
+ * [SMX4KNL-80] - "features list" output has a "version" column but no infos
+ * [SMX4KNL-81] - The wrapper feature can not be installed out of the box
+ * [SMX4KNL-82] - The installation state of a feature is not displayed correctly after a restart when using the "features list" command
+ * [SMX4KNL-83] - When using the wrapper command, ServiceMix Kernel does not start correctly
+
+ ** Improvement
+ * [SMX4KNL-69] - Add installation status for the 'features list' result.
+ * [SMX4KNL-71] - Export the gshell CommandExecutor in the OSGi registry
+ * [SMX4KNL-73] - Require work around for blocking in.read() call in ProxyIO for automated testing.
+ * [SMX4KNL-75] - Modify Shell argument processing to execute multiple commands.
+ * [SMX4KNL-77] - The deployer should keep a list of installed bundles that failed to start and retry those when new bundles have been resolved
+ * [SMX4KNL-78] - Small refactoring of the Feature interface
+
+
+
+ Apache ServiceMix Kernel 1.0.0-rc2
+ ==================================
+
+Overview
+--------
+
+This second Release Candidate of Apache ServiceMix Kernel includes a few bug fixes and a few new features.
+The main change is that the system folder that contains the OSGi bundles to install in the runtime is now
+organized as a maven 2 repository, though it should not directly affect users. A more detailed changelog
+is following.
+
+Changelog
+---------
+
+The following list shows the bug fixes and enhancements included in this release:
+
+** Bug
+ * [SMX4KNL-34] - snapshot jar name mismatch in startup.properties and in the system folder
+ * [SMX4KNL-52] - Deployment of pain spring files does not work when using xml extensions because these are not available in the classpath
+ * [SMX4KNL-53] - During starting, files are redeployed several times, one each time a new Deployer is registered in OSGi
+ * [SMX4KNL-54] - Kernel does not start if system property "felix.cache.profiledir" is not defined
+ * [SMX4KNL-56] - Kernel does not start on Windows if classpath contains spaces
+ * [SMX4KNL-58] - Hot-deploy capability of FileMonitor does not update bundles properly on Windows.
+ * [SMX4KNL-63] - Possible deadlock at startup caused by the filedeployer not running in its own thread the first time
+ * [SMX4KNL-64] - The list of repositories for the features shell is not persisted across restart
+ * [SMX4KNL-65] - After copying or moving the kernel, it does not start in a very clean way anymore
+ * [SMX4KNL-68] - failed to start smx4
+
+** Improvement
+ * [SMX4KNL-51] - Add a configuration file for the maven url handler so that adding default repositories is easy enough
+ * [SMX4KNL-55] - Use maven shade plugin on the main module so that sources jar is correct
+ * [SMX4KNL-66] - When the file monitor loads configuration for the config admin, allow the use of system properties using ${xxx}
+
+** New Feature
+ * [SMX4KNL-61] - Organize the system folder as a maven 2 repository
+ * [SMX4KNL-67] - Allow the features service to obtain a list of features to install at startup
+
+** Task
+ * [SMX4KNL-57] - Extract bundles from the svn tree
+ * [SMX4KNL-59] - Upgrade to spring 2.5.5 / spring-dm 1.1.0
+
+
+
+ Apache ServiceMix Kernel 1.0-rc1
+ ================================
+
+This first Release Candidate of Apache ServiceMix Kernel includes a security framework based on
+JAAS allowing authentication using JAAS realms deployed at runtime and also allow keystores and
+trustores to be deployed and accessed through OSGi. This allow the remote console to be secured
+correctly (if the console is activated in a production environment, we strongly recommand to
+deploy a custom JAAS realm and new keystores when using the SSL connection). A few bugs have been
+fixed too.
+
+A release candidate (RC) is a distribution that has not been proven completely stable, but the
+feature set is the one that will be available in the final release. The number of RCs has not
+been fixed and it will depend on the feedback we obtain from this release, so please give it a try
+and report any problems you can find.
+
+** Bug
+ * [SMX4KNL-38] - Fix NullPointerException instead of Command not found in the console
+ * [SMX4KNL-40] - Remote console does not display output
+ * [SMX4KNL-41] - When using the remote command on the client from the command line, the process does not exit correctly
+ * [SMX4KNL-44] - Changed bundles restarted twice
+ * [SMX4KNL-45] - The "log display" command does not display anything when running from an instance that has been created using the "admin create" command
+ * [SMX4KNL-46] - After using the 'admin create' command, cpu goes to 100% until another command is entered
+ * [SMX4KNL-48] - ulimit error on MacOS X Leopard 10.5
+ * [SMX4KNL-50] - Kernel does not start on Windows
+
+** Improvement
+ * [SMX4KNL-39] - Make bundle locations for SMX configurable
+ * [SMX4KNL-49] - Upgrade to Spring 2.5.4, Spring-DM 1.1.0-m2, PaxLogging 1.1.1
+
+** New Feature
+ * [SMX4KNL-35] - Secure the connection between the client and the kernel in some way
+ * [SMX4KNL-37] - JAAS support
+
+
+ Apache ServiceMix Kernel 1.0-m3
+ ================================
+
+This third milestone of Apache ServiceMix Kernel brings a lot of new features:
+ * a provisioning system to install applications easily
+ * a log shell to visualize the logging output and change log levels
+ * pipe support on commands
+ * a bunch of new commands: history, grep, cat, ava, exec, sleep
+
+Note that this milestone does not include the latest spring version because
+the latest ones have wrong OSGi manifest headers and do not work.
+
+** Bug
+ * [SMX4KNL-22] - The console can not be reloaded at runtime
+ * [SMX4KNL-29] - Shell commands are not unregistered automatically when the last command is unregistered
+ * [SMX4KNL-31] - Aliases do not work when inside a subshell
+
+** Improvement
+ * [SMX4KNL-5] - Show gshell sub-shell name in prompt
+ * [SMX4KNL-6] - Error Message improvement on Gshell console.
+ * [SMX4KNL-10] - Handle dependant features correctly
+ * [SMX4KNL-21] - Allow pipes in command syntax
+ * [SMX4KNL-25] - Feature commands enhancement.
+ * [SMX4KNL-32] - Lazy load feature repositories to avoid delay when the url can not be accessed or things like that
+
+** New Feature
+ * [SMX4KNL-1] - Implements a log command
+ * [SMX4KNL-11] - Provisioning system
+ * [SMX4KNL-20] - Adding a new OBR command to reload the repository url's
+ * [SMX4KNL-23] - Add a grep command
+ * [SMX4KNL-24] - Add a few utils commands: cat, java, exec, sleep
+ * [SMX4KNL-26] - Spring URL handler to wrap xml spring files into bundles for direct installation.
+ * [SMX4KNL-27] - Include an implementation of the Preferences service
+ * [SMX4KNL-30] - Create an history command to be able to browse previous commands easily
+
+
+ Apache ServiceMix Kernel 1.0-m2
+ ================================
+
+This is the second milestone of ServiceMix Kernel, but mostly a bug fix release
+compared to the first milestone.
+
+** Bug
+ * [SMX4KNL-13] - startup issue in recognizing new files in deploy folder
+ * [SMX4KNL-15] - Display of memory size using the info command on Windows is ugly
+ * [SMX4KNL-16] - Bad error message when startup.properties lists a unknown file (the file name is not displayed, but 'null' instead)
+ * [SMX4KNL-18] - No need for DynamicImport-Package=* in filemonitor
+ * [SMX4KNL-19] - Performance problems when using the OSGi classloaders in a certain way
+
+** Improvement
+ * [SMX4KNL-4] - Add a start option on the 'osgi install' command so that the bundle is automatically started
+
+** Task
+ * [SMX4KNL-17] - Remove all the warnings when building the distribution tar.gz
+
+See the README.txt file for more general informations about ServiceMix Kernel.
+
+
+ Apache ServiceMix Kernel 1.0-m1
+ ================================
+
+See the README.txt file for more general informations about ServiceMix Kernel.
+
+This is the first milestone of ServiceMix Kernel. All the features are not
+fully implemented yet and things may be changed until the final 1.0 release.
+Please refer to the web site for more informations and feel free to ask any
+questions on the ServiceMix mailing lists or simply to provide feedback
+(we appreciate it very much).
+
+Thanks you for downloading ServiceMix Kernel. Enjoy !
+
+The ServiceMix Team
+http://servicemix.apache.org/team.html
+