Added, Removed, Deprecated, or Changed Items

Added Items

• Support for Windows OpenSSH Server Command Central supports connecting to remote SPM nodes on Windows using the native Windows OpenSSH Server. Support for configuring OpenSSH through Cygwin has been removed.

• License Agreement Acceptance You must accept the IBM product license agreement before you can install products. Run the Command Central bootstrapper with the --accept-license argument to accept the product license agreement. License agreement acceptance is also required when connecting to a webMethods master repository in the Command Central web user interface and CLI.

Changed Items

• Mirror repository and image repository creation In version 12.1 of Command Central, you can create product mirror, fix mirror, and image repositories only from source repositories with version 12.1. Command Central validates the source repositories you provide and rejects the operation if any source repository uses a version earlier than 12.1.

• Repository migration Repositories are not migrated when you upgrade to Command Central 12.1. After upgrading, recreate connections to webMethods repositories.

Deprecated Items

Removed Items

• Repository migration on upgrade When you upgrade Command Central, existing mirror repositories, image repositories, and connections to webMethods master repositories are no longer migrated to the new installation. After upgrading, recreate connections to webMethods repositories.

Added Items

• Server system properties to reduce the Command Central cache Added server system properties for managing the disk compaction strategy for the Command Central cache.

• Server system properties for SSH connections Added the following server system properties for managing the Command Central timeout for SSH server operations:

  • com.softwareag.platform.management.client.remoteaccess.ssh.connection.timeout.seconds

  • com.softwareag.platform.management.client.remoteaccess.shellcommand.timeout.seconds

Deprecated Items

• GitHub project for automating Command Central installation, configuration, and upgrade.

Removed Items

• Licenses IBM webMethods products with version 11.1 do not require a license.

• License Agreement Acceptance You no longer have accept the licence agreement when running the Command Central bootstrap installer. The --accept-license argument is removed in version 11.1.

• Migration of configuration files with bootstrapper You cannot migrate configuration files from an older installation with the Command Central bootstrap installer. The -m argument is removed in version 11.1.

• API Gateway removes support for Command Central.

• Digital Event Services removes support for Command Central.

• Application Platform removes support for Command Central.

• Command Central Docker Builder

• Command Central template samples for 9.x releases on GitHub

• Deploying Command Central assets to Integration Cloud

Added Items

In the Stacks view of the web user interface, when setting the value of a credential property, you can use a switch to indicate if you want to view/edit the value as clear text or as credentials alias parameter.

Changed Items

• sagcc add security credentials Added the credentials argument to specify the alias of the COMMON-CREDENTIALS configuration instance that has the username/password for a set of user credentials, such as repository or product credentials.

• Template DSL In the environments/default section, you can set parameters that reference an existing credentials alias for a username or password. For the syntax of the new parameters, see the Command Central Help > Understanding the Composite Template Definition > Environments.

• Command Central web user interface

  • In Command Central Server > Configuration > Credentials, select the "Password only" option to configure a credentials alias just for a user password.

  • In Stacks view, you can view the credentials alias properties for a stack.

  • The Jobs view is optimized to handle a large number of jobs.

• Global shared secret Command Central now supports only a global shared secred, defined for the whole landscape of environments.

• Command Central CLI The sagcc add security credentials sharedsecret command now adds only a global shared secret for the whole landscape. When running the configuraiton data and security encryption commands, Command Central uses the global shared secret defined for the landscape.

Deprecated Items

• API Gateway deprecates support for Command Central.

• Apama deprecates support for Command Central.

• Digital Event Services deprecates support for Command Central.

Removed Items

License manifests and reports Removed the following functions from Command Central:

• The License Manifest tab and license manifest screen in the Command Central web user interface

• The CLI commands for managing license manifests and reports

Added Items

• Custom administrator user passwords You must set a custom administrator user password when installing version 10.11 of some Software AG products, including Command Central and Platform Manager. For information about other Software AG products, see the release readme for the required products.

  When installing products using Command Central, you use the new ADMINISTRATOR credentials alias to provide a custom password for the administrator user.

• COMMON-CREDENTIALS-ADMINISTRATOR A new default instance of the COMMON-CREDENTIALS configuration type. Note that the ADMINISTRATOR credentials alias does not initially contain a password value. Before using the ADMINISTRATOR credentials for installing a product, you should edit the credentials and provide a strong password.

• New template section and parameters for the default administrator user The section specifies the credentials alias for the default administrator user of the product and whether the product requires changing the administrator user password on the first login.

  layers:
    layerName:
      productAdministrator:
        credentials: administratorCredentialsAlias
        changeOnFirstLogin: true|false

• sagcc exec security encrypt input CLI command that encrypts user passwords for product configurations included in a properties file, using the environment or global shared secret configured in Command Central.

Changed Items

• Install Products wizard When installing products using the Command Central web user interface, the Install Products wizard now has a Select Credentials step.

  If you are installing products with version 10.11 the Select Credentials step contains:

  • In the Credentials field, select the credentials alias to use for the default administrator user for the products you want to install.

    The default alias is "ADMINISTRATOR".

  • Select the Force password change on the first product login checkbox if the products you install require changing the administrator user password on the first login.

  If you are installing products with version 10.7 or lower, the Select Credentials step does not provide any configuration options.

• sagcc exec provisioning products install The command now supports the following optional arguments when installing products with version 10.11:

  administratorCredentials=<credentialsAlias>
  administratorCredentialsChangeOnFirstLogin={true|false}

• Add Installation wizard

  • Install Platform Manager remotely is renamed to Install Platform Manager in the Bootstrap step of the wizard.

  • After you select Install Platform Manager in the Bootstrap step, you must now set the following fields:

    In the Installer field, select the bootstrap installer to use for installing Platform Manager. Based on the installer you selected, Command Central will automatically set the operating system in the Operating System field.

    In the Credentials field, select the credentials alias to use for the Platform Manager administrator user.

    In the SSH credentials field, select the SSH credentials alias for the SSH user on the target machine.

    Click the Advanced button if you want to set a substitute user alias in the Substitute user credentials field or change the default SSH port number in the Remote port field.

  • The Platform Mgr step is renamed to Connection.

• sagcc exec provisioning bootstrap nodes Now the command uses an input file specifying a Command Central bootstrap installer to install a Platform Manager node on a local or remote machine. The command has the following new optional arguments:

  isSecure={true|false}
  credentialsAlias=<credentialsAlias>

Deprecated Items

Application Platform deprecates support for Command Central.

Removed Items

• In the Add Installation wizard, after you select Install Platfrom Manager in the Bootstrap step, the Repository and Distribution fields, and the SSH connection button are removed.

  The Platform Mgr step no longer has the User name and the Password fields.

• The username and password parameters are removed from the nodes:default:default:bootstrapInfo and repositories:product/fix:repositoryName template sections. Use the credentials parameter instead.

• The substitute user and password parameters are removed from the nodes:default:default:bootstrapInfo: template section. Use the substituteUserCredentials parameter instead.

• sagcc create provisioning bootstrap installers The command is removed from the CLI. Use the Command Central bootstrap installer instead.

• sagcc exec provisioning bootstrap nodes The command is removed from the CLI. Use the sagcc exec provisioning bootstrap nodes nodeAlias command instead.

• sagcc get provisioning bootstrap installers The command is removed from the CLI. Download the Command Central bootstrap installer from the Empower Product Support website.

• product=SPM|CCE The argument is removed from the sagcc list provisioning bootstrap installers command.

• The repo.spm and platform parameters are removed from the nodes:default:default:bootstrapInfo: template section. Use the installer parameter instead.

Added Items

• Substitute user support You can now define a substitute user to:

  • Install and start Platform Manager when bootstrapping Platform Manager on a remote machine using a template.
  • Stop the source Platform Manager when migrating Platform Manager using a template.

  To define a substitute user, use the substituteUserCredentials parameter in the nodes:default:default:bootstrapInfo: section of the template.

• Upgrading stacks In the Command Central web user interface, you can now upgrade software stacks with version 10.3 and higher. You can use stacks for the following upgrade types:

  • upgrade to the same installation directory and has the same hosts and ports.
  • upgrade to a new installation directory on the same host with the same ports.
  • upgrade to a new host with the same ports and the installation directory can have the same or a new value.

  Each type of upgrade with the stack has a dedicated upgrade wizard. You can also do a dry run of the upgrade, which will only generate and validate the required migration templates. You can review the results of the dry-run job and check the templates before running the actual upgrade.

• sagcc exec stacks migrate The command upgrades product installations with version 10.3 and higher using a stack. Based on the value of the migration.type= argument, the command executes one of the following upgrade types:

  • Overinstall
  • Side-by-side
  • Cross-host

• sagcc list stacks migrate properties The command lists the required and optional migration properties for a stack.

• sagcc list stacks migrate status The command checks the migration status after a failed migration attempt with a stack. The command output also indicates whether Command Central generated any templates before the migration attempt failed.

• sagcc exec templates composite generate migration The command generates a migration template that includes the infrastructure data of the source Platform Manager nodes. Based on the migration.type argument, the command generates a template for the following upgrade types:

  • Overinstall
  • Side-by-side
  • Cross-host
  • Generic (for any of the supported upgrade types)

• Automatic creation of stacks and layers In the Command Central web user interface, you can now automatically generate stacks and layers from existing environments managed by Command Central. In the Auto-create stacks wizard you can select all environments and release versions, or a specific environment and version, for which Command Central will generate stacks.

• sagcc create stacks auto The command generates product stacks with layers from existing environments managed by one Command Central automatically. You can also use the command to generate product stacks only for a specific environment, or only for product installations that have the same release version.

• sagcc update stacks alias The command updates the name of the specified stack.

• sagcc update stacks layers alias The command updates the name of the specified layer.

• Export Infrastructure to Template wizard In the Command Central web user interface, you can now export a Platform Manager instance from a managed installation to an infrastructure micro template. Command Central generates a template with the Platform Manager instance data, imports the generated template automatically, and creates a layer type definition for the template.

• sagcc exec provisioning assets install PREVIEW. The command installs assets with their dependencies from an asset repository into a target node.

• sagcc exec provisioning assets uninstall PREVIEW. The command uninstalls the specified assets from the specified node.

• Installation reports In the Command Central web user interface, you can now generate installation reports that contain detailed information for each installed product, such as the type of product installation (for example, development or production), and the number of installed and running product instances.

• Displaying the version and location of the Command Central CLI You can now display the version and location of the Command Central CLI by running the following CLI command: sagcc --version

• Support for strong key exchange methods for securing SSH connections Command Central now supports the following strong key exchange methods, which are enabled by default (listed in order of priority): diffie-hellman-group14-sha256 (highest), diffie-hellman-group16-sha512, diffie-hellman-group18-sha512, diffie-hellman-group14-sha1 (lowest).

• com.softwareag.platform.management.client.remoteaccess.allowedkexmethods A server system property for OSGI-CCE that controls the list and priority of key exchange methods allowed by Command Central for securing remote SSH connections.

• verbose: true|false New parameter in the actions: section of a template that indicates whether Command Central should include the standard output from the shell actions defined in the template in the Command Central logs.

Changed Items

• sagcc exec templates composite generate The command now generates an infrastructure micro template from the Platform Manager instance in an installation, or a migration template from an installed product instance using the new options=INFRASTRUCTURE argument.

• Plus icon on the Stacks home page From the plus icon on the Stacks home page in the Command Central web user interface, you can now select to “Auto-create stacks” or “Create a stack from scratch”.

• Reports icon in Licensing > Reports in the Command Central web user interface Click the plus icon and then click Create License Manifest Report

• Return codes from CLI command execution The return codes that can result from executing a Command Central or Platform Manager CLI command have been updated.

• Key exchange methods The following key exchange methods are now disabled by default, because they are weak:

  • diffie-hellman-group1-sha1
  • diffie-hellman-group-exchange-sha1

Deprecated Items

• .exe file of the Command Central bootstrapper Use the .bat file to install Command Central on a Windows operating system.
• Deploying Command Central composite assets to Integration Cloud
• License metering, including license reports and snapshot reports and all related CLI commands.

sagcc create license-tools reports snapshot
sagcc delete license-tools reports snapshot
sagcc delete license-tools reports snapshot reportid
sagcc list license-tools reports snapshot
sagcc get license-tools reports snapshot reportid
sagcc get license-tools reports snapshot output PDF
sagcc get license-tools reports snapshot output XML
sagcc list license-tools reports
sagcc list license-tools metering products
sagcc get license-tools metering contracts licensekey
sagcc list license-tools manifests contracts

• License manifest files and all related CLI commands.

sagcc add license-tools manifests
sagcc delete license-tools manifests
sagcc get license-tools manifests output xml
sagcc list license-tools manifests
sagcc list license-tools manifests content

Removed Items

• Aggregated reports and all related CLI commands The following commands are removed from the CLI:

sagcc list license-tools reports aggregated
sagcc add license-tools reports aggregated
sagcc delete license-tools reports aggregated reportid
sagcc delete license-tools reports aggregated
sagcc exec license-tools metering
sagcc get license-tools metering state

Added Items

• --base64-pass A new argument in the bootstrap installer for Windows to specify a password containing special characters, for example ampersands (&).

• sagcc exec security encrypt password The command encrypts user passwords using the environment or global shared secret configured in Command Central.

• Support for encrypted passwords Command Central now supports using encrypted passwords in templates and the CLI.

• Import parameters from file in the Stacks view When you add or update a layer in a stack, you can import a template properties file to set the layer properties.

• Export layer properties from the Stacks view When you add or update a layer in a stack, you can export the properties set for the layer in a template properties file. Password properties in the exported file are encrypted.

• Export Instance to Template wizard In the Command Central web user interface, you can now export a product instance from a managed installation to a run-time micro template by navigating to the required instance on the Instances tab and clicking Export > Export runtime. Command Central generates a template with the product instance data, imports the generated template automatically, and creates a layer type definition for the template.

• Export Database to Template wizard In the Command Central web user interface, you can now export the database components and schemas configured for the products in an installation to a database micro template by navigating to the Platform Manager instance on the node where the Database Component Configurator is installed and clicking Export > Export database. Command Central generates a template with Database Component Configurator products and database actions, imports the generated template automatically, and creates a layer type definition for the template.

• sagcc exec templates composite generate with the options=DATABASE argument. The command exports the products and actions for the specified database to a database micro template.

• Database micro template A micro template that is used for defining the database components and schemas configured for a product.

• environment.mode=maintenance Use to install Database Component Configurator fixes and run database schema migration using a template.

• New database layer Create a new database layer in a stack from the Add layer drop-down box of the Stacks view based on a database layer type definition.

• Existing database layer Create a database layer in a stack from the Add layer drop-down box of the Stacks view based on the DATABASE-EXISTING layer type definition.

• DATABASE-EXISTING layer type definition A default layer type definition for creating a database layer for existing environments.

• DATABASE layer type A layer type for creating a database layer definition.

• Templates view You can now view and manage all templates that are registered in your Command Central installation through the Templates view in the web user interface.

• Import template button You can now register templates in your Command Central installation by using the import template button in the new Templates view in the web user interface.

• Default templates repository In the Command Central web user interface, you can now connect to the default templates assets repository located at sagdevops-templates-repo

  To connect to the repository, navigate to Repositories > Assets and click Add repository > Connect to Software AG Repositories. Command Central imports the template assets and creates a layer type definition for all templates used in one of the layer type definitions in the “sag-cc-layer-defs” template.

• sagcc exec templates composite import repository Imports all or selected assets from a template asset repository registered in a Command Central installation.

• Delete stack You can delete a stack through the web user interface by clicking the three dots in the upper right corner of the stack and then Delete

• Delete layer You can delete a layer through the web user interface by clicking the layer, clicking the three dots in the upper right corner of the layer page, and then Delete.

• sagcc update stacks index Updates the position of the stack in the user interface by updating the stack index number.

• sagcc update stacks layers index Updates the position of the layer in the user interface by updating the layer index number.

Changed Items

• Automated migration The following Command Central configurations and data are now migrated when you upgrade Command Central:

  • Outbound SSL configuration
  • LDAP certificates
  • Command Central bootstrap installers
  • Customized Java system properties

• sagcc exec templates composite generate with the options=FIXES argument. The command now generates a template with fixes and patches parameters that list the installed fixes on the source installation if the source installation is version 10.5.

• sagcc list stacks The command now returns the index number of the stack, which indicates the position of the stack in the web user interface.

• sagcc list stacks layers The command now returns the index number of the layer, which indicates the position of the stack in the web user interface.

• sagcc delete stacks The command supports the optional deleteLayers={true|false} argument that specifies whether layers from the stack will be deleted.

• sagcc delete stacks layers The command now does not allow deleting the infrastructure layer before deleting all other layers in the stack.

• snapshot option - The snapshot template option that indicates whether to create a template from each source node is now set to false by default.

Removed Items

• CLI provisioning assets commands The following commands are removed from the CLI:

sagcc exec provisioning assets install
sagcc exec provisioning assets uninstall
sagcc list provisioning assets supportedcomponents

Added Items

• Beginning with 10.4, Command Central supports DSL version 1.2, which includes a new section and new parameters. The version parameter is dslVersion="1.2"

• Supported only with DSL version 1.2. New section and parameters that modify how Command Central processes a template at the time of applying the template. See the Command Central Help for details about the new section and parameters.

  options:
    abortOnConfigFailure: true|false
    abortOnLayerStartupFailure: true|false
    forceRestartWhenDone: true|false
    startupLayers: true|false

• skipOnTemplateError: true|false New parameter in the actions: section of a template to indicate whether Command Central executes the action if applying the template fails with an ERROR status.

• namePrefix: hexTimestamp|none New parameter in the actions: section of a template to indicate whether Command Central adds a prefix to the names of action files created on the file system.

• sagcc list templates composite properties The command retrieves a list of all environment properties defined in an environments:env.type: section in a template.

• sagcc get license-tools keys The command retrieves the contents of all license key files that are added to the Command Central license key manager and adds them in a zip archive file.

• sagcc list provisioning products uninstall dependencies The command returns a list of all products that depend on the specified product(s).

• sagcc list provisioning fixes uninstall dependencies The command returns a list of all fixes that depend on the specified fix(es).

Changed Items

• Monitoring of the apply job status for a template If a sub-job of the main composite template apply job fails, the failure of the sub-job causes the main template apply job to fail with an ERROR.

• Jobs view in the Command Central web user interface Only one Jobs view exists now, which includes all functions of the legacy Jobs view. Error reporting has been enhanced. On the Jobs page, you can view and navigate all running jobs much easier.

• Optimized the run-time component lifecycle operations during the execution flow of composite template application on nodes with version 10.3 and higher.

  By default, all run-time components are no longer restarted at the end of the composite template execution. Run-time components are restarted during a layer application only if a configuration that requires a restart is applied in that layer.

  All stopped components are started at the end of a layer application.

• sagcc exec templates composite generate The command generates a run-time micro template from an installed product instance using input parameters, imports the generated template automatically and creates a layer type definition for the template in the local Command Central installation. New arguments: options=CONFIGURATION, options=INSTANCE, options=PRODUCTS, options=FIXES, createLayerType={true|false}.

• sagcc exec templates composite generate input The command generates a run-time micro template from an installed product instance using a template metadata file. In the template metadata file, you can filter which configuration properties of the product instance to include in the generated template. New argument: createLayerType={true|false}

• sagcc exec templates composite apply command with the expected status option The command sets a:

  • Non-zero exit code if the expected status value is not retrieved.
  • Zero exit code if the expected status value is successfully retrieved.

• Template application failure Based on the value of the new "abortOnConfigFailure" parameter, Command Central determines whether to stop applying a template after a product configuration fails to apply.

• Encrypting properties in a custom cc.properties file When you prefix a property in a custom cc.properties file with @secure, Command Central encrypts the value of the property after you run a CLI command that uses the custom cc.propeties file.

• LDAP connection validation In the Command Central web user interface, you can now verify the LDAP connection using the credentials of a real LDAP user account, in addition to testing the LDAP connection with the technical user DN.

• Connecting to repositories over HTTPS Command Central can register a repository on the HTTP, HTTPS, or both ports based on the version of the Platform Manager installation, the repository type, and whether the HTTP and HTTPS ports are enabled. See the Command Central Help for details.

• License reporting Enhanced the License reporting field on the Overview tab for a product instance in the Command Central web user interface.

• Licensing and Reports Streamlined the Licensing and Reports page in the Command Central web user interface.

• sagcc list administration product DatabaseComponentConfigurator database migrations command Not supported for local or remote nodes with version 10.4 or higher.

• sagcc list jobmanager jobs command output

  • Status As String column renamed to Status Description
  • The default output contains the following columns: ID, Status Progress, Description, Progress Description, Status Description.
  • If a custom status was set when the template execution job was completed, the command output displays the custom status and its description in the Status and Status Description columns.
  • If the template execution job is still in progress or it was completed with no custom status, the command output displays the system status and its description in the Status and Status Description columns.
  • The Duration and Links columns are removed from the default output. To display the columns, add the properties=* argument when running the command.

Removed Items

• Legacy Jobs view Removed from the Command Central web user interface. The functions are now covered by the Jobs view in the Stacks user interface.
• DataMap column Removed the specified column from the output of the sagcc list jobmanager jobs command.

Added Items

• Command Central composite assets Command Central exports configuration properties for Software AG run-time components as YAML templates. You can generate composite assets from YAML templates using:

  • Designer
  • Asset Build Environment
  • the sagcc get templates composite export templateAlias command

  You can store the Command Central composite assets in a local or remote Landscape Asset Repository (LAR) and deploy them on Software AG run-time components running on premise, or on webMethods Integration Cloud.

• sagcc exec templates composite generate Generates run-time component configurations as a template YAML file.

• sagcc exec templates composite generate input Generates run-time component configurations as a template YAML file, based on an input template metadata file.

• application/vnd.sagcc.asset+zip Content type for Command Central composite assets.

• application/yaml Content type for YAML files.

• sagcc exec repository mirror validateContent The command validates the integrity of a mirror repository against the source repository.

• com.softwareag.platform.management.client.fix.mirror.platform.validation=false Disable validating whether a source fix repository (from which you want to create a mirror repository) includes all of the platforms in the product repository you select as a filter.

• com.softwareag.platform.management.client.template.composite.skip.restart.for=componentID Indicates whether to bypass the restart of a specific run-time component at the end of the composite template application.

• Fixes to include In Repositories > Fixes > Create Mirror Repository, use the Fixes to include option to select whether to include only the Latest fixes or All fixes in the fix mirror repository.

• Command Central default templates library A library of templates for products that you can install and manage with Command Central, including all supported product configurations. The library is located at sagdevops-templates

• Provide monitoring data in Prometheus metrics format Command Central exposes run-time monitoring metrics, which can be consumed by Prometheus when managed containers are deployed in K8S environment.

Changed Items

• sagcc get templates composite export Use the command with:

  • the -f application/yaml option to export a template into a YAML file.
  • the -f application/vnd.sagcc.asset+zip option to export a template as a Command Central composite asset zip file.

• Create a fix mirror repository for a single operating system Command Central can create a mirror repository with fixes for a single operating system, based on the platform in the product repository you select as a filter.

• Command Central bootstrap installer for Windows The Command Central bootstrap installer for Windows is now an .exe file.

• Jobs view Streamlined the Jobs view in the Stacks area of the Command Central web user interface.

• In the artifacts argument of the sagcc exec provisioning fixes install command, you can specify either the fix names, or the Empower fix IDs of the fixes you want to install.

• In the fixes section of a template, you can list either the fix names, or the Empower fix IDs of the fixes you want to install.

• sagcc add license-tools manifests A license manifest file that you add with this command can contain embedded license keys that you register in Command Central when you add the license manifest.

• sagcc list license-tools keys The command returns a list of all license keys registered in Command Central, including license keys added individually and license keys added with a license manifest file.

• sagcc delete license-tools keys You cannot delete license keys embedded in a license manifest with this command. To delete license keys registered in Command Central with a license manifest file, you must delete the license manifest file using the sagcc delete license-tools manifests command.

• sagcc get license-tools reports aggregated The command now generates different representations of the aggregated license report.

Added Items

• Command Central Docker Builder An official Docker image of Command Central on Docker Store: softwareag-commandcentral

• SSL to connect to master repositories (Empower) Command Central now uses SSL to connect to master repositories (Empower), managed by Command Central 10.2 and hosted on Platform Manager 10.2, when downloading products and fixes to install in an environment.

• General Data Protection Regulation (GDPR) compliance Included information in the Command Central Help about how to delete Command Central and Platform Manager logs.

• Support for new parameters for cross-host product migration Enabled products to identify the old hostnames to be replaced with the new host names during migration. Enabled renaming a product instance during migration (for products supporting instance renaming).

• dslVersion: 1.1 A new parameter in the composite template declaration to indicate the DSL version.

• With DSL “1.1”, added a new aliasMapping:policy: section in the nodes/env.type template section to enable the mapping of node alias to hosts. When policy: INDEX, the prefix: parameter specifies a custom prefix to include in the indexed node alias.

• With DSL “1.1”, when aliasMapping:policy: INDEX, the first layer in each provisioning:envType: section is defined as an infrastructure layer that includes the hosts parameter.

• With DSL “1.1”, when policy:INDEX, each of the layers in provision: (except the infrastructure layer) includes the aliases: (list of indexed node aliases) or indexes: (list of index numbers) parameters.

• Context parameters for node aliases You can refer to a node alias from an inline template in the templates section using one of the parameters listed in the context parameters for DSL “1.1” table in “Templates” in the Command Central Help.

• With DSL “1.1”, added a patches section in templates:, in which you specify a list of support patches that you want to install on top of installed fixes.

• The "target/licenseKey": "$" parameter in the templates:templateAlias:licenses: section of the composite template supports using wildcard characters when specifying the license key alias.

• The new CLI command option --sync-job monitors and reports progress details while a job is running, and returns the job status and status description after the job completes.

• The new CLI command option --retry specifies the number of times to resubmit the command when Command Central gets restarted during an operation and does not respond within the time interval specified in the --wait-for-cc option.

• The new CLI option --wait-for-cc sets the time interval in seconds for which the command waits for Command Central to come online after starting or restarting Command Central.

Changed Items

• DSL version 1.1 The new version of the DSL has been enhanced with new sections and parameters. See the “Added Items” table for details.

• With DSL 1.1 the following changes apply for the templates:fixes: section of the composite templates:

  • You cannot list support patches in the fixes section.
  • fixes:ALL installs all fixes applicable for products in the inline template and their dependencies.

• sagcc list license tools keys Added the following optional parameters: release, aliasFilter, excludeExpired, and nodeAlias.

Added Items

• Stacks web user interface and CLI commands You can now create product layers and build a product stack out of those layers to provision new environments.

• Micro templates The layers in a product stack are created based on the properties defined in a micro template, which is referenced in the layer definition you select for the layer. You can find sample micro templates at sagdevops-templates

• Asset repositories Flatfile and git asset repositories that you register in Command Central to install assets.

• Asset provisioning commands CLI commands that you use to install/uninstall product assets.

• Composite template validation Composite templates are validated as a first step in the apply composite template operation or using the CLI validate composite templates command.

• COMMON-JAAS-REALMS A new configuration type to use for JAAS realms authentication.

• CCE-LAYER-TYPES A new configuration type for layer definitions.

• COMMON-JSW A new configuration type to use for configuring Java Service Wrapper settings.

• Disconnected migration You can now use disconnected migration (migrate from a source archive) with a composite template.

• Exporting product configuration as template snippets With the Command Central web user interface, you can export product configurations from existing installations as template snippets.

• Jobs view New Jobs view in the Command Central web user interface (with a tree structure for the jobs)

• Encrypted proxy authentication for Command Central and Platform Manager

• Automated migration of custom certificates and their configuration for SSO and HTTPS ports.

• Importing license keys from a license key archive (zip file).

Changed Items

• Base and Peak Report Changed to “Product Usage Report for Billing”. A new metering type, “Total usage”, has been added to the license metering. The “Product Usage Report for Billing” contains both “Base and Peak” and “Total usage” licenses.

• Download aggregated report menu items in the Command Central web user interface The following menu items have changed:

  • "PDF License Inventory" is now "PDF"
  • "XML License Inventory" is now "XML"
  • "JSON License Inventory" is now "JSON"
  • "Base and Peak PDF" is now "Product Usage PDF"
  • "Base and Peak XML" is now "Product Usage XML"
  • "Base and Peak JSON" is now "Product Usage JSON"

Deprecated Items in Template Definition

• In nodes/default/default/bootstrapInfo:

  • repoSPM: repositoryName and platform: platformCode are replaced by installer: bootstrapInstallerFileName
  • username and password are replaced by credentials: credentialsAlias

• In repositories/fix and repositories/product, username and password are replaced by credentials: credentialsAlias

Removed Items

• Default composite templates The default composite templates are now removed from the product and available here: sagdevops-9.x-template-samples

• Snapshot templates Removed from the product.

Added Items

• Fix ID column in the fix repository details page in the Command Central web user interface

• List of the details available in a specified license manifest You can use the Command Central web user interface and CLI commands to list details about license manifests, such as type, name, version, and status.

• Correlation ID in the logs You can use the number of the Correlation ID as a search filter when tracing an operation in the Command Central and Platform Manager logs.

• “patterns” and “except” parameters With the two new optional parameters, added in the migration/options/backup/excludes section of the composite template definition, you can select which file types to exclude from the source archive in a more granular way.

  Also, now the default value of the "excludes" parameter under migration/backup is "*.log".

• Fix Repository ID You can use the fix repository ID to select a repository in the instance creation wizard in the Command Central web user interface.

  When creating instances of Integration Server and My webMethods Server with the “sagcc create instances” command, you can use the fixRepository=repoID argument to ensure that all required fixes are applied on all product instances.

  When applying a composite template, the template now automatically re-applies fixes after a product instance is created.

• Added context parameters that you can define in a templates:templateAlias: section of the composite template definition. The parameters are $, $, $, and $

• COMMON-CREDENTIALS A new configuration type to add and store the user credentials for a specific alias.

• sagcc list repository products languages Lists language packs available for the products in the repository.

Changed Items

• LDAP configuration Added validation of the LDAP configuration settings in the Command Central web user interface.

• sagcc update repository Each type of product or fix repository (master, mirror, and image) now has a separate syntax for the update repository command. For details, see the Command Central Help.

Removed Items

• System Properties On the Configuration tab in the web user interface, the System Properties configuration is replaced by Java System Properties.

• sagcc exec repository register

Added Items

• Cross-site-request forgery prevention Protected the Command Central web user interface against cross-site-request forgery attacks.

• Web user interface instance creation wizard Creates, updates, or deletes instances of Integration Server, My webMethods, Universal Messaging, and Apama for installations of release 9.12.

• Instructions and tooltips The wizards and screens of the Command Central web user interface have been enhanced with new instructions and tooltips.

• Web user interface product installation wizard Installs products of release 9.8 or higher. You must consider the following when using this wizard:

  • Use mirror or master repositories. The product installation wizard does not support image repositories.
  • For installations of release 9.10 or higher, installing a Platform Manager product plug-in automatically restarts Platform Manager to activate the plug-in. For earlier releases, Platform Manager is not restarted automatically and you should use the ALL distribution (which includes all product plug-ins) or restart Platform Manager manually.
  • Checking for dependencies is not supported for older releases, which is indicated by a warning.
  • Installing language packs is supported only for installations of release 9.12.
  • Use the Software AG Installer to install products of release 9.7 and earlier.

• sagcc get templates composite export Exports an existing composite template into a zip archive.

Changed Items

• Command Central bootstrap installer Added support for the HP-UX and IBM AIX operating systems.

• Logs The Command Central logs are now reduced in number and made easier to read and understand.

• Product and fix repository wizards Streamlined and enhanced repository wizards to support browsing and searching the repositories.

• Template-based provisioning enhancements Enabled migration of existing environments to a different host, using a live or cloned database.

• Command Central REST API Improved performance and memory usage. A single WADL document for the Command Central REST API services. The document is located at http(s)://ccehost:cceport/cce/application.wadl

Removed Items

• Create/apply snapshot templates wizards in the Command Central web user interface Use composite templates to provision existing installations with version 9.8 or higher.

• Event Routing Removed Event Routing from the Command Central bootstrap installer.

Added Items

• dbc template A new default composite template that installs the Database Component Configurator (DBC) on a local or remote installation and uses DBC to create a new database on a supported database server.

• Configuration types Added the COMMON-JVM-OPTIONS configuration type to configure extended options for JVM.

• Command Central bootstrap installer Added new custom options for the Command Central bootstrap installer: -D and -H. The bootstrap installer now migrates an existing Command Central installation.

• CLI administration commands Commands that perform custom administrative tasks for managed products.

• Fix mirror repositories Creating and updating fix mirror repositories, using the Command Central web user interface and CLI repository commands.

• License keys Adding and managing product license keys.

• Login page and logout link The Command Central web user interface now uses form-based login page and has a logout link.

• Template-based provisioning enhancements The following enhancements were added in the composite templates:

  • Use composite templates to migrate existing environments.
  • Customize migration options by adding an optional “migration” section in a composite template definition.
  • Define shell actions that a composite template executes at different points in the apply composite template operation.

• “environment.mode” parameter Added in the “cc exec templates composite apply” command to specify whether the composite template will provision or migrate the environment.

• Migrate products using composite templates and the Command Central CLI

  • Migrate Integration Server, My webMethods Server, and Universal Messaging using composite templates and the CLI composite template commands.
  • Migrate Integration Server, My webMethods Server, and Universal Messaging instances using the CLI administration commands.

• Universal Messaging JNDI management Configure Universal Messaging connection factories and destinations in a JNDI namespace using the Command Central web user interface or command line interface.

Deprecated Items

• COMMON-MEMORY Deprecated for configuring extended options for JVM. Use COMMON-JVM-OPTIONS.

• Snapshot templates create and apply web user interface and CLI commands. Use composite templates to provision existing environments with version 9.8 or higher

• Emitting XML-based events using Event Routing

Added Items

• com.softwareag.platform.management.configuration.wrapper.allow.duplicates.for=--add-opens Configure Platform Manager to retain Java options,such as "--add-opens", even if they appear multiple times in the configuration file.

• Outbound SSL connection settings for Platform Manager You can configure custom truststore settings for the outbound HTTPS connections that Platform Manager establishes. The settings are available in the Command Central web user interface under Environments > ALL > Instances > SPM > Platform Manager Engine > Configuration > General Properties > Outbound SSL Connection Settings.

Removed Items

• API Gateway removes the API Gateway plug-in for Platform Manager.

• Digital Event Services removes the Digital Event Services plug-in for Platform Manager.

• Application Platform removes the Application Platform plug-in for Platform Manager.

Deprecated Items

• API Gateway deprecates the API Gateway plug-in for Platform Manager.

• Apama deprecates the Apama plug-in for Platform Manager.

• Digital Event Services deprecates the Digital Event Services plug-in for Platform Manager.

Changed Items

Updates in the following plug-ins for Platform Manager:

• Integration Server

• Optimize Analytic Engine

Deprecated Items

Application Platform deprecates the Application Platform plug-in for Platform Manager.

Removed Items

The following plug-ins for Platform Manager are removed and not supported:

• MashZone NextGen

• MashZone NextGen Event Service - RTBS

Added Items

• Migrating Platform Manager using a template You can migrate the configurations of Platform Manager version 10.7 using a template.

Changed Items

• Automated migration The following Platform Manager configurations and data are now migrated when you upgrade Command Central:

  • Port, SSO, and proxy configurations
  • HTTPS and SSO certificates
  • Users, groups, and roles, and password manager data
  • Customized Java system properties

• Updates in the plug-ins for Platform Manager:

  • Business Rules
  • Integration Server and Microservices Runtime
  • BigMemory
  • Universal Messaging

Added Items

• Support for encrypted passwords Platform Manager is now able to decrypt encrypted passwords.

• Removing configuration instances when deploying assets Platform Manager now enables removing configuration instances from deployed assets.

• New KPIs for assets deployed to Integration Cloud The following KPIs are now available:

  • restartRequired - when set to true for a deployed run-time component, the component is restarted
  • deploymentTinted - true if any deployment from a pod resulted in an error. The whole pod from the cluster is restarted when deploymentTinted=true.

Changed Items

• Automated migration Automated migration is enhanced. The following Platform Manager configurations and data are now migrated when you upgrade Command

  • Port, SSO, and proxy configurations
  • HTTPS and SSO certificates
  • Users, groups, roles, and password manager data
  • Customized Java system properties

• Automatic restart of run-times when deploying assets Platform Manager does not restart all run-times during asset deployment but only the run-times that have disableAutoRestartOfRuntimes=false set in the ACDL file.

• Updates in the plug-ins for Platform Manager:

  • API Gateway
  • Integration Server and Microservices Runtime

Added Items

• lar.log Contains messages generated from the Landscape Asset Repository (LAR).

Changed Items

• Updates in the plug-ins for Platform Manager:

  • Integration Server
  • Universal Messaging

• Re-starting products after applying product configuration using a composite template When applying a template for product installations 10.3 or higher, Platform Manager restarts only the run-time components in a layer that report PENDING_RESTART status after Command Central applies the configuration settings defined for those run-time components in the template.

• Deploying assets with dependencies When deploying assets on a target installation Platform Manager always installs:

  • The product assets before installing the configuration assets.
  • The dependent assets before installing the main asset.
  • If a dependent asset is already installed, Platform Manager does not re-install it.

Added Items

• New Platform Manager plug-ins:

  • Zementis Integrated Server
  • Task Engine on Integration Server
  • AgileApps Server

• Pull deployment from asset repositories Platform Manager can be configured to listen and pull assets when changes are detected in an asset repository, and then deploys the assets automatically on product instances.

• Processing and applying YAML composite templates Platform Manager can pull Command Central assets (YAML template files with product configurations) from an asset repository and deploy the templates on product instances running in containers on Integration Cloud.

• Provide monitoring data in Prometheus metrics format Platform Manager exposes run-time monitoring metrics, which can be consumed by Prometheus when managed containers are deployed in K8S environment.

• syscap UNIX shell script Collects system information that you use when troubleshooting issues.

Added Items

New Platform Manager plug-ins:

• Microservices Runtime
• MashZone NextGen Event Service (RTBS)

Added Items

• Logs The Platform Manager logs are now reduced in number and made easier to read and understand.

• Correlation ID in the logs You can use the number of the correlation ID as a search filter when tracing an operation in the Command Central and Platform Manager logs.

Deprecated Items

The COMMON-SYSPROPS configuration type is deprecated and replaced by the COMMON-JAVASYSPROPS configuration type.

Added Items

New Platform Manager plug-ins:

• Platform Manager plug-in for ActiveTransfer
• Platform Manager plug-in for PPM

Added Items

• Platform Manager plug-in for Apama.

• The COMMON-JVM-OPTIONS configuration type to configure extended options for JVM.

• CLI administration commands Commands that perform custom administrative tasks for managed products.

Deprecated Items

COMMON-MEMORY Deprecated for configuring extended options for JVM. Use COMMON-JVM-OPTIONS.