This article describes how you can connect to your Aspera on Demand image via SSH. This is required for various administrative tasks, such as restarting system services, License entitlement, or custom configurations. It is possible to ssh from Windows, Linux and Mac systems. Linux and MAC are a little easier, as they come with an SSH client by default. For Windows, a few additional steps are required. The steps required for all systems are described below.
NOTE: The private key is provided by the AWS management console. It is available ONLY at the time of creation. You can create your SSH keypairs in advance of booting up an AMI, or during the AMI boot process. If the private key is lost, then you can no longer access the Linux terminal of your Aspera on Demand. Neither Aspera or Amazon can provide a replacement for lost keys.
Linux and MAC
Open the Terminal application. The command belowYou need to use the .pem private key, port 33001 and user ec2-user, for example:
# ssh -i <YOURKEY>.pem -p 33001 ec2-user@<name of your instance or instance IP>
NOTE: The private key <YOURKEY>.pem needs to have the correct permissions. If you just downloaded it from AWS, then it will most likely have the wrong permissions. If you get an error message about the key permissions when trying to SSH, then please change the permissions as follows:
#chmod 600 <YOURKEY>.pem
NOTE: Once you have changed the permission, try to login in again. Once you are logged into the command prompt, you can use the 'sudo' command to get root privileges, for example:
#sudo su -
For Windows users, if you do not have SSH client installed, you will need to get an SSH client (e.g. putty.exe is freely downloadable) as well as an SSH key convertor (puttygen.exe is also freely downloadable) , to convert your private SSH key from pem format to ppk format. You can find these using any common search engine and the search string 'putty.exe' or 'puttygen.exe'.
Here is a screenshot of the puttygen key generator/converter. The following screenshots show the key converter (PuTTY Key Generator). In the PuTTY Key generator screen below I have loaded the existing .pem key, and all that needs to be done is click on 'save private key', in order to have a key in .ppk format.
The following screen show the Putty Key Selection screen:
This screen shows the new Session screen :
If you are not familiar with how to do this, please contact email@example.com.
The ec2-user has 'sudo' privileges, for example
#sudo su -