[Previous] [Contents] [Index] [Next]


Text-based QNX Software Installer (QSI)


cl-installer [options]


-b block_name
Execute the installer for the block_name OS version. This option applies only to Solaris, Windows, and Linux hosts.
Restart the package filesystem, fs-pkg. This option applies only to QNX hosts.
Display help information.
-i repository | QPR_file
Install all packages from a repository or .qpr file.
-o repository | QPR_file
Open a repository or .qpr file.
-p address:port
Set the proxy server address and port (if you're connecting to a repository through a proxy server).
Install or uninstall packages without entering the interactive mode. You must also specify either the -i or -u option.
-s .QRS_script
Execute the given .qrs script file.
Uninstall packages that are currently installed.
-U username:password
Set the proxy server user name and password, used with the -p option.
-v level
Set the verbosity level, from 1 to 7.


The cl-installer utility is a text-based software installer. For a GUI-based installer, see qnxinstall.

Software for QNX Neutrino is packaged into packages, which are collections of libraries, binaries, and support files. One or more packages may be bundled into a product, which contains all the files required to run a piece of software. Products may be packaged together into a bundle. A repository is the location of one or more packages, products, and bundles. A repository can take several forms, including:

Using the cl-installer utility, you can perform these tasks:

Instal software:

Uninstal software:

Other installer tasks:

When you start the cl-installer, you're prompted to choose one of the following commands:

install new software.
uninstall software already installed on your system.
view the main menu, which includes more advanced options.
view help.
quit the installer.

Choose a command by pressing the letter associated with the command, or by typing in the whole command name or any portion of the command name starting with the first letter, and pressing Enter.

If you choose the install command, you can open software repositories and install new software packages, as well as updates and patches of the packages that you've installed already. If you choose the uninstall command, you can uninstall software that's already installed on your system.

If you choose the main menu, you can perform additional tasks, including managing installed software, viewing installed repositories, showing modified files, and setting user preferences.

At any time, you can choose quit to exit cl-installer, or help to get help. On most screens, you can select the return command to return to the previous screen.

Browsing Repositories

When you choose the install command, cl-installer displays a numbered list of all the remote software repositories you've previously bookmarked, and any CD-ROM repositories, if they exist.

The installer prompts you to choose one of the following commands:

To choose a repository that contains the software packages that you want to install, enter the number associated with that repository.

Once you select one or more repositories, you can choose from these additional commands:

Browsing Packages

By default, when you open a repository, you see all the packages it contains, and each package's status. You can change the way packages are displayed by setting the display options.

When you're viewing the contents of a repository, the command available depend on whether any packages are selected. If no packages are selected, you can select from:

Once you've selected one or more packages, you can see the following commands. Some commands might be disabled if they're not available for the selected package(s).

Display options

The display options let you change the way the installer displays the contents of a repository. You can toggle these options on or off:

If one or more of the display modes (topics mode, vendors mode, or bundles mode) is on, a topics tree is displayed when you open a repository. Otherwise a list of packages is displayed.

Note: You can view only a single topic category when topics mode or vendors mode is on. If you select multiple topics and use the traverse topic command, the first topic is opened.

To open a topic, enter its number and then use the traverse topic command until you see a list of packages.

Installing Packages

To install a package, enter the number associated with that package to select it, then enter the install command to tag it with the INSTALL flag. Finally, to confirm that you want to install the selected package(s), select proceed. At this point your options are:

To install all the software packages that you've tagged with the INSTALL tag, choose the apply command. You may be required to perform various tasks, such as accepting licenses. Follow the directions on the screen.

Once the installation is complete, the installer once again displays the numbered list of all the software packages that are available for installation, and the packages you've just installed are labelled ACTIVE or DEACTIVATED. You can then install more packages.

Uninstalling software

When you choose the uninstall command, cl-installer displays a numbered list of all the software packages that you've already installed on your system. By default, all uninstallable packages are tagged UNINSTALL for quick removal of all Neutrino software. You can remove the tage from all packages with the minus (-) command.

You can choose from one of the following commands:

To select a package that you want to uninstall, enter the number associated with that package. The installer tags that package with an UNINSTALL tag. Note that all the packages tagged with the UNINSTALL tag will be uninstalled, so if you decide that you don't want to uninstall a package, enter that package number again to make the installer remove the tag.

To uninstall all the software packages that have been tagged with the UNINSTALL tag, choose uninstall. The installer displays a list of packages that will be uninstalled. To confirm that this is what you want to do, select apply. Various user interactions may be required at this point. Follow the directions on the screen.

Once the uninstallation is complete, cl-installer once again displays the numbered list of all the software packages that you've already installed on your system, minus the packages you've just uninstalled. You can then uninstall more packages.

Managing installed software

You can manage installed software by selecting the manage command from the main menu. This menu gives you the following commands for selected packages:

Viewing and restoring spilled files

A spilled file is a file that has changed from the time it was originally installed on your machine by the installer. For example, if you add users to your system, the passwd utility adds a password to the /etc/passwd file. This file is spilled.

You can view a list of files that are spilled on your machine, and choose to restore them to their originally installed state.

Caution: Restoring a spilled file can result in data loss. In the example above, you would lose any user passwords if you restored the /etc/passwd file.

To view and restore spilled files:

  1. Start the cl-installer.
  2. Select the main menu command.
  3. Select the show modified files command. It may take a while for the installer to generate a list of spilled files.
  4. To restore files, you can do one of:

Selecting items in a list

When the installer displays items in a numbered list (repositories, topics, or packages) you can select items in several ways:

See also:

fs-pkg, pkgctl, qnxinstall

"Package filesystem" in the Working With Filesystems chapter of the User's Guide

[Previous] [Contents] [Index] [Next]