Home
Installation Guide
Link Cosmos DB integration
The purpose of this document is to guide on integrating your web application with Azure Cosmos DB for MongoDB. By following the steps outlined herein, you will seamlessly incorporate Cosmos DB into your application's data storage and retrieval processes.
Integrating Cosmos DB with MongoDB
By following these steps, you can successfully integrate Cosmos DB with MongoDB:

Installation Guide
- Introduction to Unica Link
  Unica Link is a component that can be installed separately from the Unica application.
- Unica Link prerequisites
  Ensure that these prerequisites are met before installing Unica Link.
- Microsoft Windows installation
  This section describes how to install Link using the Windows Installer.
- Linux Installation
  You can install Unica Link in two modes:
- Setting up Journey and Campaign for Unica Link
- Link Cosmos DB integration
  The purpose of this document is to guide on integrating your web application with Azure Cosmos DB for MongoDB. By following the steps outlined herein, you will seamlessly incorporate Cosmos DB into your application's data storage and retrieval processes.
  - Audience and prerequisites
    This document is designed to serve various audiences of professionals involved in the integration and management of a web application utilizing Azure Cosmos DB for MongoDB along with existing MongoDB in Link.
  - Integration overview
    The Link Cosmos DB Integration is a strategic enhancement for web applications utilizing Azure Cosmos DB for MongoDB in conjunction with existing MongoDB setups. This integration seamlessly integrates Cosmos DB, offering a systematic approach to data storage and retrieval processes within your web application.
  - Key features
    The following are the key features:
  - Compatibility
    The Link Cosmos DB Integration is designed to work seamlessly within various system and platform environments, ensuring broad compatibility and flexibility in deployment.
  - Configuration details
    The following are the configuration details for successfully configuring the Link Cosmos DB Integration:
  - Integrating Cosmos DB with MongoDB
    By following these steps, you can successfully integrate Cosmos DB with MongoDB:
  - Known Issues while using Cosmos DB
    Refer to the following known issues while using Cosmos DB:
- Logging
  Logs are produced for your use by Link, the Runtime REST API, and Kafkalink.
- Enabling Unica Link to run on HTTP protocol for Windows and Linux Installation
- Encrypting the password in the properties file
  To enhance security and safeguard sensitive information, encrypt the password stored in the properties file adding a layer of protection to the data.
- Verifying the config.yaml file
  This section describes how to verify the validity of your config.yaml file after making changes in it. When editing the config.yaml file, ensure that the modifications you make are valid. To verify the validity of your config.yaml file after making changes, perform one of the following procedures based on your setup:
- Configuring SSL Certificates for Link
  After installing Link, setup the custom SSL certificates for the Link web UI and the Link runtime application server.
- Troubleshooting
- Known issues
  Summary of known issues in this version of the product.

Integrating Cosmos DB with MongoDB

By following these steps, you can successfully integrate Cosmos DB with MongoDB:

Procedure

Setting Up Cosmos DB
To initiate the integration of Cosmos DB with MongoDB, start by creating a Cosmos DB Account specifically configured for MongoDB.
- Creating a Cosmos DB Account (Cosmos for MongoDB).
- Select Cosmos for MongoDB option while creating Cosmos account in Azure.
Note: Ensure that the total throughput limit is sufficiently high, with a minimum of 40,000 Request Units per second (RU/s).
Download and Install Link
For installing Link, see the earlier chapters related to Link installation.
Note: To utilize Cosmos DB with Link, if Link is already installed, it is recommended to uninstall the existing installation and then perform a fresh installation. This ensures that the installation process is aligned with the Cosmos DB configuration requirements and helps prevent any potential conflicts or issues that may arise from an existing installation. Follow the uninstallation guidelines provided in this guide before initiating the reinstallation process to ensure a clean and seamless integration with Cosmos DB.
Link Configuration
Configure the database connection settings to establish the link between Cosmos DB and MongoDB.
- Database Connection Settings: Update the config.yaml file and ensure that the Cosmos DB URI is correctly specified for linking with Cosmos DB.
- Authentication and Authorization: No changes are required in the authentication and authorization settings.
Data Migration
During the installation of the link, the mdb and rdb_XXXXX databases will be created under Cosmos DB. All predefined collections and documents will be generated, ensuring a seamless migration of existing data.
Restart Link
Test and Deployment
- Conduct thorough testing of the integration.
- Deploy the integration to the production environment after successful testing.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.