Skip to content

jbrazda/iics-quickstart-bundle

Repository files navigation

Informatica Cloud IPS Baseline Bundle

This project contains set of re-usable IICS Designs SDLC utilities, examples and documentations

Provided Assets

Before You Start

  • Read the provided documentation
  • This bundle is continuously developed and improved, feel free to subscribe and monitor updates that might be useful for you in the future
  • This bundle is not officially supported by Informatica, please report any issues you find via Github issues report
  • Do not modify or move imported assets Project/Folder Locations after import, this would make updates much more difficult
  • You can update or change imported resources to adjust them for your needs but keep in mind that it would be your responsibility to merge or maintain any changes you have made to provided designs
  • Any of the provided assets can significantly re-designed or removed in the future releases

Install The Bundle

Build from Source

This should be the preferred method to build this package from source and deploy following a generic guide to use provided Asset Management Scripts

Use pre-built binaries

Using pre-build packages is easy but has some down-sides such as need to adjust a lot environment specific parameters after import i.e. Deployment targets for Connections and Processes Use build from source method which allows you to automate these adjustments in bulk using a declarative configuration and set of provided scripts

  1. Download pre built Distribution from [Releases]
    1. Use IICS-QuickStart-Bundle_InitialInstall_All_Designs.zip to initial install
    2. Use IICS-QuickStart-Bundle_Update_Excluding_Connections.zip to update your Bundle in environments whet it was already installed before
  2. Import Distribution Package Bundle
  3. Configure, adjust and publish provided designs

Configure Individual Components

Connectors and Connections

AgentFileWriter

Design: Explore/Tools/Connections/AgentFileWriter.AI_CONNECTION.xml Description: Generic file writer allows to stage and upload files on Associated Secure Agent or group of Agents

This connection can be used to write files to Secure agent and is used by the SP-util-upload-agent process Key Configuration property that might be your secure agent specific is File Connector/EventTargets/Directory which is configured by default to /tmp directory. You also might want to create separate Connections and corresponding process for each secure agent in case you need to push files to different agents. Ideally One connection can be used and push of the files is done via any member of agent groups to shared filesytem mounted to all members of the Secure Agent Group.

DataAccessService

Design: Explore/DAS/DataAccessService.AI_CONNECTION.xml Description: DO NOT USE THIS SERVICE DIRECTLY is defined only to provide design time metadata definitions for Automated Steps execSQL and execMultiSQL

To configure this connection, just publish DataAccessService Connector and then DataAccessService Connection Then You can publish corresponding Proxy processes (execMultiSQLProxy, execSQLProxy) that give access to DAS from Cloud guides and processes

Use Data Access Services/execMultiSQL or Data Access Services/execSQL to invoke data Access Service automated steps from IPD processes

Email

Design: Explore/Tools/Connections/Email.AI_CONNECTION.xml Description: Shared Email Service to send alerts and notifications

Use Email Connection to send email notifications as an activity withing your Integration Processes

github-gist

Github REST V3 APi to manage Gists see GIST API Documentation

This connector is useful to store and retrieve configurations, templates, snippets, etc. See an example of using Gist as a configuration storage provider Alert Service

Setup GitHub Gist Account and Access Token

Make sure your secure agents can access the GitHub API to store and retrieve the Alert Service configuration file.

This Alert Service Implementation can use Github Gist (both Cloud and On premise Github Enterprise Edition) as a storage for its configuration It is recommended to use private gist to store this configuration, you will need to create Security token to access private gists via API

  1. Login to Github with an account that would be owner of the configurations (this should be likely service Account or account managed by IT Infrastructure administrators)

  2. Go to Account Settings/Developer Settings/Personal access tokens

  3. Create new token and give it descriptive name such as IICS-Configuration-Gist-Access

  4. Select only gist permission

    Github_New_personal_access_token

  5. Capture generated token and save it in a save location for later use in the Service Connector configuration after Deployment of the IICS package

    Personal_Access_Tokens

Connector Properties

Name Description
access_token Gist API Access Token
api_version API Version (currently V3)
base_uri Base URI of the REST endpoint Base URI of the REST endpoint https://api.github.com

gitlab-snippets

Provides Support to store and retrieve configurations or other files as GitLab Snippets See Gitlab API Documentation

Setup GitLab Account and Access Token

Make sure your secure agents can access the GitLab API to store and retrieve the Alert Service configuration file.

This Alert Service Implementation can use Cloud Hosted or on-premise GitLab as a storage for its configuration It is recommended to use private snippets to store this configuration, you will need to create Security token to access private Assets via API

  1. Login to GitLab with an account that would be owner of the configurations (this should be likely service Account or account managed by IT Infrastructure administrators)

  2. Go to Account Settings/Access Tokens

  3. Create new token and give it descriptive name such as IICS-Configuration-API-Access

  4. Optionally set expiration date

  5. Select api access permission

    Personal Access Tokens

  6. Capture generated Token and use it to configure GitLab Service Connector

Connector Properties

Name Description
base_uri GitLab API Base URL (example: https://gitlab.example.com/api)
access_token API Access Token
api_version API Version (currently v4)

ICS-API

This service defines actions to connect to IICS through REST API and perform Export/Import and license management activities

IPaaS-Configuration-DB

Database Used to Store Simple key/value configurations

This Connection provides ability to store configurations in External Database and Guides/processes to manage such configurations

IPaaS-Logging

Design: Explore/Logging/Connections/IPaaS-Logging.AI_CONNECTION.xml Description: IPaaS Database for Logging and job tracking

Processes

Glossary of Terms used in this Documents

Term Description
API Application Programming Interface
Application Integration Console ICAI Cloud and Secure Agent Runtime Administration Tool
BPEL Business Process Execution Language
BPMN Business Process Modeling Notation
DAS Data Access Service
ICAI (formerly ICRT) Informatica Cloud Application Integration, see ICRT
ICDI (formerly ICS) Informatica Cloud Data Integration is an ETL batch integration component of IICS platform
IICS Informatica Intelligent Cloud Services, Informatica Cloud Integration platform
IPD Informatica Process Designer
Informatica Secure Agent Informatica Data Integration Execution Agent that Provides ability to integrate data on premise and in the Cloud, hybrid data integration both batch and real time
REST REpresentational State Transfer
SDLC Software Development Lifecycle
WSDL Web Service Definition Language