Skip to content

Commit e0697ee

Browse files
author
epatel
committed
R2025a release!
1 parent dd7a39d commit e0697ee

File tree

2 files changed

+40
-40
lines changed

2 files changed

+40
-40
lines changed

‎releases/R2025a/README.md‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,11 @@ Click the **Launch Stack** button for your desired region below to deploy the cl
77
| Region | Launch Link |
88
| --------------- | ----------- |
99
| **us-east-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
10-
| **us-east-2** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://us-east-2.console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
11-
| **us-west-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://us-west-1.console.aws.amazon.com/cloudformation/home?region=us-west-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
1210
| **us-west-2** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://us-west-2.console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
13-
| **ca-central-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ca-central-1.console.aws.amazon.com/cloudformation/home?region=ca-central-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
14-
| **eu-central-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://eu-central-1.console.aws.amazon.com/cloudformation/home?region=eu-central-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
1511
| **eu-west-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://eu-west-1.console.aws.amazon.com/cloudformation/home?region=eu-west-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
16-
| **eu-west-2** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://eu-west-2.console.aws.amazon.com/cloudformation/home?region=eu-west-2#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
17-
| **eu-west-3** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://eu-west-3.console.aws.amazon.com/cloudformation/home?region=eu-west-3#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
18-
| **eu-north-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://eu-north-1.console.aws.amazon.com/cloudformation/home?region=eu-north-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
19-
| **sa-east-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://sa-east-1.console.aws.amazon.com/cloudformation/home?region=sa-east-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
20-
| **me-south-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://me-south-1.console.aws.amazon.com/cloudformation/home?region=me-south-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
21-
| **ap-east-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-east-1.console.aws.amazon.com/cloudformation/home?region=ap-east-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
22-
| **ap-south-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-south-1.console.aws.amazon.com/cloudformation/home?region=ap-south-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
2312
| **ap-northeast-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-northeast-1.console.aws.amazon.com/cloudformation/home?region=ap-northeast-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
24-
| **ap-northeast-2** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-northeast-2.console.aws.amazon.com/cloudformation/home?region=ap-northeast-2#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
25-
| **ap-southeast-1** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-southeast-1.console.aws.amazon.com/cloudformation/home?region=ap-southeast-1#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
26-
| **ap-southeast-2** | [![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Start an cluster using the template")](https://ap-southeast-2.console.aws.amazon.com/cloudformation/home?region=ap-southeast-2#/stacks/create/review?templateURL=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json) |
2713

14+
To deploy the cluster in a region not listed above, see [Deploy Cluster in a Custom Region](#deploy-cluster-in-a-custom-region).
2815

2916
## Step 2. Configure the Cloud Resources
3017
Clicking the **Launch Stack** button above opens the “Quick create stack” page in your browser. You can configure the parameters on this page. It is easier to complete the steps if you position these instructions and the AWS console window side by side.
@@ -187,13 +174,26 @@ By default, MATLAB Job Scheduler (MJS) is configured to manage a wide range of c
187174
To change the MJS configuration for advanced use cases, replace the default `mjs_def` with your own file using the template parameter `OptionalUserCommand`. This overwrites all MJS startup parameters, except for *DEFAULT_JOB_MANAGER_NAME*, *HOSTNAME*, and *SHARED_SECRET_FILE*. To learn more about the MJS startup parameters and to edit them, see [Define MATLAB Job Scheduler Startup Parameters](https://www.mathworks.com/help/matlab-parallel-server/define-startup-parameters.html).
188175
For example, to retrieve and use your edited `mjs_def` from a storage service (e.g. Amazon S3), set the `OptionalUserCommand` to the following:
189176
```
190-
wget --output-document=/mnt/matlab/toolbox/parallel/bin/mjs_def.sh https://<your_bucket>.s3.amazonaws.com/mjs_def.sh && rm /opt/mathworks/startup/*_edit-mjs-def.sh
177+
wget --output-document=/usr/local/matlab/toolbox/parallel/bin/mjs_def.sh https://<your_bucket>.s3.amazonaws.com/mjs_def.sh && rm /opt/mathworks/startup/*_edit-mjs-def.sh
191178
```
192179

193180
## Nested Stacks
194181

195182
This CloudFormation template uses nested stacks to reference templates used by multiple reference architectures. For details, see the [MathWorks Infrastructure as Code Building Blocks](https://github.com/mathworks-ref-arch/iac-building-blocks) repository.
196183

184+
## Deploy Cluster in a Custom Region
185+
186+
MathWorks provides prebuilt Amazon Machine Images (AMIs) only in the regions listed in [Step 1. Deploy the Template](#step-1-deploy-the-template). To deploy a cluster in a different region, follow these steps.
187+
188+
1. **Copy AMI into your account**: Use this AWS quick-create link to copy the latest MATLAB Parallel Server AMI on Linux into your AWS account. Clicking the link opens a CloudFormation template with prepopulated fields. Set the AWS region in the AWS console to your desired region and deploy the template to copy the AMI. Copying takes 5 to 15 minutes. You are responsible for the costs associated with the storage of this AMI and its snapshots in your AWS account. To save costs, delete this AMI and the snapshots if you no longer need it.
189+
190+
[![alt text](https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png "Copy an AMI into your AWS account")](https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?templateURL=https://mathworks-reference-architectures-templates.s3.amazonaws.com/copy-ami-lambda/v1/0/0/copy-ami-lambda.yml&stackName=Copy-of-MATLAB-Parallel-Server-R2025a-AMI&param_SourceAmiId=ami-096aa11e95ba97a78&param_SourceRegion=us-east-1&param_AmiName=Copy%20of%20MATLAB%20Parallel%20Server%20Linux%20R2025a&param_ReferenceTag=https://github.com/mathworks-ref-arch/matlab-parallel-server-on-aws&param_MWTemplateUrl=https://mdcs-on-aws.s3.amazonaws.com/R2025a/mjs-cluster-template.json)
191+
192+
2. **Deploy a cluster using your copied AMI**: After your copy is complete and your AMI is ready, use the `LaunchClusterWithCopiedAmi` link in the outputs tab to deploy a cluster in your desired region. You can also share this link or the Custom AMI ID with others in your AWS account to allow them to deploy clusters using the same AMI.
193+
194+
### Delete the Copied AMI
195+
When you deploy a cluster using an AMI, new worker instances are created from that AMI. Delete the AMI from your account only after you have finished using all clusters based on it. To delete the AMI, navigate to the copied AMI in the AWS console using the link in the Outputs tab of the stack. Choose `Actions`, then `Deregister AMI`. Select the option `Delete associated snapshots` to also delete the associated snapshot.
196+
197197
## Troubleshooting
198198

199199
If your stack fails to create, check the events section of the CloudFormation console. This section indicates which resources caused the failure and why.

‎releases/R2025a/mjs-cluster-template.json‎

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,58 +3,58 @@
33
"Mappings": {
44
"RegionMap": {
55
"us-east-1": {
6-
"AMI": "ami-03a5e877438139f6e"
6+
"AMI": "ami-096aa11e95ba97a78"
7+
},
8+
"us-west-2": {
9+
"AMI": "ami-00fb2ced9845d4ce1"
10+
},
11+
"eu-west-1": {
12+
"AMI": "ami-01d23a6401c84109b"
13+
},
14+
"ap-northeast-1": {
15+
"AMI": "ami-049085103b54c9eff"
716
},
817
"us-east-2": {
9-
"AMI": "ami-0f4f00b46e9e45b38"
18+
"AMI": "Enter the ID of a custom AMI in this region."
1019
},
1120
"us-west-1": {
12-
"AMI": "ami-095e9cd6d753e04d1"
13-
},
14-
"us-west-2": {
15-
"AMI": "ami-0f48f8225a3f9899e"
21+
"AMI": "Enter the ID of a custom AMI in this region."
1622
},
1723
"ca-central-1": {
18-
"AMI": "ami-08f0996296df65392"
24+
"AMI": "Enter the ID of a custom AMI in this region."
1925
},
2026
"eu-central-1": {
21-
"AMI": "ami-0ea5ed1362837d027"
22-
},
23-
"eu-west-1": {
24-
"AMI": "ami-0ce0de6e65a17b581"
27+
"AMI": "Enter the ID of a custom AMI in this region."
2528
},
2629
"eu-west-2": {
27-
"AMI": "ami-02153bb9a300a8fe3"
30+
"AMI": "Enter the ID of a custom AMI in this region."
2831
},
2932
"eu-west-3": {
30-
"AMI": "ami-07d6898bb9f117b61"
33+
"AMI": "Enter the ID of a custom AMI in this region."
3134
},
3235
"eu-north-1": {
33-
"AMI": "ami-00e50c412060ef509"
36+
"AMI": "Enter the ID of a custom AMI in this region."
3437
},
3538
"sa-east-1": {
36-
"AMI": "ami-0e02049bd09bfcc3d"
39+
"AMI": "Enter the ID of a custom AMI in this region."
3740
},
3841
"me-south-1": {
39-
"AMI": "ami-06f50e6e218363e8f"
42+
"AMI": "Enter the ID of a custom AMI in this region."
4043
},
4144
"ap-east-1": {
42-
"AMI": "ami-0a3da77fc77ffe5b6"
45+
"AMI": "Enter the ID of a custom AMI in this region."
4346
},
4447
"ap-south-1": {
45-
"AMI": "ami-08f336fa978921f78"
46-
},
47-
"ap-northeast-1": {
48-
"AMI": "ami-073fd20894de40ace"
48+
"AMI": "Enter the ID of a custom AMI in this region."
4949
},
5050
"ap-northeast-2": {
51-
"AMI": "ami-089d0b683ab483d0a"
51+
"AMI": "Enter the ID of a custom AMI in this region."
5252
},
5353
"ap-southeast-1": {
54-
"AMI": "ami-0c47dd1bc384d4ba6"
54+
"AMI": "Enter the ID of a custom AMI in this region."
5555
},
5656
"ap-southeast-2": {
57-
"AMI": "ami-06422b353152e76c0"
57+
"AMI": "Enter the ID of a custom AMI in this region."
5858
}
5959
}
6060
},
@@ -118,7 +118,7 @@
118118
"Ref": "Headnode"
119119
},
120120
"VolumeDeviceName": "/dev/sdh",
121-
"PreSnapshotCommand": "{{AWS-RunShellScript}}/mnt/matlab/toolbox/parallel/bin/mjs stop -cleanPreserveJobs",
121+
"PreSnapshotCommand": "{{AWS-RunShellScript}}/usr/local/matlab/toolbox/parallel/bin/mjs stop -cleanPreserveJobs",
122122
"Tags": {
123123
"Fn::Sub": "Name=MW-MATLABParallelServer-${ClusterName},mw-ConfigId=${SnapshotTag},mw-CreatedFromStack=${AWS::StackName},mw-ProductId=MATLABParallelServer,mw-CreatedFromStackId=${AWS::StackId},mw-ClusterName=${ClusterName}"
124124
},

0 commit comments

Comments
 (0)