Microsoft Windows Hosts

This chapter includes the following:

• System requirements
• Installing QNX Momentics
• Activating QNX Momentics
• Important notes
• 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:

• Windows Vista
• Windows XP SP2
• Windows 2000 SP4

^a Windows Vista requires an additional 512 MB of available RAM.

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 install Neutrino in a partition on a Windows machine and later use Windows software to create another partition, you'll lose your Neutrino partition.

---

To install QNX Momentics 6.3.2, do the following:

1. Boot into Windows and log in as a user with system-administrator privileges.
2. Insert the QNX Momentics Windows Host CD. The installation should start automatically; if it doesn't, double-click momentics-6.3.2-nnnnnnnnnnnn-win32.exe (where nnnnnnnnnnnn is a build number), which you'll find in the root directory of the CD.

   ---

   Java's AWT and Swing aren't supported in 16-color mode; they require a minimum of 256 colors. If you get a message, "Unable to run in graphical mode," run the installer in console mode, by typing this in a DOS prompt window: drive:\momentics-6.3.2-nnnnnnnnnnnn-win32.exe -console where drive is the drive letter for your CD drive, and nnnnnnnnnnnn is the appropriate build number.

   ---

3. Follow the instructions provided by InstallShield.

   ---

   If you install 6.3.2 on a machine that already has 6.2.1, be sure to select "Yes" when prompted about upgrading the environment variables. Otherwise, you won't be able to install future releases. For more information, see "Important notes," below.

   ---

    

   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.

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

Your desktop should now include an icon for the QNX Momentics IDE.

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 the file:

   
   
   drive\Program Files\QNX Software Systems\license\activate_prompt_key.txt
     

   where drive is the name of the drive where you installed QNX Momentics. 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:

   
   
   drive\Program Files\QNX Software Systems\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 Programs-->QNX Momentics 6.3.2-->License Management-->Activate License from the Start menu, or by entering the following at the command prompt:

   
   
   drive\Program Files\QNX Software Systems\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 Programs-->QNX Momentics 6.3.2-->License Management-->Activate License from the Start menu, or by entering the following at the command prompt:

drive\Program Files\QNX Software Systems\bin\qnxactivate -a

where drive is the name of the drive where you installed QNX Momentics.

Important notes

• We provide two shells:
  • Bash shell (bash.exe)
  • Korn shell (ksh.exe)

  You'll find these executables under ${QNX_HOST}/usr/bin (e.g. C:\QNX632\host\win32\x86\usr\bin). You may want to create desktop shortcuts for these or other executables you'll use often.

• The QNX Momentics IDE shortcut has a working directory set to C:\QNX632 (or wherever you installed the software). Users who aren't system administrators might not have write access for this directory. You might want to change the shortcut so that it starts the IDE in a directory that nonadministrator users can write in.
• If you install 6.3.2 on a machine that already has 6.2.1, and you select "No" when prompted about upgrading the environment variables, you won't be able to install future releases. (Ref# 19585)

  Workaround: Do the following:

  1. Open %PROGRAMFILES%\QNX Software Systems\qconfig\qnx_momentics_development_suite_6.3.2.xml in a text editor.
  2. Edit the file so that <host> and <target> tags use the proper base directory. For example, if your <base> tag is <base>C:/QNX632</base>, then your <host> tag should be <host>C:/QNX632/host/win32/x86</host>, and your <target> tag should be <target>C:/QNX632/target/qnx6</target>.
  3. From the Start menu, choose All programs or Programs, then choose QNX Momentics 6.3.2-->Configuration.
  4. Switch your configuration either from 6.2.1 to 6.3.2, or from 6.3.2 to 6.2.1. Click OK.
  5. Repeat steps 3 and 4 to make sure that the environment is set correctly.
  6. Repeat steps 3 and 4 to set the configuration you really need (if applicable).
• On Windows, the QNX-provided echo.exe interprets the Windows \ separator as an escape character. As a result, environment variable settings won't work if you use \ as a path separator; use / instead. (Ref# 19924)
• If your PATH contains quotation marks, ln-w doesn't work properly. (Ref# 20046)
• Our recursive makefiles use the value of the NAME environment variable (if set) to name the resulting binary. This is too generic a variable to use for this purpose; if you have a NAME environment variable set on your system for some other purpose (e.g. your name or email address), its value will be used as the name of your binaries. (Ref# 29843)

  Workaround: Unset the NAME environment variable before you build any executables.

• When you install QNX Momentics, the installer sets the QNX_HOST and QNX_TARGET environment variables. If you want to install any additional products from our website, and you want to run the installer from the website instead of saving it on your machine, don't use a browser or shell that was open before you installed QNX Momentics. Such a browser or shell won't have those environment variables set, so the installer will think that you haven't installed QNX Momentics.

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 Programs-->QNX Momentics 6.3.2-->License Management-->Add License from the Start menu, or enter the following at the command prompt:

   drive\Program Files\QNX Software Systems\bin\AddLicense
     

   where drive is the name of the drive where you installed QNX Momentics.

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, open a bash shell and use a command like this: ls -lt `find base_directory -name "*uninstall*.exe"` where base_directory is where you installed QNX Momentics.

---

To uninstall QNX Momentics, do the following:

1. Log in as a user with system-administrator privileges.
2. Do one of the following:
   • Choose Programs-->QNX Momentics Development Suite 6.3.2-->Uninstall QNX Momentics Development Suite 6.3.2 from the Start menu.

     or:

   • Choose Add or Remove Programs from the Control Panel, select "QNX Momentics Development Suite 6.3.2," and then click the Remove button.

     or:

   • Go to the base_dir\_uninstall\qnx632 directory and run uninstaller.exe.
3. If you also have QNX Momentics 6.2.1 installed, restore the QNX Momentics folder from the Recycle Bin. This folder defines the entry in the Start menu for QNX Momentics 6.2.1.
4. Empty the Recycle Bin to delete anything that the uninstaller and cleanup utility moved there.
5. Log out and back in again.

---

In some cases, if you uninstall QNX Momentics, the Add or Remove Programs window still lists some BSPs, DDKs, and TDKs. Press F5 while in Add or Remove Programs to refresh the list and show what's actually installed.

---

Determining your base directory

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

C:\>qconfig
QNX Installations

  Installation Name: QNX Momentics 6.3.2
            Version: 6.3.2
     Base Directory: C:/QNX632/
           QNX_HOST: C:/QNX632/host/win32/x86/
         QNX_TARGET: C:/QNX632/target/qnx6/

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