Linux Hosts

This chapter includes the following:

• System requirements
• Installing QNX Momentics
• Activating QNX Momentics
• Commercializing your evaluation software
• Uninstalling QNX Momentics
• Determining your base directory

---

If you've already installed an evaluation version of QNX Momentics 6.3.2, and you've purchased and received a commercial QNX License Certificate, please go to "Commercializing your evaluation software," below.

---

System requirements

Host OS:

• Red Hat Enterprise Linux Workstation 4 or 5
• Red Hat Fedora Core 6 or 7
• Ubuntu 6.0.6 LTS or 7.0.4
• SUSE Linux 10

The System Profiler in the IDE requires a minimum color depth of 16 bits.

Installing QNX Momentics

QNX Momentics 6.3.2 includes everything you need to build for all supported platforms (ARM, MIPS, PowerPC, SH-4, and x86).

---

If you're running selinux (secure Linux), disable it before installing QNX Momentics. Otherwise, after you've entered the license key and clicked Next, the installation will fail with this error: java.lang.UnsatisfiedLinkError: no qnxlic in java.library.path

---

To install QNX Momentics 6.3.2, do the following:

1. Boot into Linux and log in as root.
2. Insert the QNX Momentics Linux Host CD in the CD drive.
3. If the system offers to run autorun, choose Yes; otherwise run momentics-6.3.2-nnnnnnnnnnnn-linux.bin (where nnnnnnnnnnnn is a build number), which you'll find in the root directory of the CD.

   ---

   If your system won't let you execute from a CD, unmount the CD and remount it by hand.

   ---

4. Follow the instructions provided by InstallShield.

   If QNX Software Systems has a contract with you to support server-based licenses, you have a special license key that tells the software to enforce these licenses. In this case, the installer presents a panel where you can specify the hostname or IP address of the server, and the port on which the server is listening for connections. If you're using the default port, you can leave the port blank.

5. Log out and log back in again, so that the environment is set up correctly.

Activating QNX Momentics

The QNX Momentics development suite and certain related products require activation. If you don't activate the product within the specified timeframe, the product will cease to function until you activate it. No personal data is transferred during the activation process.

Activating automatically

If your development host is connected to the Internet, you can activate QNX Momentics automatically.

Activating manually

If your machine isn't connected to the Internet, you must activate your software manually from a machine that is, by doing the following:

1. In the QNX Momentics Activation dialog, click Activate Manually.

   The Manual Activation dialog appears with an activate-prompt key. This dialog has a button that you can use to save the activate-prompt key in a file, /etc/qnx/license/activate_prompt_key.txt. This can eliminate the need to retype the key, which can be error-prone.

2. Transfer the activate-prompt key to the machine that's connected to the Internet.
3. Go to our website, www.qnx.com, log into your myQNX account, and choose Activate Products (6.3.x).
4. Enter the activate-prompt key into the form that appears, and then click Generate Response Key. This will return an activate-response key.
5. Copy the activate-response key and paste it in a file.
6. Transfer the file into /etc/qnx/license/activate_response_key.txt on your QNX Momentics development host.
7. If you closed the QNX Momentics Activation dialog, open it again by selecting Configure-->Activate License from the Launch menu, or by entering the following at a terminal prompt:

   /etc/qnx/bin/qnxactivate -a
     

8. Choose Activate Manually, and use the Load Response from File button to load the activate-response key, and then click Activate.

If you choose not to activate at the time of installation, you can activate later by selecting Configure-->Activate License from the Launch menu, or by entering the following at a terminal prompt:

/etc/qnx/bin/qnxactivate -a

Commercializing your evaluation software

If you installed an evaluation copy of QNX Momentics 6.3.2, and you've now received a commercial QNX License Certificate, do the following to add your commercial license:

1. Choose Programming-->QNX Momentics 6.3.2 Add License from the Applications menu, or type the following at a terminal prompt:

   /etc/qnx/bin/AddLicense.bin
     

   ---

   Graphical mode might not work on some Linux distributions. If you can't launch AddLicense.bin in graphical mode, type: /etc/qnx/bin/AddLicense.bin -console (Ref# 50483)

   ---

2. Enter the license-key information that's on your commercial QNX License Certificate.
3. Read the displayed End User License Agreement (EULA) and accept its terms if you wish to continue.

Uninstalling QNX Momentics

---

You should uninstall QNX products in the reverse order in which you installed them. To determine this order, use a command like this: ls -lt `find base_directory -name "*uninstall*.bin"` where base_directory is where you installed QNX Momentics.

---

To uninstall QNX Momentics, do the following:

1. Log in as root
2. Either:
   • Choose Programming-->QNX Momentics 6.3.2-->Uninstall from the Applications menu.

     Or:

   • Go to the base_directory/_uninstall/qnx632 directory (see "Determining your base directory," below) and run:

     ./uninstaller.bin
       

3. Log out and back in again.

Determining your base directory

To determine the base directory for QNX Momentics, open a command shell and use the qconfig command. For example:

$ qconfig
QNX Installations

  Installation Name: QNX Momentics 6.3.2
            Version: 6.3.2
     Base Directory: /opt/qnx632/
           QNX_HOST: /opt/qnx632/host/linux/x86/
         QNX_TARGET: /opt/qnx632/target/qnx6/

The base directory in this example is /opt/qnx632/, but it could be different on your machine, depending on where you installed QNX Momentics.