This release of IBM UrbanCode Velocity is a maintenance release and includes various bug fixes and enhancements. This release is recommended for all customers.
Key Features and Enhancements
- Documentation improvement
- Documentation for several Insight metric as been updated for clarity. See Insights metric chart reference.
- Software updates
- RabbitMQ upgraded to version 3.8.9
- Nginx upgraded to version 1.19
- Bug fixes
- All associated applications are deleted when deleting a pipeline.
- When deleting an integration, a confirmation dialogue is displayed before the deletion is completed.
- The The pre-install.yaml file has been renamed to pre-install-for-cluster.yml.
- When copying a release all templates are copied.
- When installing on OpenShift version 4.4 and later, the OpenShift templates no longer need to be manually modified prior to installation.
- Performance improvements made for faster loading of the Home page.
- Selecting versions for a deployment template displays its own values versus those of a previously selected version.
- LDAP connections timing out corrected with added reconnect setting to the client.
- Permission needed to create cluster resources and to create resources at the namespace level permission is needed at the namespace level.
Note: Red Hat dropped support for OpenShift version 4.3 in December 2020. Beginning with this release, it is no longer supported in UrbanCode Velocity.
The following table is a cumulative list of fixes in the 2.0.x
|PI99806||Velocity 1.5.1 Upgrade could Prevent Access to Deployment Plans and Reports (Fixed with v1.5.2)|
|PI99820||Delete app option in release pipeline deletes all other apps|
|PI99820||Deployment template tasks get deleted when pipeline app is deleted|
|PI99811||Add initContainer to kube config so release-events-api is last to start|
|PI99814||Force lowercase for emails imported from UCD – AMF|
|PI99817||Can schedule or join a release on pipeline of Jenkins apps if any of the deploy stage app have not yet run cell|
|PI99809||Safely downgrade customers from CE|
|PI99805||Fixed Jenkins plugin that could break Jenkins Server|
|PI99803||Fixes a performance issue that could occur when integrating with an UrbanCode Deploy version older than v18.104.22.168|
Plan and prepare
For supported platforms and requirements you can dynamically
generate a system requirements report using the Software Product Compatibility Reports (SPCR) tool.
Install the server
There are two option to obtaining the installation package: online installer and offline installer. Both options require a master license key, which can be acquired from IBM Passport Advantage.
The online installer option for installing the product requires an internet connection for the entire process. It requires minimum storage for the downloaded package. The downloaded image contains only the Helm charts used to pull the product Docker images from a GitHub location. This is our recommended installation method.
Download the online installer package depending on the platform, the product is being installed.
After the download completes, start the executable file to begin the install process.
Use the offline installer to install Velocity without internet connection. You will still need internet connection at some point to download the installer itself. Once downloaded, the installer will include all containers needed to successfully install the product. For this reason, the offline installer is larger than the online installer and will require more time/bandwidth and disk space when downloading.
The installation package is available from IBM Fix Central. Search and select the installation package appropriate for the installation platform.
After downloading the installation package, decompress the contents into two directories: one for Kubernetes and the other for Docker Compose. See the documentation section on installation for instructions about how to install the server.
A product license key is required to install the product. To obtain a key, you must agree to the terms and conditions provided on Passport Advantage.
To learn more about UrbanCode Velocity, see documentation.
For help installing or using UrbanCode Velocity, post your questions in the UrbanCode forums. Tag your question with velocity.
To suggest an enhancement to the product, visit the RFE Community
For information from support, including FAQs, visit the IBM Support portal. You can configure the support portal to view information about specific products.
Starting in 2.1.0
The Jenkins UrbanCode Velocity plug-in is now prerequisite and must be installed. The allows for running Jenkins jobs as a part of a deployment plan in UrbanCode Velocity. Version 2.1.0 of the plug-in is required. For more information about the plugin, see the Jenkins website.
Starting in 2.0.0
Starting in UrbanCode Velocity v2.0.0, the MongoDB server 3.4 is no longer supported. UrbanCode Velocity v2.0.0 supports MongoDB server versions: 3.6, 4.0, and 4.2. For more information about out of service MongoDB server versions, see Mongo website.
- Docker Compose installations automatically upgrade to 3.6.
- Helm installations require manual upgrade or installation of the MongoDB server to 3.6 or later.
- New Helm installations use MongoDB 4.2 according to the Helm chart.
1.5.1 Improves Upgrade Support for all Prior Versions
All versions can be directly upgraded to 1.5.1 or later. Helm upgrades from 1.4.5 and 1.5.0 avoid previous complications. Velocity 1.5.1 also fixes an old issue that required versions older than 1.2.6 to upgrade to 1.2.6 before upgrading further.
NOTE: Helm upgrades from versions prior to 1.5.0 still require
helm delete --purge <release_name>
Starting in 1.5.0
Starting with v1.5.0, we have added and modified some Helm Selectors to adhere with best practices. Therefore, running the
helm upgrade command from a previous version of UrbanCode Velocity will fail. All upgrades from a version prior to v.1.5.0 to v1.5.0 or later will require a Helm purge as described below.
- Delete your currently installed release with
helm delete --purge <release_name>, where
<release_name>is the name of your current UrbanCode velocity release.
- Follow the normal install directions with all previous name and values from your previous release.
Note: Your Mongo database will be not be modified as it is maintained outside of the installation.
Starting in 1.4.5
In v1.4.5, the distributed version of MongoDB was upgraded from v3.4 to v3.6. Docker Compose installs will see the upgrade happen automatically. Other Docker platforms, such as: OpenShift and Kubernetes will need to manually upgrade their MongoDB instance. MongoDB v3.4 is still supported as of the release of v1.4.5. However, MongoDB v3.4 has been End of Life by Mongo, so we recommend customers upgrade at their earliest convenience.
Going forward, when our shipped version of MongoDB is upgrade, we continue to support the prior version of MongoDB, but deprecate the version before that. For example, when the shipped version of MongoDB is upgrade to v4.0, support is continued for v3.6 and and v3.4 is deprecated. We estimate that this will require two MongoDB upgrades per year, which should not force our Enterprise Docker Platform users to upgrade their MongoDB image more than once a year.