`cl-installer`

Text-based QNX Software Installer (QSI)

Syntax:

cl-installer [options]

Options:

-b block_name: Execute the installer for the block_name OS version. This option applies only to Solaris, Windows, and Linux hosts.
-f: Restart the package filesystem, fs-pkg. This option applies only to QNX hosts.
-h: 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).
-q: 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.
-u: 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.

Description:

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:

A .qpr file
A CD-ROM with a /repository directory in its root
A local directory you open with an installer
A web repository (http:// or ftp://)
A repository reference (.qrm) file.

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

Instal software:

Browse and select repositories
Browse and select packages in repositories to install
Install packages.

Uninstal software:

View software that is installed on your machine
View files associated with installed packages
Uninstall packages.

Other installer tasks:

Manage installed software
View and restoring spilled files
Select items in a list.

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

i: install new software.
u: uninstall software already installed on your system.
m: view the main menu, which includes more advanced options.
?: view help.
q: 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:

# -- open a software repository.
l -- refresh the repositories list.
n -- add a new repository to the list.
f -- find all known repositories.

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:

s -- synchronize (refresh) the selected repository or repositories.
c -- close the selected repository or repositories.
i -- display information about the selected repository or repositories.
b -- bookmark the selected repository or repositories. Bookmarked repositories appear by default in the list of repositories when you start cl-installer.
u -- unbookmark the selected repository or repositories.

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:

d -- set display options. See below.
f pattern -- find all packages that contain a file that matches the pattern.
b -- bookmark the current repository (add it to the list of repositories displayed on startup).

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).

i -- install the selected package(s).
u -- uninstall the selected package(s), if installed on your machine.
l -- list the packages again.
a -- activate the selected package(s), if installed but not active.
s -- view status information about the selected package(s), such as package size, installed size, and install path.
f -- find all the files contained in the selected package(s) and list them.

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:

Topics mode -- a repository is displayed as a list of topics and subtopics. Open a topic using the traverse option to view the packages of that type contained in the repository.
Bundles mode -- bundle contents (packages) are shown individually, so that you can see the status of each package.
Vendors mode -- vendor names are added as a level in the topic tree. Packages are organized by their vendor.
New mode -- only new packages are displayed.

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.

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:

a -- apply the installation.
c -- cancel all selected actions.
d -- get details about pending actions.

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:

# -- select/deselect a package.
u -- uninstall software packages.

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:

i -- install the selected package, if it isn't installed.
u -- uninstall the selected package.
a -- activate the selected package, if it's installed but deactivated.
s -- display status information for the selected package(s).
f -- find all the files in the selected package(s), and display them.

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.

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:

Start the cl-installer.
Select the main menu command.
Select the show modified files command. It may take a while for the installer to generate a list of spilled files.
To restore files, you can do one of:
- Select an item number to restore, then select the apply command.
  Or:
- Select the all option to restore all spilled files.

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:

# -- toggle the selection for the item number.
+ -- select all elements.
- -- deselect all elements.
1 7 9 or 1,7,9 -- toggle the selection for elements 1, 7, and 9.
+ 1 7 9 or + 1,7,9 -- select elements 1, 7, and 9.
- 1 7 9 or - 1,7,9 -- deselect elements 1, 7, and 9.
+ text -- select all the elements that match the text pattern. For example + Ti matches "Tin", "Time" and "MyTin".
- text -- deselect all the elements that match the text pattern.