Walk through of deploying InterSystems API Manager (IAM) on AWS EC2
Tags: aws, cloud, api, tutorial
Published: 2023-05-28 21:20:51

In this article, I am trying to walk through my deploying step of IAM on my EC2(ubuntu).

## What is IAM?

IAM is InterSystems API Manager  
you may reference to the link below to get more idea about IAM

<https://docs.intersystems.com/components/csp/docbook/Doc.View.cls?KEY=PAGE_apimgr>

![generated description: apimgr description.jpg](https://docs.intersystems.com/components/csp/docbook/images/page_apimgr_description.jpg) 

 

## Before deploying IAM

### Check the license of your API host  

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zfvebuohxcjwt5jdkvj9.png)


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ca32rltxer7dvgd2m5cl.png) 

####  

### Enable the User IAM


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/kffre9l0088z0kcrlrt9.png)


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/5qe3lw9byk5n16ppmw0z.png)

 

## Deploy IAM

### Reference 

<https://community.intersystems.com/post/introducing-intersystems-api-manager>

 

### Download the image from the following link

<https://wrc.intersystems.com/wrc/coDistGen.csp>

I downloaded the following version to my pc


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/hcb34b2rnematvtbs5lx.png) 

 

### Upload the image to my EC2

I use the command scp to upload the image to my cloud


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/n29rr9jk79jj4nax6yjx.png) 

###  

### Make sure docker and docker compose are installed

If not, please reference to the following link

[ https://docs.docker.com/engine/install/ubuntu/](http://https://docs.docker.com/engine/install/ubuntu/)

 

### Untar the image file

tar zpxvf IAM-3.0.2.0-4.tar.gz


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/9qantwykwd61d6byzfb4.png) 

###  

### Load the image into docker

sudo docker load -i iam_image.tar


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lcsep5hq2h5s0ty2zh2h.png) 

 

### Run the iam-setup.sh

source ./iam-setup.sh <span> </span>


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/oa8grp0awb6a3idqtthn.png) 


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/nvm9e8z8xrr9j4k3tbus.png) 

 

### Edit the file : docker-compose.yml 

In order to let us visit the IAM UI from the environment outside the EC2, replace the localhost by the EC2 public address in the parameter KONG\_PORTAL\_GUI\_HOST and KONG\_ADMIN\_GUI\_URL

vi docker-compose.yml 


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/mtryapqfdujvv6tjln6u.png) 

 

### Start the container

sudo docker compose up -d


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ygoxfpkt2w636mtk9ivc.png) 

###  

### Check the IAM UI

You can access the UI of the IAM by the following link

http://yourEC2publicAddress:8002/overview


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/dk04bxpwlypb91otrnmf.png)