rBuilder:Release Notes/4

From rPath Wiki

The following release notes apply to 4.x versions of rBuilder.

rBuilder 4.1.1

Update-related Information

When updating an existing rBuilder installation to version 4.1.1, the update process varies depending on the version of the existing rBuilder installation:

• rBuilder 3.x -- Update to rBuilder 3.1.6 before starting the process to move to rBuilder Appliance 4.0.x as outlined in Update Path to 4.x. You must update to the latest version of the rBuilder 4.0.x series before updating to rBuilder 4.1.0.
• rBuilder 4.0.x -- Using the rPath Appliance Platform Agent (rAPA) interface for appliance administration, update the rBuilder 4.0.x installation. When this update is complete, use the PostgreSQL Conversion task, temporarily added to the rAPA interface, to convert the rBuilder repositories to PostgreSQL. Note: You must convert to PostgreSQL; until you do so, your rBuilder 4.1.0 configuration is not eligible for product support.
• rBuilder 4.1.0 -- Using the rPath Appliance Platform Agent (rAPA) interface, update the rBuilder 4.1.0 installation. Verify the version information contained in the footer of the rBuilder front page.

When updating from 3.x to 4.x.x (depending on the size and number of repositories hosted by the rBuilder appliance) the update to 4.1.0 and subsequent versions may take a few hours and require interaction with rPath Support if there are any issues. Therefore, be sure to plan sufficient time to complete the entire 3.x to 4.1.x update process.

For more information, see Update Path to 4.1.0.

Web Front End Changes

• The "Domain Name" field, which was removed from the "New Product" page in version 4.1.0, has been restored. RBL-3037

Bug Fixes

• Extra troves such as anaconda-custom selected through the web interface are now properly included in builds. RBL-3011
• Custom troves with names other than the default can now be used in builds. RBL-2957
• Packages with names starting with "kernel" that are not named "kernel" will no longer be pinned by default in generated images. RBL-3000
• domU-flavored images based on rPath Linux 2 now have the correct root device label. RBL-3036
• Log files written by scripts such as outbound mirrors are now properly created after they are rotated. RBL-3087

rBuilder 4.1.0

Update-related Information

When updating an existing rBuilder installation to version 4.1.0, the update process varies depending on the version of the existing rBuilder installation:

• rBuilder 3.x -- Update to rBuilder 3.1.6 before starting the process to move to rBuilder Appliance 4.0.x as outlined in Update Path to 4.x. You must update to the latest version of the rBuilder 4.0.x series before updating to rBuilder 4.1.0.
• rBuilder 4.0.x -- Using the rPath Appliance Platform Agent (rAPA) interface for appliance administration, update the rBuilder 4.0.x installation. When this update is complete, use the PostgreSQL Conversion task, temporarily added to the rAPA interface, to convert the rBuilder repositories to PostgreSQL. Note: You must convert to PostgreSQL; until you do so, your rBuilder 4.1.0 configuration is not eligible for product support.

Depending on the size and number of repositories hosted by the rBuilder appliance, the update to 4.1.0 and subsequent conversion to PostgreSQL may take a few hours and require interaction with rPath Support if there are any issues. Therefore, be sure to plan sufficient time to complete the entire 4.1.0 update process.

For more information, see Update Path to 4.1.0.

Web Front-end Changes

• New: rBuilder 4.1.0 has been modified to provide a more product-focused development environment. This includes the following changes:
  • The top-level "project" construct is now referred to as a "product." RBL-1641
  • "Builds" are now referred to as "images." RBL-2645
  • rBuilder's initial setup page has a new option under "Repository Setup" to specify the namespace to be used by all products. RBL-2564
  • The new product creation form has been updated to ask for the product title, short name (previously the project name), type (appliance or component), initial version number, and repository commits email address. RBL-2508, RBL-2590
  • After creating a new product, the user is guided through the process of creating an initial version for the product; a product version can contain an "image set" which is used to control the creation of multiple images at once. RBL-2715
  • Newly-created products have an initial development label created in the form <shortname>.<domainname>@<namespace>:<shortname>-<version>-devel. RBL-2508
  • A sample group recipe, ready for customization, is committed to the initial version of all appliance-type products. RBL-2515
  • Developers can create a set of images for a given product and version from web interface. RBL-2798
  • When publishing a release, there is now a checkbox option to publish only those troves that are part of the release to an Update Service. RBL-2511, RBL-2541, RBL-2665
• New: Citrix XenServer (TM) is now an available image type. RBL-2642
• New: Developers can choose a different anaconda-templates, anaconda-custom, and/or media-template when editing an existing image. RBL-2172
• New: External products configured for inbound mirroring can now be backed up. RBL-2039
• Update: Group Builder has been removed from rBuilder. RBL-2514
• Update: The License and Crypto report has been streamlined, eliminating duplication of information. In addition, a link to the full text of the license is provided (if license text is available). RBL-2521
• Update: The footer "Help" link has been replaced with a link for the User Guide, and a link to the Administration Guide has been added for administrative users. RBL-2622
• Update: Jobmaster and MCP logs may now be viewed in the rAPA appliance log viewer. RBL-2728
• Update: Links to the Appliance Logs viewer have been added to the Inbound and Outbound Mirror plugin. RBL-2918
• Fixed: An Internal Server Error when attempting to generate a License and Crypto report if the underlying Conary repository operation failed RBL-2595
• Fixed: Compatibility with Firefox 3 RBL-2774

Build System Changes

• New: The anaconda-custom and media-template packages are resolved against the image group's label instead of the product's default label. RBL-2825
• New: The configuration option anacondaTemplatesFallback, may be used to change the default label that gets searched when trying to find anaconda-templates. RBL-2757
• New: rBuilder supports the EXTLINUX bootloader. RBL-1924
• Update: ISO images have default artwork that states, "Created with rBuilder." RBL-2922
• Update: SHA1 sums are generated for use by the Appliance ISO installer. RBL-2762
• Update: ISO images which contain a kickstart file for the installer can be booted interactively. RBL-2786
• Fixed: Large images that used Tar for compression (e.g. Tarball, VMware) are now correctly written. RBL-2804
• Fixed: Image files archived using tar are named with the .tar.gz extension. RBL-2663
• Fixed: VMX files do not automatically reference a CD/DVD device. RBL-2859
• Fixed: rBuilder fully supports 64-bit Amazon Machine Images (AMI). RBL-2270
• Fixed: Image builds failed when a product was hidden. RBL-2619
• Fixed: When creating builds with custom anaconda-templates and with the XML-RPC log file enabled, an error occurred. RBL-2764
• Fixed: rBuilder can generate image files larger than 2 GiB. RBL-2789

Command-Line Client Changes

• Update: The command-line client's build-create command accepts the --name option to set the name of the new image build, and --build-notes and --build-notes-file to set the image build notes from the command-line and from a file, respectively. RBL-2486
• Fixed: The rBuilder command-line client used the wrong flavor of anaconda-templates when the flavor was not specified. RBL-2760

Internal Changes

• New: New rBuilder installations use PostgreSQL as the repository database for each product. Existing installations have a temporary rAPA task that should be used to migrate existing SQLite repositories to PostgreSQL. RBL-2650
• Update: rBuilder requires Conary 2.0. RBL-2580
• Update: Server back-end errors contain full traceback information for easier debugging and support. RBL-2567
• Fixed: Commit mail, recent commits, and other data on installations migrated from rBuilder 3.x will update correctly. RBL-2648

rBuilder 4.0.2

Updates from rBuilder 3.1.4 or earlier require an update to 3.1.5 or later prior to migrating to 4.0.2. An rPath representative will be assisting in such updates, and details are available at Update Path to 4.x in the rBuilder Appliance Administration Guide. Customers with 4.0.0 or later can update without this special migration path.

• Fixed: A kernel vulnerability created a security risk on the underlying system (RPL-2237)
• Fixed in 4.0.2-4-1 and later: Migration issues from backups created in version 3.1.6 and later

rBuilder 4.0.1

Updates from rBuilder 3.1.4 or earlier require an update to 3.1.5 or later prior to migrating to 4.0.1. An rPath representative will be assisting in such updates, and details are available at Update Path to 4.x in the rBuilder Appliance Administration Guide. Customers with 4.0.0 or later can update without this special migration path.

Web Front-end Changes

• New: Project owners and administrators can configure a project to send email to an arbitrary email address each time something is committed to the project repository. (RBL-1568)
• New: The log viewer in the Appliance Agent interface includes Apache's access_log and error_log. (RBL-2250)
• New: The Appliance Agent log file is viewable in its log viewer interface. (RBL-2451)
• New: rBuilder accepts non-"admin" Appliance Agent users when adding an outbound mirror target. (RBL-2408)
• Update: Accessing help in project resources now opens a new browser window. (RBL-2287)
• Update: rBuilder command line client can be installed on systems running Conary 2.0. (RBL-2477)
• Fixed: Uploading an invalid GPG key no longer causes the web UI to backtrace. (RBL-1625)
• Fixed: A regression related to the anaconda-templates advanced build option has been fixed. (RBL-1760)
• Fixed: An unused and invalid CSS style that caused warnings in some browsers. (RBL-2450)

Build System Changes

• New: The build system uses Xen 3.1.0 and Linux kernel 2.6.20 for enhanced stability and better hardware support.
• New: Images built by rBuilder use the Conary pin feature for the kernel package. (RBL-2412)
• New: The Anaconda template web service uses the Conary proxy provided by rBuilder when generating templates. (RBL-2429)
• Update: Compatibility changes have been made to support newer Anaconda templates using the latest rPath Linux development images. This only affects users building bleeding-edge builds using the latest anaconda-templates package. (RBL-2493)
• Update: Builds that were migrated from rBuilder 3.x can be rebuilt using the most recent Job Slave version. (RBL-2484)
• Fixed: Zombie processes were left behind if the Anaconda template web service failed to build and cache the template. (RBL-2323)
• Fixed: The partition sizing algorithm used in previous versions of the Job Slave caused some builds to prematurely run out of space when building an image. (RBL-2330)
• Fixed: Previous versions of the Job Master left behind lock files which prevented a new job slave image from being created in the case of a system failure. These lock files are now cleaned up when the Job Master starts. (RBL-2444)
• Fixed: The Conary client used by the Job Slaves was configured incorrectly to use /var/tmp instead of /tmp when building images. This resulted in the Job Slave process failing to build the job due to lack of disk space. (RBL-2461)

rBuilder 4.0.0

This release applies only to new installations. Existing installations should wait until the next release before updating.

• rBuilder can build 64-bit bootable images for all image build types.
• The VMware image types create a gzip tar archive, eliminating the previous 4 GB limitation for such images.
• Group Builder uses group-appliance-platform from rPath Linux to provide basic operating system components. (RBL-1865)
• Each image build shows a SHA-1 message digest on its build page.
• Image builds are handled with a new system that works on top of Xen technology. Each build job is handled inside a Xen DomU. The goal of this job system is to make image builds faster.
• The rPath Appliance Platform Agent interface includes a "Job Control Console" page for managing image build jobs.
• Outbound mirroring allows for selecting one or more groups to mirror. (RBL-2351)
• Outbound mirroring by group recurses the selected group for all its contents and subgroups.
• When uploading GPG keys, projects are listed in alphabetical order. (RBL-2084)
• When uploading GPG keys, external projects are not listed. (RBL-2085)
• Apache logs have been consolidated into a single log. (RBL-2037)
• rBuilder logs are kept in /var/log/rbuilder (previously in /srv/rbuilder/logs).
• Fixed: VMware ESX images had the wrong guestOS setting in the VMX file. (RBL-2338)
• Fixed: Including troves from external projects caused permission issues when building images. (RBL-2184)
• Fixed: RepositoryMismatch errors occured when mirroring from an external project in caching mode. (RBL-2241)
• Fixed: An infinite loop and lock-up was created by certain Conary proxy errors. (RBL-1664)
• Fixed: When two or more outbound mirrors were configured for different labels, the rPath Appliance Platform Update Service would confuse the authentication and return insufficient permission errors. (RBL-2318)
• Known issue: When configuring the target for an outbound mirror in rBuilder, if the Update Service appliance user has a role of mirror and does not have a role of admin, mirroring will not work when mirroring by group.