Promoting Assets
Pre-requisites:
You must have the Manage promotions functional privilege assigned to perform this task.
Promoting assets from one (source) stage to another (target) stage includes the following high-level steps:
1. Authorization server promotion: Promote Authorization server in one of the following ways:
Export the authorization server from one environment and import it into another, if you want to use the same authorization server across multiple environments.
Create the authorization server with the same name as in the current environment, if you want to use a diffetnt authorization server instance.
Proceed to the next step once the authorization server is ready.
2. Select assets for promotion: During this step, you search for assets by using a keyword and by performing a type search that sorts and filters the results.
Search using a keyword: You can search for all assets whose string attributes (asset name, description, and so on) contain a certain keyword (character string).
Search using a Type: You can search for assets on the basis of types.
You may use the Search by type filter to restrict the types on which the search is conducted. In the Search by type panel, API Gateway shows you a list of supported asset types.
Search by team: You can search for assets assigned to team(s). Click the team(s) to view the assets that are assigned tot he selected team(s).
3. Optionally select assets' dependencies for promotion: During this step, you specify whether the dependencies (for example, a list of applications that are registered for an API, subscriptions for a package, and so on) of the selected assets will be included for the promotion.
Note:
As groups and users are part of the team, if you want to promote the Groups and Users (optional dependencies) of the team that the selected asset belongs to, you have to set the "enableTeamWork" extended setting to true. Only then the Groups and Users sections appear.
4. Select the stages to promote: During this step, you specify one or more target stages to which you want to promote the selected assets and their dependencies.
5. Configure the promotion details: During this step, you provide the promotion-specific information.
Important:
If you plan to perform bulk promotion of assets from a source stage to a target stage, Software AG recommends you to increase the value of the pg.gateway.elasticsearch.http.socketTimeout property, located in SAG_Root/IntegrationServer/instances/IS_Instance_Name/packages/WmAPIGateway/config/resources/elasticsearch/config.properties. The default value of this property is 3000. To bulk promote assets, for example, 50 numbers, you would set the value of this property to 60000. Depending on the number of assets you want to promote, increment the value as 70000, 80000, and so on.
You must restart API Gateway for changes to this property to take effect.
To promote assets
1. Expand the menu options icon 
, in the title bar, and select Promotion management. 2. Select Promotions.
The Search page appears.
3. Click Promote.
4. In the Search by keyword text box, type the keyword to search for assets. You can use one or more wildcards to specify the keywords.
API Gateway returns the assets that match the specified keyword.
5. In the Search by type drop-down list, select the required type(s). Select the All check box to search across all asset types.
API Gateway returns the assets that match the selected type(s). The number of search results is displayed in the results area, for example, Showing 10 results. If no results are found, the results area is displays a blank page.
6. Optional. Select the Include admin configurations check box if you want to include administrative configurations in the promotion.
API Gateway displays the administrative configurations that are supported for promotion. For the list of assets and configuration settings that can be promoted, see
Promotions.
Important:
Before you configure API Gateway to promote an administrative configuration, make sure that the corresponding administrative settings are already configured in API Gateway. For example, to include the Load balancer configuration in the asset promotion set, the required Load balancer URLs should be configured.
7. Select the assets and the administrative configurations that you want to promote.
8. Click Next.
The Assets and dependencies page appears.
9. Select the referenced assets that you want to promote.
10. Click Next.
The Stages page appears.
11. Select the target stages to that you want to promote the assets, dependencies, and administrative configurations.
12. Click Next.
The Promote page appears.
13. Provide the following information:
Field | Description |
Name | Mandatory. Name of the promotion. |
Description | Description of the promotion. |
Overwrites assets except alias that already exist on the selected target stages | Select this check box to overwrite assets without overwriting their aliases when promoting assets. If the asset being promoted has its aliases already existing in the target stage, then you can select this check box to overwrite the assets without overwriting their aliases. |
Overwrites aliases that already exist on the selected target stages. | Select this check box to overwrite assets along with their aliases in the target stage. |
Fix missing version | Select the check box to fix the API version history. The discrepancy between the asset versions in the source and target stages, if any, are fixed. |
Note:
The Overwrite assets if exists on selected stages option allows you to overwrite assets that exist on the target stages. If you do not want to overwrite assets in the target stages, clear this check box.
14. Click Promote.
The selected assets, dependencies, and administrative configurations are promoted to the selected stages.
The Stage-specific promotion status page displays the status of the asset promotion in each of the selected stages. The available values are:
Success
Failure
The page also displays the reason if the promotion fails.