The following describes the steps for deploying an application in RED.

RED utilizes the PostgreSQL database for its metadata repository—only applications created from the PostgreSQL database can be deployed in RED version 10.0.0.0 and above.

  1. Log into RED and click the Deployments menu to select the Deploy Existing Deployment Application option.
     
    The stand-alone application (RedDeploy.exe) can also be run from the RED Windows Installation directory.
  2. Select the metadata repository where you want to deploy the application. Click Current metadata to deploy the application in the RED metadata repository you are currently logged or click Connect to another to deploy to a different repository.
    For this example, click Connect to another repository option to proceed or click Current metadata to skip to step 5 below.
  3. The Connect to repository window enables you to specify a data source to which RED connects and the login details for the selected target repository database is displayed.

    Type in the required metadata connection details:
    FieldDescription
    Data Source NameThe ODBC data source name (DSN) for the metadata repository connection.
    UsernameThe log-in user name to connect to the metadata repository connection.
    PasswordThe password for the specified user name.
  4. Click Validate to continue the data source and login credentials validation.

    The validation is performed against the selected data source to ensure:

    • The database is not already being used by another RED repository.
    • The database is not being used for another purpose.
  5.  After successful validation, click Next to continue. The Deployment application window is displayed with a list of applications retrieved from the specified directory. You can change the directory using the Choose Folder button or search for an application file using the search field.
  6. Click Next to continue. A warning message is displayed, if the metadata version of the application you are deploying does not match the metadata version of the repository to which the application will be deployed.
    WhereScape recommends upgrading the source repository and recreating the application before deploying to a production system so that the versions match.
  7. Click Next to continue. The Deployment preview window is displayed, showing a list of objects that will be deployed in the selected metadata repository. The status of each object is also displayed, e.g. New, Updated, Removed, etc.
  8. Click Next to continue. The Deployment options window is displayed, showing default deployment settings for the metadata repository, data warehouse, and for the other objects included in the deployment application. Click each of the tabs in the left pane to view or change the settings available under each item. For a detailed list of the deployment options refer to the Deployment Options section.
    You can use the buttons on top of the right pane to Save, Load, or Reset deployment options.
  9. Click Next to continue, the connections used by the deployment application are checked to ensure that they are present in the metadata repository. The results are displayed in the Remap or Add Connections window.


    It is advisable to map to an existing connection in RED to achieve the automation, otherwise, after creating a connection make sure to generate the load and update scripts for the object after deployment.
    If any issues are found in the connections used by the deployment application, you need to fix them before you can proceed. Follow the prompts that are displayed to map or add connections.

  10. Click Next to continue, the targets used by the deployment application are checked to ensure that they are present in the metadata repository. The results are displayed in the Remap or Add Targets window.

    You can add targets on this screen, click Add to open the Add Target wizard.

    1. Select an existing connection from the drop-down list.
    2. Add the target schema name and click OK to return to the Remap or Add Targets window.
    3. After completing your mapping, click Next.
    Note:

    If any issues are found in the targets used by the deployment application, you need to fix them before you can proceed. Follow the prompts that are displayed to map or add targets.

  11. Click Next to continue, the tablespaces used by the deployment application are checked to ensure that they are present in the metadata repository. The results are displayed in the Remap Tablespaces window.

    If any issues are found in the Tablespaces used by the deployment application, you need to fix them before you can proceed. Follow the prompts that are displayed to remap Tablespaces.

  12. Click Next to continue. The Deployment summary window is displayed, showing a list of objects that will be deployed in the selected metadata repository. The status, metadata, and database actions for each object are also displayed. It is recommended that you go through the list and review the actions that will be performed before proceeding with the Deploy.
  13. After going through the deployment summary to review the actions that will be executed for the objects included in the application, you can click Deploy to proceed.
  14. Once the deployment is complete, a window is displayed to confirm the successful deployment of the objects included in the application.
    Click Finish to close the Application Deployment tool.

In case of any errors when deploying the application, click Open Deployment Log located on the top right corner of the window to review more details and troubleshoot your deployment.