Skip to content

Commit

Permalink
aws marketplace
Browse files Browse the repository at this point in the history
  • Loading branch information
@guillermo-musumeci
guillermo-musumeci committed Sep 25, 2023
1 parent c17e74b commit 9932338
Showing 1 changed file with 25 additions and 15 deletions.
40 changes: 25 additions & 15 deletions docs/setup/setup-aws-marketplace.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,12 @@ Deploying an EC2 Instance with KopiCloud AD API from AWS Marketplace

----

## Deploying API from AWS Marketplace
## Select the KopiCloud AMI

To deploy an AWS EC2 Instance With KopiCloud AD API from the AWS Marketplace image, follow the procedure below:


1) Open the Amazon EC2 console at (https://console.aws.amazon.com/ec2).
1) Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2](https://console.aws.amazon.com/ec2).


2) From the Amazon EC2 console dashboard, choose **Launch instance**.
Expand All @@ -43,25 +43,29 @@ A dialog box opens with an overview of the version of the KopiCloud AD API you'v
> Note: You will only pay AWS EC2 costs as the KopiCloud AD API license in AWS is BYOL (Bring your own license).

6) After we selected the image, we need to configure the EC2 Instance
----

## Configure the EC2 Instance

After we selected the image, we need to configure the EC2 Instance

6.1) Under **Name and tags**, for Name, enter a descriptive name for your instance.

1) Under **Name and tags**, for Name, enter a descriptive name for your instance.

![EC2 Instance Name](https://adapihelp.kopicloud.com/assets/marketplace/aws-marketplace-05.png)


6.2) For **Instance type**, select an instance type for your instance. T3.Medium or T3.Large is recommended for the setup.
2) For **Instance type**, select an instance type for your instance. T3.Medium or T3.Large is recommended for the setup.

![EC2 Instance Type](https://adapihelp.kopicloud.com/assets/marketplace/aws-marketplace-06.png)


6.3) Under **Key pair (login)** section, for Key pair name, choose an existing key pair or create a new one.
3) Under **Key pair (login)** section, for Key pair name, choose an existing key pair or create a new one.

![EC2 Instance Key Pair](https://adapihelp.kopicloud.com/assets/marketplace/aws-marketplace-07.png)


6.4) Under **Network settings, Firewall (security groups)**, please review the new security group that was created for **KopiCloud AD API**.
4) Under **Network settings, Firewall (security groups)**, please review the new security group that was created for **KopiCloud AD API**.

The security group includes rules that allow all IPv4 addresses (0.0.0.0/0) access on RDP (port 3389) on Windows.

Expand All @@ -70,12 +74,12 @@ The security group includes rules that allow all IPv4 addresses (0.0.0.0/0) acce
![EC2 Instance Security Group](https://adapihelp.kopicloud.com/assets/marketplace/aws-marketplace-08.png)


6.5) In the section **Configure storage**, you can keep or increase the 30 GB default size.
5) In the section **Configure storage**, you can keep or increase the 30 GB default size.

![EC2 Instance Storage](https://adapihelp.kopicloud.com/assets/marketplace/aws-marketplace-09.png)


7) In the **Summary panel**, under Software Image (AMI), check the details of the AMI from which you're about to launch the instance.
6) In the **Summary panel**, under Software Image (AMI), check the details of the AMI from which you're about to launch the instance.

Also, check the other configuration details that you specified. When you're ready to launch your instance, choose the **Launch instance** button.

Expand All @@ -91,11 +95,17 @@ If there are any problems with your credit card details, you will be asked to up

When the launch confirmation page displays, choose **View all instances** to go to the **Instances** page.

----

## Final Steps

After the EC2 instance is launched, you need to complete the final steps:


8) Generate a license at (https://adapi.kopicloud.com/get-license)
1) Generate a free trial license at [https://adapi.kopicloud.com/get-license](https://adapi.kopicloud.com/get-license)


9) When the machine is ready, retrieve your initial administrator password using the AWS CLI or AWS Console.
2) When the machine is ready, retrieve your initial administrator password using the AWS CLI or AWS Console.

In the AWS Console, select the new instance, then click on **Actions** menu, select **Security**, and then **Get Windows password**.

Expand All @@ -104,12 +114,12 @@ In the AWS Console, select the new instance, then click on **Actions** menu, sel
Follow the instructions to retrieve the password.


10) Log in to the EC2 Instance using the default Windows username (Administrator), and the password retrieved in the previous step.
3) Log in to the EC2 Instance using the default Windows username (Administrator) and the password retrieved in the previous step.


11) Join the EC2 Instance to the AD Domain that we will manage using the API and restart the machine.
4) Join the EC2 Instance to the AD Domain that we will manage using the API and restart the machine.

Note: Based on the VPC and Subnet configuration, extra steps may be required to join the machine to the domain.
>Note: Based on the VPC and Subnet configuration, extra steps may be required to join the machine to the domain.

12) Run the **KopiCloud AD API Config tool** located in the folder **C:\KopiCloud-AD-API-Config** to finish the setup of the API.
5) Run the **KopiCloud AD API Config tool** located in the folder **C:\KopiCloud-AD-API-Config** to finish the setup of the API.

0 comments on commit 9932338

Please sign in to comment.