UC Toolkit Compatibility with other User Image Versions

UC Toolkit Version	IPS Meta-data Version (User Image Version)	Behavior	Known Limitations	Related Issues
2.1	2.0	Silently converts to 2.1
2.2	2.0	Silently converts to 2.2
2.3	2.0	Silently converts to 2.3
2.4	2.0	Will convert to 2.4 if 2.4 updatetool is in the same image. pkg(1) will silently convert to 2.4	Updatetool restart will fail after upgrade.
2.0	2.1	Works with limitations	pkg search finds no matches	1483
2.2	2.1	Silently converts to 2.2
2.4	2.1	Will convert to 2.4 if 2.4 updatetool is in the same image. pkg(1) will silently convert to 2.4	Updatetool restart will fail after upgrade.
2.0	2.2	Works with limitations	pkg search finds no matches any operation writing cfg_cache loses 2.2 publisher properties, variants Traceback faced if the User Image has pending updates when Available Updates View is selected	750 1483
2.1	2.2	Works with limitations	pkg search finds no matches any operation writing cfg_cache loses 2.2 publisher properties, variants	1483
2.0	2.3	Works with limitations	pkg search results to an Error
2.4	2.2	Will convert to 2.4 if 2.4 updatetool is in the same image. pkg(1) will silently convert to 2.4	Updatetool restart will fail after upgrade.
2.4	2.3	Will convert to 2.4 if 2.4 updatetool is in the same image. pkg(1) will silently convert to 2.4	Updatetool restart will fail after upgrade unless on 2.3u1.

pkg(5) Meta-data Changes

1. Addition of state/installed directory.
2. Addition of image properties. The cfg_cache file was modified to store image properties in 2.0. With this change, the policy section of the cfg_cache file went away.
3. Addition of download cache. Before 2.0, the download directory only contains a download-pid to hold downloaded files, and the downloaded files were removed after the install. With 2.0, the downloaded files are maintained in a cache in the meta-data area.

2.1

1. Addition of disabled publishers. The disabled_auth file was added in 2.1.
2. Addition of "index" directory. The "index" file that is next to the manifest file is no longer used in 2.1, but rather an index subdirectory at the top of the meta-data area was added. This includes the main_dict file plus other index files.
3. Addition of the "history" directory. This directory contains XML files that store the operational history for the image.

2.2

1. Restructuring of search index. The search index area was restructured in 2.2 to version 2. The main_dict file is still there, but now there are also at* and st* files.
2. More publisher information. The cfg_cache and disabled_auth files now contain more attributes for each authority (aka publisher). If 2.1 or 2.0 reads and then writes the file, this additional information is lost.
3. Addition of variants. The cfg_cache file now includes a variants section. If 2.1 or 2.0 reads and then writes cfg_cache, the variants information is lost.

2.4

1. New catalog format. The catalogs from publishers, the data about what packages are installed, and the catalog cache containing information about what packages are available are all stored in new JSON format set of files.
2. New download directory format. The new format uses only a single level of directory structure to store files.
3. Addition of facets. The cfg_cache file now contains a facets section.
4. Publisher name from server. The 2.4 publisher information on the server includes the name of the publisher. This name must be used on the client.

Questions

• Should 2.2 warn before converting an older image?
• Should notifier registration always force re-registration if the currently registered version is older?
• If 2.0/2.1 fails on 2.2 what is the failure mode? Does it no longer corrupt? Need the IPS bug id for the issue where IPS should fail cleanly on an image version it does not support.

UC Toolkit Client vs Server Compatibility

UC Client Version	UC Server Version	Behavior	Known Limitations	Related Issues
2.1	2.0		Remote Search not working	825
2.2	2.0	Compatible
2.3	2.0		Client no longer supports search version/0, server does not support search version/1
2.4	2.0		Client no longer supports search version/0, server does not support search version/1
2.0	2.1
2.2	2.1	Compatible
2.3	2.1		Client no longer supports search version/0, server does not support search version/1
2.4	2.1		Client no longer supports search version/0, server does not support search version/1
2.0	2.2	Compatible	A colon displayed before the Category if updatetool from UC20 is used with an UC22 Server	1263
2.1	2.2	Compatible
2.3	2.2	Compatible
2.4	2.2	Compatible
2.4	2.3	Compatible

Upgrade Test Reports

• 2.3 Upgrade Test Report

This page (revision-10) was last changed on 13-Jan-10 09:01 AM, -0800 by TomMueller.
This page was created on 13-Aug-09 09:25 AM, -0700 by DiPol.

More info...