Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX Software Center Technotes

by

About These Technotes

About These Technotes

These technotes explain how to work around many issues with using the QNX Software Center.

What's in this guide?

This guide explains QNX Software Center issues that may occur with common workstation and network setups. It doesn't discuss issues related to a particular release of the product; these are explained in the Release Notes for the version you're using. If you encounter issues beyond what's described in the Release Notes, you can consult this guide for information about issues that require advanced manual steps and extra configuration.

To set up and use the product, you should read and follow the steps in the Installation Note and the QNX Software Center User's Guide.

If you encounter an issue that requires manual steps that aren't explained here but that you feel should be covered in these technotes, contact your sales representative or QNX Technical Support.

Which QNX Software Center version should I use?

We always recommend using the latest version of QNX Software Center. To determine which version you're using, launch the product and select Help > About. The version is listed in the window that appears. To see what's the latest version available, go to the QNX Download Center, select QNX Software Center, and log in to your myQNX account. The resulting page provides a link to download the latest version of the product, and this link lists the version and build numbers.

What issues are covered?

To find out about: See:
Fixing problems in downloading and installing packages Addressing Common Connection and Package Installation Issues
Fixing proxy server connection and myQNX login issues Addressing Proxy Server Issues

Addressing Common Connection and Package Installation Issues

You may encounter issues when trying to download and install software packages.

The following topics describe the symptoms, reasons, and fixes for various QNX Software Center failures related to package installation. There are two kinds of fixes: workarounds, which are temporary fixes that avoid the problem, and solutions, which are permanent fixes. Sometimes there are workarounds or solutions for the specific underlying problem, but other times you need to try the general workarounds given at the end.

Cannot connect to the server

Symptoms:
  • The QNX Software Center client seems to be hanging with Connecting progress at 10%.
  • The client displays an error message saying it can't contact the server:
    Screenshot of error window containing a message beginning with "The QNX Software Center cannot contact the server"
Note: In this chapter, when we refer to “the server”, we mean the myQNX server, which is the most used one of several server processes that the QNX Software Center client interacts with.
Reasons:
  1. Your internet connection is down.

    Solution: Check your network setup. The connection could be broken due to an HTTP proxy server. If you think that the network you're using has such a server, see Addressing Proxy Server Issues for steps on providing the proxy server's address to QNX Software Center.

    If connecting still isn't possible, use offline mode to install the packages.

  2. The proxy server is configured in QNX Software Center but access to qnx.com is blocked.

    Solution: The IT administrator has to enable access to qnx.com and fusion.qnx.com (which is on a different subnet), by adding their IP addresses and subnet masks to the proxy server whitelist.

  3. If your network has an HTTP proxy or is just slow, you may have hit the client read timeout.

    To confirm this, search for java.net.SocketTimeoutException: Read timed out in the latest session log file. If you don't find this string, see the other possible causes.

    Workaround: Open qnxsoftwarecenter.ini, which is found in the root directory of your installation, in an editor and add as the last line:
    -Dswupdate.http.socketTimeoutMillis=60000
  4. Your QNX Software Center client may be out of memory.

    To verify this, open the log file for the latest use session (~/.qnx/swupdate/qnxsoftwarecenter-0.log) in an editor. In the file, search for java.lang.OutOfMemoryError: Java heap space. If you don't find this string, see the other possible causes.

    Workaround:
    1. Open qnxsoftwarecenter.ini in an editor and change:
      -Xmx1024m
      to
      -Xmx2048m
    2. Restart the software.

    If you find that the client is still hanging or saying it can't connect to the server, you can further increase the heap size (e.g., to 4096 MB).

Cannot obtain authorization

Symptom: The QNX Software Center client displays an error message stating that the user isn't authorized to perform the operation.

Reasons:
  • Your myQNX account is suspended. This happens if your account was inactive for a year.

    Solution: Contact QNX Technical Support to restore your account.

  • Your account password has non-alphanumeric characters. Note that our current rules enforce the use of such characters; this happens only with old accounts.

    Solution: Change your myQNX password to contain only letters and numbers.

  • Your account credentials are registered with different capitalization.

    Solution: This bug occurs in QNX Software Center 1.x. Install version 2.0, which ignores differences in capitalization when you enter your myQNX account credentials.

  • You updated your account password but the stored password wasn't updated so it no longer matches.

    Solution: Remove the stored password through the QNX Software Center preferences. For instructions on doing so, see the “Manage secure storage of your myQNX credentials” section in the QNX Software Center Developer's Guide.

Cannot obtain or activate license key

Remote activation fails

Symptom: The client displays an error message stating that it failed to activate the license key:
Screenshot of error window containing a message containing "Your activation extensions have now been exceeded"

Reason: The number of activations has been exceeded.

Workaround: Make sure you're not purposely activating the same license on multiple hosts (because it's not allowed). You can deactivate the license manually on the QNX website: https://www.qnx.com/account/product_de-activation.html.

License isn't assigned

Symptom: The required license key isn't shown in the License tab.

Reason: The required license key isn't assigned to you.

Solution: Log into your myQNX account and check whether the license key is assigned to you; ask the license administrator to assign it if need be. If you're an administrator, you still have to assign a license key to yourself to use it. If the key is assigned but you still don't see it, contact QNX Technical Support.

License registration is incomplete

Symptoms:
  • The required license key isn't shown in the License tab.
  • No available packages are shown.

Reason: Your license registration is incomplete. Your account may be in an incorrect state if you didn't download QNX Software Center from the QNX website.

Solution: Log into the QNX website and agree to the EULA to complete the registration.

Remote activation fails due to unsupported proxy

Symptom: The client displays an error stating that it can't access the server.

Reason: Even if the QNX Software Center proxy configuration works and the client can retrieve packages, remote activation may fail because the activation code supports only certain proxy types. For the list of supported HTTP proxies, see Configuring proxy servers.

Workaround: Use manual activation.

Manual activation appears to fail

Symptom: After you do manual activation, the QNX Software Center client displays an error saying that it failed.

Reason: It appears that manual activation failed (because of the error display), but it might have succeeded. This is a known issue.

Workaround: Check the license status:
  1. In the Licenses tab, right-click the license for the product you're trying to activate, then choose Properties from the context menu.
  2. Examine the Status field. If it's Activated, no further action is required. Otherwise, contact QNX Technical Support.

Cannot access packages

No packages are displayed or can be accessed

Symptom: The client can't access or doesn't show any packages.

Reasons:

A package can't be accessed

Symptom: The client can't access a specific package.

Reasons:
  • You haven't been assigned a license key. For details, see License isn't assigned.
  • No support plan has been registered.
  • You are not entitled for the package.

    Solution: Contact QNX Technical Support if you think it's a mistake.

  • The package is experimental and the installation is configured to hide experimental packages.

    Solution: Contact your QNX license manager or QNX Technical Support.

  • The package is a debug symbol package. Since version 1.2.1, debug packages are invisible. To install debug symbols for a package, right-click its entry in the Installed tab and select Install Debug Package from the context menu.
  • The package is invisible. Since version 1.2.1, packages of the “component” type are invisible on the Available tab (to unclutter the view).
  • The package is architecture-specific and the installation is configured for a different platform.

    Workaround: Go the Advanced tab, click Edit Installation Properties, and in the Target Architectures panel, ensure that the platform required for the package is checked (or all platforms are checked).

  • The package wasn't actually posted or there was an error during publishing.

    Solution: Contact QNX Technical Support.

No packages are displayed

Symptom: The client fails to display any packages and instead displays an error stating: An internal error occurred during : "Preparing operation..."

Reason: A bug in QNX Software Center server version 1.2 when the user session has expired.

Workaround: Restart QNX Software Center. To avoid this problem in the future, perform any package installations within 30 minutes of starting. Upgrade to version 1.2.1 to solve this problem permanently.

Cannot start installation

Baseline product can't be installed

Symptom: The QNX Software Center client hangs when you press Next to start installing the baseline product (QNX SDP), or there's an internal error when dealing with license activation.

Reason: If you're using version 1.1 or 1.2, this may caused by the license key bug.

Solution: Upgrade your QNX Software Center installation to version 1.2.1 or later.

Packages in dependency chain are inaccessible

Symptom: The client shows an error stating: Cannot complete the install because one or more required items could not be found

Reason: One or more packages in the dependency chain are inaccessible. For more information, see the section about not being able to access a specific package.

Filter is not applicable

Symptom: The client shows an error stating: Cannot complete the install because some dependencies are not satisfiable... cannot be installed in this environment because its filter is not applicable

Reason: You enabled the setting for showing invisible packages and attempted to install packages not intended for this installation, which can include:
  • Experimental packages in a stable installation
  • Debug symbol packages in a non-debug installation
  • Host-specific packages for another platform (e.g., Windows tools on Linux)
  • Group patches when patching is disabled

Conflicting dependency

Symptom: The client shows an error stating: Cannot complete the install because of a conflicting dependency... Only one of the following can be installed at once

Reason: You're trying to update packages that are in a locked group such as a locked patchset or a locked parent group.

Workaround: To install the update on top of a locked patchset, uninstall the patchset package first (to unlock the other packages).

Cannot finish installation

Symptoms:
  • The QNX Software Center client displays an error message saying that it can't find the items to be installed:
    Screenshot of error window containing a message beginning with "An error occurred while collecting items to be installed
  • The client displays an error message saying that it can't validate a package:
    Screenshot of error window containing a message ending with "Error while validating package"
Reasons:
  1. The HTTP proxy server in your network prevents access to the server where the packages are kept.

    To confirm this, in the latest session log file, search for HTTP 403 error codes. If you don't find them, see the other possible causes.

    Solution: If do you find these error codes, you must address the network connectivity issues.

  2. Your login session has expired. This happens if QNX Software Center is idle for more than 30 minutes.

    Workaround: Clear the package cache and repeat the operation. Upgrade to version 1.2.1 to solve this problem for good.

  3. The packages can't be saved and retrieved successfully on your workstation.
    The possible reasons include:
    • Your workstation is out of disk space.

      Workaround: Ensure there's enough space in your home directory, possibly by relocating the package storage to another disk (if need be, contact QNX Technical Support for details).

    • Although rare, your anti-virus software might be interferring with packages being saved or read.

      Workaround: Check the anti-virus software logs and reconfigure the software to not interfere. If related log entries are found, clear the package cache.

    • Although rare, it's possible that you have disk errors that are causing package corruption.

      Workaround: Run disk-checking software and reboot the machine.

    • You're experiencing permissions issues. This can happen if you previously installed or ran the QNX Software Center client as root but now are running not as root.

      Solution: Remove and reinstall your product, as explained in Performing a complete wipe.

  4. The download operation is timing out.

    To confirm this, in the latest session log file (~/.qnx/swupdate/qnxsoftwarecenter-0.log), search for java.net.SocketTimeoutException: Read timed out. If you don't find this string, see the other possible causes.

    Workaround: Open qnxsoftwarecenter.ini, which is found in the root directory of your installation, in an editor and add as the last line:
    -Dswupdate.http.socketTimeoutMillis=60000
  5. The software package is posted with errors.

    Workaround: Try the general workarounds stated below, including contacting QNX Technical Support if necessary.

General workarounds

Clearing the package cache

Currently, you must do this if a download error occurs (i.e., a Check Trust error, Package Checksum error, or Download error). You can also do this to clear disk space.
  1. Exit QNX Software Center.
  2. Remove the cache directory (~/.qnx/swupdate/cache).
  3. Restart the software.

Clearing your cached myQNX credentials

If you use the secure storage feature, you may occasionally need to delete and reset the storage record, either because your myQNX credentials have changed or because the storage mechanism remembers the wrong credentials. To reset the secure storage record:
  1. Select Window > Preferences and then in the resulting window, select Security > Secure Storage.
  2. Click the Contents tab, select Default Secure Storage, then click Delete.
  3. When prompted, click Yes to restart the QNX Software Center.
  4. When prompted, enter your myQNX credentials, then click Save password to disk if you want to create a new storage record for the credentials.

The Secure Storage dialog contains other settings but you rarely need to use them. They're provided mostly for troubleshooting and somewhat for use by system administrators and power users.

Installing packages in offline mode

If your QNX Software Center client can't connect to the server, you can perform offline installation. Before trying this, ensure you have:
  • An existing baseline (QNX SDP) installation; this also can be installed offline
  • A valid and activated QNX SDP license; the activation can be done offline also
To install packages offline:
  1. Obtain the necessary packages by downloading them from the QNX website: http://www.qnx.com/download/group.html?programid=30107.
  2. Start (or restart) the QNX Software Center client. When it displays a dialog box saying that it can't connect to the server, click Work Offline.
  3. On the Welcome page, click Import and Install Offline Packages. Or, choose File > Import. Either action launches the File Import Wizard.
  4. Follow the instructions in the wizard to install the packages. Note that you may have to select multiple packages to resolve any interpackage dependencies.

For details about this mode, see the “Work offline” section in the QNX Software Center User's Guide.

Installing packages offline without QNX Software Center

If you still have installation problems using offline mode but you really need to install some packages, you can manually obtain and unpack them on your development host. To do so:
  1. Obtain the packages by other means (e.g., a QNX contact person). Note that group packages have no payload; you need to obtain all of their children.
  2. On your host, navigate to the root directory of the QNX SDP installation; for example:
    cd ~/qnx700
  3. Untar the package; for example:
    tar xvf aaa.qpkg
    Don't add the z option to the tar command.

Performing a complete wipe

The first time you try wiping the QNX products from your host development system, you may want to skip the optional steps (to see if the simpler procedure fixes your problems). If the usability issues persist, you can then try an in-depth wipe by doing all of the steps.

  1. Remove all baseline (QNX SDP) installations by going to the Advanced tab and for each installation:
    1. Select it in the top-right dropdown shown next to the gear icon.
    2. Click Remove Installation in the bottom right corner.
    3. Click OK at the confirmation prompt and wait for QNX Software Center to remove the baseline installation (this can take a couple of minutes).
  2. Deactivate all of your licenses by going to the Licenses tab, selecting all licenses in the list, then clicking Deactivate in the bottom right corner (and Yes at the confirmation).
  3. Exit the software by selecting File > Exit.
  4. Optional: Uninstall QNX Software Center using the uninstaller located in the installation directory, then reinstall the software by downloading the latest version from our website.
  5. Remove the software update directory (~/.qnx/swupdate/).
  6. Optional: Remove the Eclipse secure storage directory (~/.eclipse). The QNX Software Center and QNX Momentics IDE use this for storing passwords and other permanent settings. Note that this directory's location is platform-dependent; to learn its location:
    1. Open QNX Software Center and select Window > Preferences.
    2. In the left-side navigation, select Security > Secure Storage.
    3. Click the Contents tab. The secure storage directory is listed at the bottom.
  7. Optional: Remove any detached installations. An installation of QNX SDP 7.0 or another QNX product is detached if the QNX Software Center doesn't see it. In this case, you must manually uninstall it and remove its folder from the filesystem.
  8. Restart QNX Software Center (if you haven't already) and try reinstalling the baseline product and any packages you need.

Contacting QNX Technical Support

When contacting QNX Technical Support, have the following information ready:
  • The log file for the latest use session (this is the same file described in Cannot connect to the server)
  • What version of QNX Software Center you're using
  • What workstation architecture and OS you're using
  • What type of license key arrangement you have
  • Whether your organization uses proxy servers or outbound firewalls
  • Whether this issue occurs with other users

Addressing Proxy Server Issues

If your company uses an HTTP proxy server to control internet access, the QNX Software Center can usually detect it automatically and communicate with the necessary QNX servers upstream of the proxy server. Sometimes, though, you have to manually configure the proxy server or provide proxy credentials. The procedures given here help you address these and other connectivity problems.

Communication with server processes

The QNX Software Center communicates with the following server processes:
myQNX server, hosted on www.qnx.com
The QNX Software Center queries this server to discover and download available packages.
QNX license server, hosted on www.qnx.com
This server is queried to discover any licenses the user might have, and to remotely activate or deactivate those licenses.
Floating license server installed in end-user's local network (optional)
This server is used only by customers who have floating licenses.

All communications with the myQNX server and the QNX license server occur over HTTP and can be mediated through an HTTP proxy server. The floating license server, however, uses a proprietary protocol that isn't affected by proxy servers—it works only over direct connections.

Dealing with bad connection attempts to myQNX server

When the QNX Software Center starts up, it attempts to connect to the myQNX server. If it can't, it will eventually time out and display an error dialog. If this happens, follow these steps:
  1. Make sure your workstation is connected to the internet.
  2. Try accessing www.qnx.com from your workstation web browser. If that fails, ask your IT department to give you access to our website, either directly or through a proxy server.
  3. If you're using a macOS host, configure the QNX Software Center to use the same proxy settings as your web browser, as explained in Manually configuring proxy settings.
  4. If the QNX Software Center prompts you for proxy server credentials, follow the steps in Entering proxy credentials.
Note: When the QNX Software Center prompts you to log in to myQNX, you must use the same credentials as when logging in to https://www.qnx.com/account/login.html. If you can log in to this site through a web browser then you can log in through the QNX Software Center.

There's an issue in version 1.0 that prevents you from using uppercase characters in your login credentials. So, always enter your login name in all lowercase characters; for instance, use myusername@mycompany.com, not MyUserName@mycompany.com.

Where to find the log file with networking information

The QNX Software Center creates a log file that QNX support staff can use to diagnose networking issues. You can find this file at ~/.qnx/swupdate/.metadata/.log.

Configuring proxy servers

The QNX Software Center usually picks up proxy settings automatically. However, some proxy-OS combinations can be problematic. In particular, on macOS, you need to configure the proxy settings manually.

HTTP proxy support

The following table shows the type of HTTP proxies supported for each host OS and when to perform manual configuration or use the default native (OS) settings:
OS No proxy Unauthenticated proxy Basic proxy1 Digest proxy1 2 NTLM proxy1 2 Kerberos, Negotiate proxy SOCKS proxy
Windows Native Native Native Native Native Not supported Not supported
Linux Native Native Native Native Native Not supported Not supported
macOS Native Manual Manual Manual Manual Not supported Not supported
1 The QNX Software Center can't detect your proxy server credentials; it will prompt you to enter them each time it starts.
2 The QNX Software Center can't communicate with the QNX license server over proxies that use Digest or NTLM; you must therefore activate products manually (for details, see the QNX Software Center User's Guide).

Manually configuring proxy settings

In general, you shouldn't attempt to manually configure the proxy settings, because usually the default settings picked up from the OS work. However, on macOS, you need to enter the settings manually. On any host OS, you may need to experiment with manual settings when troubleshooting proxy connection issues.

To configure proxy settings manually:
  1. Select Window > Preferences, then click Proxy Connections on the left of the resulting window:
    Screenshot of Preferences window showing Proxy Connections fields for configuring proxy type and server locations

    Note: The SOCKS option is available but not supported.
  2. Under HTTP/HTTPS settings, uncheck Use System Settings.
  3. In the HTTPS Proxy text field, enter your proxy address using the format proxyhost:proxyport.
  4. Click Test Connection to verify that you can connect to the myQNX server. You may be prompted for proxy credentials and may expect the check to take a few seconds. Information on providing these credentials is given in the next section.
  5. Click OK to apply your changes and exit the window.

Entering proxy credentials

If your host is downstream of an authenticated HTTP proxy server, when the QNX Software Center attempts to connect to the myQNX server, you'll see the Proxy Authentication window. This window asks for proxy credentials, and indicates what type of authentication your proxy is requesting, such as Basic, Digest, or NTLM.

Screenshot of Proxy Authentication dialog

If you see this window, enter the proxy credentials for the HTTP proxy server in your corporate network; these are the same credentials that your browser uses to connect to internet sites.

Note: Don't supply your myQNX credentials at this point! If you enter the correct proxy credentials here, the QNX Software Center will subsequently prompt you for your myQNX credentials.

Determining your proxy credentials

You can enter the same proxy credentials used by your desktop browser, but it isn't always obvious what those credentials are. That's because web browsers and other HTTP applications often supply the proxy username and password automatically.

In many corporate networks, the HTTP proxy server is integrated with the corporate network login mechanism. So, when prompted for your proxy credentials, try using your normal network username and password; for instance, your domain username and password on a Windows network. If you can't guess your credentials, contact your IT department.

Curl is a good tool for testing your connection, using the options --proxy, --proxy-user, and possibly --proxy-basic, --proxy-digest, or --proxy-ntlm. For example, if your proxy server is running on a host named webproxy and on port 3128, and your credentials are mylogin:mypasswd, you can test your connection through the proxy to www.qnx.com with the following command:
> curl --proxy webproxy:3128 --proxy-basic --proxy-user mylogin:mypasswd http://www.qnx.com

Resetting proxy server settings

If you want to reset the proxy settings used by the QNX Software Center to their defaults, you can delete the following file:
  • On Linux: ~/qnx/qnxsoftwarecenter/configuration/.settings/org.eclipse.core.net.prefs
  • On macOS: ~/Applications/QNX Software Center.app\Contents\Eclipse\configuration\.settings\org.eclipse.core.net.prefs
  • On Windows: \QNX\QNX Software Center\configuration\.settings\org.eclipse.core.net.prefs