Skip to content

Minor updates to LSQL and LDMS modules. #127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
switch180 merged 6 commits into from
Jul 10, 2025
Merged

Minor updates to LSQL and LDMS modules. #127

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
928f9dc
Updated the git hash to use in LSQL workshop.
May 15, 2025
b254ec9
Minor updates to improve portability and readability.
May 15, 2025
dfb4ffc
Merge branch 'master' into fix/update-lsql-and-ldms-instructions
switch180 Jul 9, 2025
5db9b4b
revert to commit 47a43bedf75bc0859e9141ad1bdd1f330f0933f1
switch180 Jul 9, 2025
bb8fe1d
Merge branch 'master' into fix/update-lsql-and-ldms-instructions
switch180 Jul 9, 2025
0ad6daf
Revert
switch180 Jul 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions content/rdbms-migration/migration-chapter02-1.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,23 @@ date: 2021-04-25T07:33:04-05:00
weight: 25
Copy link
Contributor

@switch180 switch180 May 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please hold off on merging until Aman has a chance to sync his changes to the labs. He did a direct commit on the internal version, and these changes might conflict on merge.

---

Let's create the DMS resources for the workshop.
Let's create the DMS resources for the workshop. First, we ensure if a DMS service role `dms-vpc-role` is already available. Then we need to deploy the DMS resources.

1. Go to IAM console > Roles > Create Role
2. Under “Select trusted entity” select “AWS service” then under “Use case” select “DMS” from the pulldown list and click the “DMS” radio button. Then click “Next”
3. Under “Add permissions” use the search box to find the “AmazonDMSVPCManagementRole” policy and select it, then click “Next”
5. Under “Name, review, and create” add the role name as exactly `dms-vpc-role` and click Create role
1. Go to IAM console > Roles > Search for `dms-vpc-role`. If you see a role, skip to the CloudFormation stack deployment. Else, select **Create role** and follow next steps.
2. Under **Select trusted entity** select **AWS service** then under **Use case** select **DMS** from the drop-down and click the **DMS** radio button. Then click **Next**
3. Under **Add permissions** use the search box to find the `AmazonDMSVPCManagementRole` policy and select it, then click **Next**
5. Under **Name, review, and create** add the role name as exactly `dms-vpc-role` and click **Create role**

::alert[_Do not continue unless you have made the IAM role._]

1. Launch the CloudFormation template in US West 2 to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=dynamodbmigration&templateURL=:param{key="lhol_migration_dms_setup_yaml"})
1. Launch the CloudFormation template in the workshop region to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home#/stacks/new?stackName=dynamodbmigration&templateURL=:param{key="lhol_migration_dms_setup_yaml"})
1. *Optionally, download [the YAML template](:param{key="lhol_migration_dms_setup_yaml"}) and launch it your own way*
9. Click Next
10. Confirm the Stack Name *dynamodbmigration* and keep the default parameters (modify if necessary)
9. Click **Next**
10. Confirm the Stack name `dynamodbmigration` and keep the default parameters (modify if necessary)
![Final Deployment Architecture](/static/images/migration18.jpg)
11. Click “Next” twice
12. Check “I acknowledge that AWS CloudFormation might create IAM resources with custom names.”
1. Click Submit. The CloudFormation template will take about 15 minutes to build a replication environment. You should continue the lab while the stack creates in the background.
11. Click **Next** twice
12. Check ***I acknowledge that AWS CloudFormation might create IAM resources with custom names***.
1. Click **Submit**. The CloudFormation template will take about 15 minutes to build a replication environment. You should continue the lab while the stack creates in the background.
![Final Deployment Architecture](/static/images/migration19.jpg)

::alert[_Do not wait for the stack to complete creation._ **Please continue the lab and allow it to create in the background.**]
Expand Down
15 changes: 9 additions & 6 deletions content/rdbms-migration/migration-chapter02.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,21 @@ date: 2021-04-25T07:33:04-05:00
weight: 20
---
This chapter will create source environment on AWS as discussed during Exercise Overview.

::alert[MySQL Environment with data has already been deployed in your workshop account. No action is required on this page. The following steps are for you to learn. Head over to next page to deploy DMS resources.]

The CloudFormation template used below will create Source VPC, EC2 hosting MySQL server, IMDb database and load IMDb public dataset into 6 tables.

1. Launch the CloudFormation template in US West 2 to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=rdbmsmigration&templateURL=:param{key="lhol_migration_setup_yaml"})
1. Launch the CloudFormation template in workshop region to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home#/stacks/new?stackName=rdbmsmigration&templateURL=:param{key="lhol_migration_setup_yaml"})
1. *Optionally, download [the YAML template](:param{key="lhol_migration_setup_yaml"}) and launch it your own way*
4. Click Next
5. Confirm the Stack Name *rdbmsmigration* and update parameters if necessary (leave the default options if at all possible)
4. Click **Next**
5. Confirm the Stack name `rdbmsmigration` and update parameters if necessary (leave the default options if at all possible)
![Final Deployment Architecture](/static/images/migration6.jpg)
6. Click “Next” twice then check “I acknowledge that AWS CloudFormation might create IAM resources with custom names.”
7. Click "Submit"
6. Click **Next** twice then check ***I acknowledge that AWS CloudFormation might create IAM resources with custom names***.
7. Click **Submit**
8. The CloudFormation stack will take about 5 minutes to build the environment
![Final Deployment Architecture](/static/images/migration7.jpg)
9. Go to [EC2 Dashboard](https://console.aws.amazon.com/ec2/v2/home?region=us-west-2#Instances:) and ensure the Status check column is 2/2 checks passed before moving to the next step.
9. Go to [EC2 Dashboard](https://console.aws.amazon.com/ec2/v2/home#Instances:) and ensure the **Status check** column is 2/2 checks passed before moving to the next step.
![Final Deployment Architecture](/static/images/migration8.jpg)


Expand Down
9 changes: 5 additions & 4 deletions content/rdbms-migration/migration-chapter03.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ It created a MySQL database called `imdb`, added 6 new tables (one for each IMDb
The CloudFormation template also configured a remote MySQL user based on input parameters for the template.
To explore the dataset, follow the instructions below to log in to the EC2 server.

1. Go to [EC2 console](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Instances:instanceState=running).
2. Select the MySQL Instance and click Connect.
1. Go to [EC2 console](https://console.aws.amazon.com/ec2/v2/home#Instances:instanceState=running).
2. Select the MySQL Instance and click **Connect**.
![Final Deployment Architecture](/static/images/migration9.jpg)
3. Make sure "ec2-user" is in the Username field. Click Connect.
3. Make sure `ec2-user` is in the **User name** field. Click **Connect**.
![Final Deployment Architecture](/static/images/migration10.jpg)
4. Elevate your privileges using the `sudo` command.
```bash
Expand All @@ -31,7 +31,8 @@ To explore the dataset, follow the instructions below to log in to the EC2 serve
6. You can see all the 6 files copied from the IMDB dataset to the local EC2 directory.
![Final Deployment Architecture](/static/images/migration12.jpg)
7. Feel free to explore the files.
8. Go to AWS CloudFormation [Stacks](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks?filteringStatus=active&filteringText=&viewNested=true&hideStacks=false) and click on the stack you created earlier. Go to the Parameters tab and copy the username and password listed next to "DbMasterUsername" and "DbMasterPassword".
8. If you are completing this workshop at an AWS hosted event, go to [AWS CloudFormation Console](https://console.aws.amazon.com/cloudformation/home#/stacks?filteringStatus=active&filteringText=&viewNested=true&hideStacks=false) and select the stack named **ddb**. Go to the **Parameters** tab and copy the username and password listed next to **DbMasterUsername** and **DbMasterPassword**.
::alert[_If you are completing this workshop in your AWS account copy the **DbMasterUsername** and **DbMasterPassword** from the CloudFormation stack used to configure the MySQL environment._]
Copy link
Contributor

@tebanieo tebanieo May 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NIT: Add spaces in between the warnings for better readibility.

Copy link
Contributor Author

@iojior iojior May 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update applied. Thanks.

![Final Deployment Architecture](/static/images/migration13.jpg)
9. Go back to EC2 Instance console and login to mysql.
```bash
Expand Down
Loading