Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

QNX® Momentics® 6.3.0 Technology Development Kits Installation Note

QNX® Neutrino® RTOS

Date of this edition: November 23, 2007

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4, NT SP6a; Sun Solaris 7, 8, 9, or 10; QNX^® Neutrino^® 6.3.0 SP2; Linux Red Hat 8, 9, or Enterprise

For information about this TDK, see the release notes. For the latest version of these notes, go to our website (www.qnx.com), log into your myQNX account, and then go to the Download Center.

Contents...

Installing a TDK
Uninstalling a TDK
Documentation
Technical support

Installing a TDK

Before you install a TDK:

You must have already installed QNX Momentics 6.3 on a supported host.
Refer to its release notes to see if there are required patches that must be installed first.

If you have a legacy binary-update license key, you can't install the source components of a TDK.

Each Board Support Package, Driver Development Kit, Technology Development Kit, and Source Kit contains a standalone directory hierarchy. If you're installing more than one of these products, don't combine the directories, or you might overwrite some of the files.

On a Windows host

If you've installed QNX Momentics versions 6.2.1 and 6.3.0 so that they coexist on your Windows host, please note:

You can't install a 6.3.0 TDK or BSP when the active version is QNX Momentics 6.2.1; set your configuration to 6.3.0.
If you switch from 6.2.1 to 6.3.0, you may have to log out of your user session and log back in before installing 6.3.0 BSPs and TDKs.

Log in as a user with system-administrator privileges.
Log into your myQNX account on our website, and then go to the Download Center.

Download the appropriate TDK package; each package is in the form of an executable (.exe) file. The nnnnnnnnnnn in the filename is an 11-digit build number:

File	TDK
`tdk-cpm-1.0.1-`nnnnnnnnnnn`-win32.exe`	Critical Process Monitoring
`tdk-efsys-1.0.1-`nnnnnnnnnnn`-win32.exe`	Flash Filesystem & Embedding
`tdk-net-1.0.1-`nnnnnnnnnnn`-win32.exe`	Extended Networking
`tdk-smp-1.0.1-`nnnnnnnnnnn`-win32.exe`	Symmetric Multiprocessing
`tdk-mmedia-1.0.1-`nnnnnnnnnnn`-win32.exe`	Multimedia
`tdk-3d-1.0.1-`nnnnnnnnnnn`-win32.exe`	3D Graphics
`tdk-browser-1.0.1-`nnnnnnnnnnn`-win32.exe`	Web Browser

Double-click the file in Windows Explorer or run it at the command line.
Follow the instructions provided by InstallShield.

Windows XP SP2 may display a security warning the first time you install a TDK. You can verify the TDK's checksums when you download the file from your myQNX account.

On a Solaris or Linux host

Log in as root.
Log into your myQNX account on our website, and then go to the Download Center.

Download the appropriate TDK package; each package is in the form of a .bin script. The host in the filename is either solaris or linux, and the nnnnnnnnnnn is an 11-digit build number:

File	TDK
`tdk-cpm-1.0.1-`nnnnnnnnnnn-host`.bin`	Critical Process Monitoring
`tdk-efsys-1.0.1-`nnnnnnnnnnn-host`.bin`	Flash Filesystem & Embedding
`tdk-net-1.0.1-`nnnnnnnnnnn-host`.bin`	Extended Networking
`tdk-smp-1.0.1-`nnnnnnnnnnn-host`.bin`	Symmetric Multiprocessing
`tdk-mmedia-1.0.1-`nnnnnnnnnnn-host`.bin`	Multimedia
`tdk-3d-1.0.1-`nnnnnnnnnnn-host`.bin`	3D Graphics
`tdk-browser-1.0.1-`nnnnnnnnnnn`.bin`	Web Browser

Run chmod to make the script executable. For example:
```
chmod a+x tdk-smp-1.0.1-20041234567-solaris.bin
```

Run the script at the system prompt. For example:

$./tdk-smp-1.0.1-20041234567-linux.bin

The graphical installer doesn't work on some versions of Linux, such as Linux Red Hat EL Workstation 5. Run the installer in console mode instead:
```
$./tdk-smp-1.0.1-20041234567-linux.bin -console
```
If the installer prints many dots but never actually starts, it's looking for a suitable version of Java. You can speed this up by setting the JAVA_HOME variable. For example in the bash shell:
```
export JAVA_HOME=/path/to/java
  
```
or:
```
export JAVA_HOME=/usr/java/j2rel1.4.2_09
  
```

Follow the instructions provided by InstallShield.

On a QNX Neutrino host

Log in as root.
Log into your myQNX account on our website, and then go to the Download Center.

Download the appropriate TDK package; each package is in the form of a shell script. The nnnnnnnnnnn in the filename is an 11-digit build number:

File	TDK
`tdk-cpm-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Critical Process Monitoring
`tdk-efsys-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Flash Filesystem & Embedding
`tdk-net-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Extended Networking
`tdk-smp-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Symmetric Multiprocessing
`tdk-mmedia-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Multimedia
`tdk-3d-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	3D Graphics
`tdk-browser-1.0.1-`nnnnnnnnnnn`-qnx6.sh`	Web Browser

Run chmod to make the script executable. For example:
```
chmod a+x tdk-efsys-1.0.1-20041234567-qnx6.sh
```
Run the script at the system prompt. For example:
```
$./tdk-efsys-1.0.1-20041234567-qnx6.sh
```
Follow the instructions on your screen.

Uninstalling a TDK

On a Windows host

Log in as a user with system-administrator privileges.
Open the Control Panel (e.g. on Windows 200: Start-->Settings-->Control Panel).
Select Add or Remove Programs.
Select the TDK package you want to remove, then click the Remove button.

On a Solaris or Linux host

Log in as root.
Go to the $QNX_TARGET/_uninstall directory, then to the specific directory for the TDK you want to remove (e.g. Flash_Filesystem_and_Embedding_TDK).
Start the QNX InstallShield application:
```
./uninstaller.bin
```
InstallShield will now remove the TDK.

On a QNX Neutrino host

Log in as root.
Go to this directory:
$QNX_TARGET/install/tdk/tdkname
where tdkname is the name of the TDK (e.g. net for the Extended Networking TDK).
Run the uninstaller script:
```
./uninstall
```

Documentation

The functionality provided by all the TDKs is already described in the QNX Momentics documentation set.

The following table shows which specific parts of the documentation set relate to each TDK:

For this TDK:	See:
Critical Process Monitoring	High Availability Manager chapter of the System Architecture guide High Availability Toolkit Developer's Guide
Flash Filesystem & Embedding	Filesystems chapter of the System Architecture guide Working with Filesystems chapter of the Neutrino User's Guide Customizing the Flash Filesystem chapter of Building Embedded Systems `devf-*` entries in the Utilities Reference
Extended Networking	TCP/IP Networking chapter of the System Architecture guide TCP/IP Networking chapter of the Neutrino User's Guide `mrouted`, `named`, `racoon`, `route6d`, `setkey`, `snmp`, etc. in the Utilities Reference IPsec, IPv6 protocol pages (and their see-also references) in the Library Reference snmp_ entries in the Library Reference
Symmetric Multiprocessing	SMP chapter of the System Architecture guide Developing SMP Systems appendix of the Programmer's Guide
Multimedia	Multimedia Developer's Guide Multimedia Developer's Guide (Pre 6.2.1) (for legacy multimedia plugins)
3D Graphics	“glph” section (QNXGL Photon Extensions) of the Photon Library Reference “OpenGL” section of the Raw Drawing and Animation chapter of the Photon Programmer's Guide.
Web Browser	`netfront` and `voyager` entries in the Neutrino Utilities Reference `PtWebClient` in the Photon Widget Reference

Technical support

If you have any questions, comments, or problems with a QNX product, we recommend that you use our support forums available from our news server, news://inn.qnx.com.

Since QNX developers and support staff frequent our newsgroups, you should find them to be your best avenue of support for solving problems.