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.
Configuration details
The following are the configuration details for successfully configuring the Link Cosmos DB Integration:

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.

Configuration details

The following are the configuration details for successfully configuring the Link Cosmos DB Integration:

Update the value of cosmosDBUri to the URI of your Azure Cosmos DB for MongoDB in the config.yaml file if the customer is using cosmosDB, otherwise keep the existing MongoDB setting.
Note: Link is already using MongoDB and mongoClient supports CosmosDB, so no change is required in existing jars.
Updated Link Hip-Server build to integrate MongoDB and cosmosDB.
- _isCosmosDB flag added to verify Cosmos DB from metadata.
- For cosmos indexes on the collections changed from index.hashed to index.ascending as Cosmos DB does not support hashed indexes.
- The schema.getCurrentTypes is set to 2,000 for Cosmos DB while it is 10,000 for MongoDB.
- The chunk size is set to 2,000,000 (2 Mb) for Cosmos DB as it is 10,000,000 (10 Mb) for MongoDB.

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.