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