Creating an Amazon Machine Image for a Burn Node
This topic explains how to create an instance with Rocky Linux and install an Autodesk Burn node.
Prerequisites:
- An Autodesk Account
- The Rocky Linux AMI from Autodesk in your account
Do not use aws_configure
or store your credentials when creating the image, as this would include your credentials in the Burn AMI.
Install the Autodesk Burn Software
Apart from the installed software, the Burn AMI differs from the Flame Family AMI by being able to run without a display; the Burn AMI is a headless configuration.
Download the Autodesk Burn software TAR files from your Autodesk Account.
Upload the Autodesk Burn software files to an S3 bucket.
Launch an instance using the AMI created in the previous section. You need an instance with a GPU, a G4dn or G5 instance.
From your local machine, connect to the instance through ssh. Use the
flameadmin
account and the keypair of the instance.ssh -i <keypair> flameadmin@<INSTANCE PUBLIC IP>
Create a temporary work folder:
mkdir -p /tmp/provisioning
(Optional) Set the time zone.
The Autodesk Rocky Linux AMI is set to the Eastern Time zone (America/New_York). Best practice is to set your instance to your timezone.
Get the list of time zones with the following command.
timedatectl list-timezones
From the list of time zones, locate the one you need such as
America/New_York
and use it to set the time zone on the instance.sudo timedatectl set-timezone <Your-Timezone>
Install the Burn software.
cd /tmp/provisioning aws s3 cp <BURN TAR FILE> burn.tar tar xf burn.tar cd `tar tf burn.tar | head -1 | cut -d "/" -f 1` sudo ./INSTALL_BURN_HEADLESS --imageprep
Clean up:
sudo sed -i 's/ID=.*$/ID=/' /opt/Autodesk/sw/cfg/sw_storage.cfg sudo find /opt/Autodesk/ -type f \( -name '*.log' -o -name '*.log.[1-9]*' \) -exec rm -f {} \; sudo sed -i 's|^\([# \\t]*\)Scope=224.0.0.1|Scope=239.0.0.1|' /opt/Autodesk/cfg/network.cfg sudo sed -i 's/224.0.0.1/239.0.0.1/g' /opt/Autodesk/*/bin/verifyBurnConn echo "net.ipv4.conf.all.force_igmp_version=2" | sudo tee --append /etc/sysctl.conf sudo shred -u ~/.aws* /etc/ssh/*_key /etc/ssh/*_key.pub ~/.*history cd && sudo rm -fr /tmp/provisioning
Clear the command line history and shut down the instance.
history -c sudo shutdown now
You can now convert this instance image to a Burn node AMI.
Create the final AMI
- From the AWS Console, go the EC2 Instances page.
- Right-click on the stopped instance that was created in the previous section.
- Select Image and Templates
Create Image.
- Give the new image a name and a description.
- Select No reboot.
- Decide if you want the instance volume to be deleted on termination (Enabled by default).
- You can keep all other options as default, or adjust according to your needs.
- Click Create Image.
- Your new AMI will appear in the AMI section of the EC2 Management Console.
You can now use this AMI to launch Burn-ready instances. For more information, see Autodesk Burn Configuration.
(Optional) Optimize the NVIDIA GPU for Your Instance
The optimization of the GPU depends on the instance type you are using; see AWS documentation for parameters specific to each available instance type.
For example, to set optimal NVIDIA GPU settings for a G4dn instance, enter the following settings on the command line.
sudo nvidia-persistenced
sudo nvidia-smi -ac 5001,1590