Communities
A collaborative platform to connect and grow with like-minded Informaticans across the globe
Product Communities
Connect and collaborate with Informatica experts and champions
Discussions
Have a question? Start a Discussion and get immediate answers you are looking for
User Groups
Customer-organized groups that meet online and in-person. Join today to network, share ideas, and get tips on how to get the most out of Informatica
Get Started
Community Guidelines
Knowledge Center
Troubleshooting documents, product guides, how to videos, best practices, and more
Knowledge Base
One-stop self-service portal for solutions, FAQs, Whitepapers, How Tos, Videos, and more
Support TV
Video channel for step-by-step instructions to use our products, best practices, troubleshooting tips, and much more
Documentation
Information library of the latest product documents
Velocity (Best Practices)
Best practices and use cases from the Implementation team
Learn
Rich resources to help you leverage full capabilities of our products
Trainings
Role-based training programs for the best ROI
Certifications
Get certified on Informatica products. Free, Foundation, or Professional
Product Learning Paths
Free and unlimited modules based on your expertise level and journey
Resources
Library of content to help you leverage the best of Informatica products
Tech Tuesdays Webinars
Most popular webinars on product architecture, best practices, and more
Product Availability Matrix
Product Availability Matrix statements of Informatica products
SupportFlash
Monthly support newsletter
Support Documents
Informatica Support Guide and Statements, Quick Start Guides, and Cloud Product Description Schedule
Product Lifecycle
End of Life statements of Informatica products
Ideas
Events
Change Request Tracking
Marketplace
English
  • Administrator
  • All Products

Table of Contents

Search

  1. Preface
  2. Runtime environments
  3. Hosted Agent
  4. Secure Agent groups
  5. Serverless runtime environments
  6. Connectors in a serverless runtime environment
  7. Secure Agents
  8. Secure Agent installation

Runtime Environments

Runtime Environments

Back Next

Installing in AWS

Installing in AWS

The
Secure Agent
 installer can help you create a runtime environment on Amazon Web Services (AWS). The runtime environment you create is a Secure Agent group that contains one Secure Agent.
When you create a runtime environment on AWS, you create a new stack where the Secure Agent is deployed. You can create the stack in a new or existing virtual private cloud (VPC). The installer creates an Amazon Elastic Compute Cloud (EC2) instance within the VPC.
To create a runtime environment, you must have a subscription with AWS that includes create, modify, and delete privileges for the following resource types:
  • EC2 instances
  • Elastic IP addresses
  • Elastic network interfaces
  • Internet gateways
  • Route tables
  • Security groups
  • Subnets
  • VPCs
You must also have read and launch permissions for machine images.
  1. In Administrator, select
    Runtime Environments
    .
  2. On the
    Runtime Environments
     page, click
    Manage Cloud Secure Agents
    .
  3. Click
    New Cloud Secure Agent
    .
  4. Select
    Amazon Web Services
    .
  5. Click
    Next
    .
  6. On the
    Environment Configuration
     page, copy the install token.
    The install token is valid for 24 hours and can't be reused.
  7. Choose whether to create the runtime environment on an existing or new VPC.
  8. Click
    Continue Configuration in AWS
    .
    The AWS
    Sign in
     screen opens in a new browser tab.
  9. Sign in to your AWS account.
    The
    Quick create stack
     page opens.
  10. In the
    Stack name
     area, enter a stack name.
  11. In the
    Parameters
     area, under
    Network Configuration
    , configure the following properties based on whether you're using an existing VPC or a new VPC.
    • For an existing VPC, configure the following properties:
      Property
      Value
      VPC ID
      Select the ID for the VPC where you want to deploy the Secure Agent.
      Subnet ID
      Enter or select a subnet within the VPC.
      Allowed Remote Access CIDR
      Enter the CIDR block that specifies the IP addresses where the Secure Agent can be installed.
      CIDR (Classless Inter-Domain Routing) is a method for allocating IP addresses. It configures a network rule to allow remote access to the Secure Agent. The "/x" portion of the address determines how many IP addresses are available in the subnet, for example: 108.124.81.10/32
    • For a new VPC, configure the following properties:
      Property
      Value
      Availability Zones
      Select the availability zone for your region.
      VPC CIDR
      Enter the CIDR block that specifies the IP addresses where you want to create the VPC.
      Subnet CIDR
      Enter the CIDR block that specifies the IP addresses for the subnet in the availability zone that you selected.
      Allowed Remote Access CIDR
      Enter the CIDR block that specifies the IP addresses where the Secure Agent can be installed.
  12. Under
    Amazon EC2 Configuration
    , configure the following properties:
    Property
    Value
    Key Pair Name
    Enter the name of an existing EC2 key pair to enable external access to the EC2 instance. Corresponding key pair files are required for SSH access to the server.
    Instance Type
    Select the instance type for the EC2 instance or accept the default.
    Default is m5.xlarge.
    Enable Elastic IP Addressing
    Choose whether to assign elastic IP addresses to the EC2 instance or accept the default.
    Default is no.
  13. Under
    Informatica Intelligent Data Management Cloud (IDMC) Account Details
    , configure the following properties:
    Property
    Value
    IDMC POD Master URL
    Accept the default value for the IDMC POD Master URL. This is the URL that you use to access
    Informatica Intelligent Cloud Services
    .
    Changing this URL can result in stack deployment failure.
    IDMC User Name
    Enter your
    Informatica Intelligent Cloud Services
     user name.
    IDMC User Token
    Paste the install token that you copied.
    If you forgot to copy the install token, you can switch back to
    Informatica Intelligent Cloud Services
     and generate a new one.
    Secure Agent Group Name
    Accept the default value for the Secure Agent group name. This is the name of the runtime environment that you're creating.
  14. Click
    Create stack
    .
    It takes a few minutes to create the stack. Be sure to monitor the stack creation and address any issues that might occur. For more information about troubleshooting CloudFormation stacks, see the AWS documentation.
    When the stack is created successfully, the EC2 Instance status changes from CREATE_IN_PROGRESS to CREATE_COMPLETE.
  15. In
    Informatica Intelligent Cloud Services
    , on the
    Environment Configuration
     page, click
    Finish
    .
    IICS creates your runtime environment and displays it on the
    Runtime Environments
     page.
    To see the progress of your pending Secure Agents, click
    Manage Cloud Secure Agents
     on the
    Runtime Environments
     page. The status appears at the top of the page.
It takes a few minutes for the Secure Agent services to start. When the Secure Agent is ready to use, the status changes from "Pending Environment Set Up" to "Up and Running." You might need to refresh the page to see the updated status.
0 COMMENTS
We’d like to hear from you!
Alessio Giordani - December 02, 2024

Hello documentation team,

as described in this KB article - ERROR: "Template error: Unable to get mapping for AWSAMIRegionMap" while installing Secure agent on AWS, the only supported AWS regions are given below: 

  1. ap-southeast-2
  2. eu-west-2
  3. eu-central-1
  4. us-west-2

Actually, opening the template I can see 

            "us-east-1": {...},
            "eu-west-2": {...},
            "eu-west-1": {...},
            "ap-northeast-1": {...},
            "ca-central-1": {...},
            "ap-southeast-2": {...},
            "eu-central-1": {...},
            "us-west-2":{...}

can you please include this information in the user manual?

Thanks,

Alessio

Informatica Documentation Team - December 02, 2024

Thank you, Alessio! We'll add this information to the documentation in an upcoming release.

Alessio Giordani - December 19, 2024

Hello documentation team,

I've noticed that the machine created by the cloud formation template is a Red Hat Enterprise Linux version 8.10 (Ootpa). I think would be good mention it in the user guide since customer could have constraints on OS type and version that can be used.

Regards,

Alessio 

Informatica Documentation Team - December 19, 2024

Thank you, Alessio! We'll add this to the documentation in an upcoming release.

Informatica Documentation Team - December 19, 2024

Hi again Alessio,

We've confirmed with our development team that as of the October 2024 release, CloudFormation templates are no longer supported.