Connecting to an Existing QNX AMI Instance

This section describes how to connect to an existing QNX AMI instance from your host computer and the QNX Momentics IDE.

Check the prerequisites for instance connection

Before connecting to an existing instance, ensure that you have the proper requirements to access it.
  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/ and choose Instances.
  2. Locate and open the target QNX AMI instance. On the target instance page, make sure the instance is running. Otherwise, start the instance by choosing Instance state > Start instance.
  3. Check the Security tab to ensure the security group allows your host computer to connect.
  4. You'll need the public IP DNS address, key pair file location, and username to connect to the instance. Obtain the public IP DNS address and the key pair of the instance. The instance owner should provide the key pair or the password for the instance. Record the key pair file location where you saved the key pair. The default username is qnxuser.

Connect to a QNX AMI instance with your host computer or VS Code

To connect to a QNX AMI instance with your host computer, open your host Command Prompt and use the ssh -i command to connect the instance with the key pair file location, the username (default qnxuser), and the public IP DNS address for the instance:
ssh -i <key file location>.pem qnxuser@<public IP DNS address>

This is the similar way when connecting with VS Code; go to the QNX Toolkit for Visual Studio Code guide about Managing targets with VS Code.

Users should use SSH to connect to the instance. Another connection method is the Amazon EC2 serial console. Only one serial console can be active at one time for an instance and is usually reserved for debugging. For details, go to the Amazon EC2 User guide on how to https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-to-linux-instance.html.

Access the QNX AMI instance with the QNX Momentics IDE

To access your target instance from the QNX Momentics IDE, you must create a target connection on Momentics.
  1. On the instance, run the qconn command to specify the port (e.g., qconn port=8000).
  2. Open a QNX Momentics project on your host computer.
  3. In the Target Navigator panel, create New QNX Target.
  4. For Hostname or IP, enter the public IP DNS address of the QNX AMI instance.
  5. For Port, enter the port specified earlier.
Now you can use your instance with Momentics.

You can use the QNX AMI image instance like any QNX-based system using the QNX product documentation at https://www.qnx.com/developers/docs/index.html.

For details on the Amazon environment, go to the Amazon documentation at https://docs.aws.amazon.com/.

Page updated: