This release replaces the Urbancode Deploy version 22.214.171.124 release. It includes all updates made in the 126.96.36.199 release. Version 188.8.131.52 has been removed and not available to download. If you have installed version 184.108.40.206, install this iFix to prevent potential problems.
The following updates and enhancements are included.
No new features are included in this release. This ifix addresses multiple issues with tables based on resource tree information.
This release of IBM UrbanCode Deploy is a maintenance release and includes various bug fixes and enhancements. This release is recommended for all customers.
Key Features and Enhancements
- Improvement to environment gate
- Environment gates can now be configured to obtain snapshot of statuses. Previously, only snapshot for version statuses was available.
- Improved post-processing scripts security
Starting with this release, Post Processing Scripts are fully secured objects, which means that the scripts can be assigned to teams and types. Fully secured objects are also provides subject to more specific permissions than the previous Manage Post-Processing Scripts permission. Role-based permissions such as Create, Edit, Delete, View, and Manage Teams can be assigned to post-processing scripts. During the upgrade, all roles are granted View permissions for post-processing scripts and roles that were assigned the Manage Post Processing Script permission are granted all the new permissions.
With the added permissions, you can control which users can create, view, or modify post-processing scripts. In prior releases, users did not require permission to view post-processing scripts. Users with Manage Post Processing Scripts permission could change them. In this release, users must be assigned the appropriate permissions to perform these tasks. When you upgrade to this release, teams are not automatically assigned to post-processing scripts. Users who require permission must be assigned to teams with access. After you upgrade to version 220.127.116.11, a System Team user must make the required assignments.
- Improved searching for users in LDAP Group support
- You can now search for users in LDAP recursively through user subtrees by setting the Search User Subtree option when configuring the LDAP connection. The default for this featuare is off.
- Rename properties
- When editing properties, you can change the name of the property.
A cumulative list of fixes in this release, and any future fix packs can be found in the Fixlist document.
|PH34622||IN REQUEST JSON OF SAVE CONDITIONS ON ENVIRONMENT GATE HAS CHANGED FROM CONDITIONS TO GATE IN 18.104.22.168 AND LATER RELEASES|
|PH34016||REQUESTING APPLICATION PROCESS VIA REST ENDPOINT RESPONDS WITH HTTP 405|
|PH33903||WHEN TO RUN ON IBM JAVA, AGENTS ONLY ENABLE TLSV1|
|PH33497||JMS AGENTS CONFIGURED USING MUTUAL AUTHENTICATION CAN NOT BE CONVERTED TO WEB AGENTS|
|PH33328||SELECT ALL DOESN’T WORK ANYWHERE (RESOURCE TREE & NON RESOURCE TREE)|
|PH33071||WHEN CLICKING “DOWNLOAD ALL LOGS” ON CANCELLED PROCESS REQUEST, 500 ERROR OCCUR|
|PH33018||Secure Properties throws error when updating component configuration from UI.|
|PH32476||“SET X PROPERTY” STEPS FAIL DUE TO EXCEEDING MAX NUMBER OF RETRIES|
|PH32454||AGENTS IN CONNECTING STATE AND LICENSED CAN FILL SERVER LOGS WITH NULLPOINTEREXCEPTION|
|PH32242||ADD TEAM DROPDOWN FILTER NOT FILTERING RESOURCES BY NAME.|
|PH31588||AFTER UPGRADE FROM BEFORE 22.214.171.124, SERVER.XML DOES NOT LOAD A LOG NOISE SUPPRESSING CUSTOM WEBAPP CLASS LOADER|
|PH31534||UCDEXCEPTIONMAPPER IS CAUSING EXCESSIVE ERROR LOGGING AFTER UPGRADE TO 126.96.36.199.IFIX01|
|PH30474||SUCCESS MESSAGE MISSING WHILE INSTALLING UCD AGENT|
|PH30235||CODESTATION PAGE SHOWS DELETED COMPONENTS ENTRIES|
|PH29936||UNABLE TO IMPORT COMPONENT VERSIONS THROUGH API|
|PH29795||USER IS NOT ABLE TO SAVE SYSTEM SETTINGS WITHOUT PRIVILEGE “MANAGE MAINTENANCE MODE”|
|PH29672||UNABLE TO CHANGE FROM THE DEFAULT VALUE FOR “AGENT EXECUTE PERMISSION REQUIRED” UPGRADE PROMPT.|
|PH29584||S3 ERRORS AFTER UPGRADING AN INSTANCE TO 188.8.131.52|
|PH28928||BATCH EDIT FOR SPECIFIC COMPONENT UNDER COMPONENT ENVIRONMENT PROPERTIES IS MISSING|
|PH28579||TEAMS AND TYPES ARE NOT SHOWING CORRECTLY ON A BASE RESOURCE WHEN APPLICATION IS CREATED FROM THE RESOURCE TEMPLATE|
|PH28456||UPGRADING TO 184.108.40.206.IFIX01 THROWS “UNTERMINATED ‘ CHARACTER?”ERROR DUE TO INCORRECT AMOUNT OF SINGLE QUOTES|
|PH28268||PROCESS STEP FAILING AFTER UPGRADE WITH CLASSCASTEXCEPTION|
|PH28218||‘AGENT CONFIGURATION TEMPLATE’ HELP / INFO FOR THE ‘SERVER URLS’AND ‘RELAY URLS’ SHOWS INFORMATION NOT RELATED TO THOSE FIELDS.|
|PH28215||UNABLE REMOVE SELECTED COMPONENT FROM COMPONENT ENVIRONMENT PROPERTIES SELECTOR|
|IT33537||UNEXPECTED INTERNAL ERROR 172 RUNNING MERGE STATEMENT USING SUBQUERIES|
|PH27018||UPGRADING WINDOWS AGENTS FROM A LINUX SERVER CHANGES THE AGENT JAVA_HOME FORMAT FROM WINDOWS TO LINUX|
|PH25932||RUN OPERATIONAL PROCESS FOR MULTIPLE COMPONENTS PROCESS FAILS TO RUN|
|PH01206||SAVING UNCHANGED PROPERTIES IN BATCH EDIT MODE OVERWRITES TEMPLATE PROPERTIES|
|PI65492||CREATE ENVIRONMENT DIALOG DOES NOT SHOW ANY BLUEPRINTS WHEN BLUE PRINT DESIGNER’S BLUEPRINT NAMES CONTAIN NON-LATIN CHARACTERS|
For supported platforms and requirements, see the reports that can be dynamically generated using the Software Product Compatibility Reports (SPCR) tool.
Note: Some supported plug-ins have system requirements that vary from the core product. Information on system requirements for individual plug-ins is available on the download page for that plug-in.
To get started quickly, IBM UrbanCode Deploy is shipped with an Apache Derby database. Apache Derby deployments are not supported for production environments. As you plan your production topology, review the Fix Central, requiring authentication.
Information for installing the server, see the Installing server section in the product documentation.
For information on installing licenses, see Managing Licenses.
To learn more about IBM UrbanCode Deploy, see the documentation.
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.
JMS agents end of support
Starting with a 2021 second quarter release and all later releases, JMS agents will no longer be supported. Beginning with this release, JMS agents cannot connect to the UrbanCode Deploy server. The agents must be migrated to web format. Starting with UrbanCode Deploy version 220.127.116.11, You can use agent configuration templates to migrate from JMS communication to web communication.
Starting with version 7.1.1, if JMS agents are connected to the server in your environment, a warning message is displayed. You are prompted to begin the migration of JMS agents to a web format. See Migrating Agents to Web in the Knowledge Center for more information.
Starting in 7.1.1
A new version of Hibernate, v5.4.20, is included. Hibernate v5.4.20 may require newer versions of the JDBC driver in order to function properly. Ensure that you have a driver version of at least 4.2 that works with your database to be compatible with Hibernate v5.4.20. This upgrade also removes the hibernate.dialect property from the
installed.properties file as the new Hibernate version itself determines the dialect.
All our Mainframe customers should note that with the UrbanCode Deploy 18.104.22.168 release, we are officially announcing end of support for HFS codestation as an Artifact Repository on May, 2021. All users are strongly encouraged to migrate to the Deploy’s in-built artifact repository Codestation. They can also migrate to supported third party artifact repositories ArtifactoryTM or NexusTM (supported from UCD 7.0.5)
Starting in 22.214.171.124
The Safari browser is no longer supported. The Chrome, Firefox, or Edge can be used.
The Show Inactive option has been removed. You cannot view inactive objects in their respective tables. The Active field is still included in the JSON representation of objects and now reflects whether or not the object has been deleted. Logging information is now written to
deployserver.outinstead of the
Starting in 126.96.36.199
UrbanCode Deploy upgrades for MySQL and MariaDB may have long delays due to changes to the vc_persistent_record table. To avoid delays run the following SQL statement before UrbanCode Deploy is upgraded:
alter table vc_persistent_record modify persistent_data longtext null, add compressed_data longblob null, lock=none. If this fails, the upgrade requires a longer amount downtime. The upgrade temporarily uses additional space rebuilding the table. To estimate upgradge time, first run the statement on a clone of the UrbanCode Deploy database. This delay does not occur on other supported databases.
For customers using Distributed Front End servers the setting installed.property setting
server.userIdAuthScheme.enabled must be set to ‘true’ in the backend to allow the frontend to authenticate with the backend UrbanCode Deploy instance.
UrbanCode Deploy now limits resolved property length to 1 billion characters and throws an exception if exceeded. 1 billion characters is the largest size that can be accommodated without risk of catastrophic performance problems on some JVMs. Lower values may be configured to limit memory consumption.
The 188.8.131.52 agent relay now uses a new proxy by default. Only HTTPS traffic can be proxied with this new proxy, but the relay has historically used HTTPS. If for any reason the relay needs to be able to proxy HTTP traffic then the old proxy can be enabled by including the following line in the relays
agentrelay.http_proxy.use_rabbit=true The new proxy can now support up to 10,000 connected web agents, although to reach maximum scalability, OS file descriptor and ephemeral port limits may need to be raised.
The “Show Inactive” legacy feature that is enabled via the “Enable ‘Show Inactive’ Links” option in the System Settings page will be removed after May 1st, 2020.
All users of the 6.2.x stream of Deploy should not that 6.2.x will be falling out of support in April, 2021.
Starting in 184.108.40.206
All customers should note that with the UrbanCode Deploy 220.127.116.11 release, we are officially announcing end of support for DB2 on z/OS on October 8th, 2020. Starting with 18.104.22.168, new installations of UrbanCode Deploy will not be able to use a DB2 on z/OS database. Servers upgraded to 22.214.171.124 can continue to use existing DB2 on z/OS databases, but those servers will not be eligible for support after October 8th, 2020.
Starting in 126.96.36.199
With the addition of Maintenance Mode deployments that were scheduled to run while the server was down will no longer automatically execute upon the starting of the server.
During testing of UrbanCode Deploy 188.8.131.52, we experienced upgrade issues with version 5.0.8 of the MySQL driver. No other tested versions had this issue. If you are upgrading to UrbanCode Deploy 184.108.40.206, verify that you have a recent version of the MySQL driver if that is the database of your choice.
Starting in 220.127.116.11
Users with the “Manage Security” permission will now be able to copy security roles. This functionality will make it easier for managing a large number of similar roles.
Starting in 18.104.22.168
All customers should note that with the UrbanCode Deploy 22.214.171.124 release, we are officially announcing end of support for Java 6 and Java 7 on February 17th, 2020
UrbanCode Deploy now supports Java 11, and as part of that support we upgraded the version of Groovy we support from 1.8.8 to 2.4.15. If you have customer plugins that statically reference the groovy libraries shipped within the UrbanCode product, you will need to update those references or else your plugin steps will fail on newly installed agents.
For customers who are planning to upgrade to Java 11: If you choose to move off of Oracle Java and move to AdoptOpenJDK, you will need to modify the set_env file to remove the “endorsed dir” entry, as it is not supported in the AdoptOpenJDK JVM.
Also, we would like to let our customers know that in our testing we discovered that users who are using MariaDB can no longer use MySQL drivers due to a change between MySQL and MariaDB. Please ensure you are using the correct database drivers.
Starting in 126.96.36.199
UrbanCode Deploy 188.8.131.52 introduces the concept of Agent Configuration Templates which are used in migrating agents from JMS communication to the new WEB communication. This upgrade does not grant the System Team access to Agent Configuration Templates. Users need to grant these permissions to if users on that team wish to access the functionality.
It should also be noted that some of the servers code station metadata has been migrated to the database. Specifically, it is the content of the $APPDATA/var/repository/ptr directory. This stores the association between component versions and artifact blob files. This resolves some server-side performance issues that negatively impacted relay codestation cache cleanup. The old data files are preserved without modification to support upgrade rollback. However, they are not updated going forward. This means that a later rollback would break new, post-upgrade version artifact associations (blobs files would remain but would be inaccessible).
Starting in 184.108.40.206
UrbanCode Deploy 7.0 introduces new functionality that allows you to add process change management to your deployment processes. This functionality is still in BETA, and we are actively looking for customer feedback. If you would like to access a cloud instance of UrbanCode Deploy, to use and provide feedback without having to set it up, please reach out to your IBM representative and let them know!
UrbanCode Deploy 7.0 also introduces new server/agent communication protocols.
- For new installations of the Deploy server users will be prompted for additional information unconditionally (all new installs will default to the web socket protocol).
- When installing new Deploy agents, users will be asked for their preference, either JMS or web sockets. The default is web.
- When upgrading the Deploy server, the user will be prompted for additional information to support the web socket protocol, however, no agents will change communication protocols as part of the upgrade.
- An interactive (manual) upgrade of an agent will also prompt for new information to support the web sockets protocol. Upgrading through the web-ui will upgrade existing agents and keep them on the current server/agent communication (JMS)
- It should be noted that in all scenarios, UrbanCode Deploy supports running both the new agent communication (web sockets) with the older model (JMS) in parallel.
Starting in 220.127.116.11
API-breaking changes have been made to the supported REST endpoints that set properties in UrbanCode Deploy, affecting the following endpoints:
Any scripts that need to set properties on components, agents, the system, processes, process requests, applications, or environments will need to be adjusted. Previously, the request parameters could be specified on the command line as parameters, but now we no longer accept request parameters for security reasons. Instead, the correct behavior now is now to pass a JSON file containing the specified parameters with the command. Consult the documentation for the new syntax.
Also, because of these API changes, the plugins that set properties in UrbanCode Deploy are not backwards compatible. In the following list of plugins, any plugin version before the version listed is not compatible with UrbanCode Deploy 18.104.22.168 or later, and and any plugin version after the version listed is not compatible with 22.214.171.124 or earlier. On upgrading to UrbanCode Deploy 126.96.36.199, the plugins will automatically be updated to a supported version. However, using old versions of processes that are locked in snapshots or downgrading the UrbanCode Deploy plugin version may cause steps to fail.
|Plugin||188.8.131.52+ compatible versions|
|IBM UrbanCode Deploy Applications||77+|
|IBM UrbanCode Deploy Components||71+|
|IBM UrbanCode Deploy Environments||77+|
|IBM UrbanCode Deploy Resources||74+|
Starting in 184.108.40.206
Starting the server for the first time may take longer than usual. For very large installations, allow an extra hour for the first server startup. Subsequent startups will take the regular amount of time.
Users now do not receive notifications based on their membership in a role on the System Team. Users will have to be added to the correct role on a different team as well to receive notifications.
The server now deletes all contents of the var/temp directory on server startup.
Starting in 220.127.116.11
Process requests from deleted environments will now be deleted. To keep process requests from deleted environments, add this property to the installed.properties file: com.urbancode.ds.cleanup.HistoryCleanup.disableDeletedEnvironmentCleanup=true
Starting in 18.104.22.168
The UCD_SESSION_KEY header has been renamed to UCD_CSRF_TOKEN. The previous name is also accepted until 6.3 when it will be removed from the product.
Users now require the “Execute” permission on agents in order to run processes against them. All existing user roles will receive this permission when upgrading from a version before 22.214.171.124. When upgrading, ensure that any user that needs to execute processes is on the same team as the agents required to run those processes.
Starting in 126.96.36.199
You must upgrade Agent Relays when upgrading from a version below 188.8.131.52. Also, the TLS protocol 3DES is no longer supported.
After upgrading from before 184.108.40.206, users will not be able to view or delete agent relays until they have been granted permission to those relays. Relays that existed before the upgrade are only added to the System Team by default. For users to view agent relays, a user with Manage Security permission should give the correct roles the new For relays that existed before the upgrade, a user with Manage Security permissions will have to add the agent relays to the correct teams and give the correct roles the Agent Relay view and edit permissions.
When upgrading an IBM UrbanCode Deploy agent, end-to-end JMS encryption will automatically be enabled on all agents. In order for agent communication to function properly with end-to-end encryption enabled, the IBM UrbanCode Deploy server and agent clocks need to be synchronized to within a few minutes. To disable this feature, add the line
agent.jms.disable_full_encryption=true” to the agent’s
conf/agent/installed.properties file before upgrading the agent.
Starting in 220.127.116.11
If you are upgrading from version 18.104.22.168 and earlier, servers and relays must be upgraded at the same time. Agents connected through relays may not connect successfully until both server and relay are upgraded. This is due to an incompatibility between versions of an library used by UrbanCode Deploy.
Starting in 22.214.171.124, authentication tokens will be obfuscated in the UI and REST API after their initial creation. Scripts and users will only be able to retrieve the full authentication token immediately after creating it.
The silent install of the IBM UrbanCode Deploy server hangs when prompting for the value of the server installation directory (
install.server.dir). To workaround the problem, run the following instead of calling
echo "" > answerFile.txt echo "" >> answerFile.txt ./install-server.sh < answerFile.txt (or install-server.bat < answerFile.txt for Windows installations)
Starting in 126.96.36.199
The IBM UrbanCode Deploy server and agent relays now require a Java Runtime Environment (JRE) or Java Development Kit (JDK) version 8. If you are updating or changing the JRE to the latest version, see
Changing or updating the JRE of servers and Updating the JRE location for agent relays for instructions. For documentation on the IBM JRE, see IBM SDK, Java Technology Edition.
Starting in 188.8.131.52
To ensure that all secure property values are obscured, the values of all properties in the history for existing deployments are obscured. In the deployment history for deployments that you run after you upgrade, only secure properties are obscured in the logs.
New security features erase old component version import logs to hide secure information. If you want to keep the logs, in the installed.properties file, set the com.urbancode.ds.cleanup.sourceConfig.fullCleanupSkip property to true. –>