Product Registry Problems

If you encounter installation or uninstallation problems that involve a corrupt productregistry file, you can sometimes use the Solaris^TM Product Registry Tool to locate and fix the problem.

Identifying and Fixing a Failed Installation

If some packages are not properly installed, you will have problems using the Sun Studio software. For example, if you used the pkgadd command to install the software, you have corrupted the productregistry file. To verify whether all packages are installed properly, follow these instructions.

Verifying Whether All Packages are Installed Properly

1. Become a superuser (root) by typing:

   su Password: root-password

2. Open the Solaris Product Registry tool by typing:

   /usr/bin/prodreg &

3. In the left column of the tool, look at the list under the heading Registered Software.

   If a yellow triangle appears adjacent to the product name, then the product is not installed properly.

4. Select the product name and click the Uninstall button. The Uninstall Failed dialog box opens.

5. Read the message in the box, and then click OK if you want to uninstall the product.

   The Interactive Uninstall dialog box opens.

6. Follow the instructions in the subsequent dialog boxes until uninstallation is complete.

   Once the uninstallation is complete, you can reinstall the product software using the product installer. See the Sun Studio 12 Quick Installation (English, Japanese, Simplified Chinese) guide for product installation instructions.

7. Exit from superuser privileges by typing:

   exit

Fixing a Failed Uninstallation

If the uninstaller quits before all the product files are deleted, rerunning the uninstaller will not delete the remaining product files. The product files have been marked as deleted in the productregistry file, so the uninstaller does not remove the remaining files. To completely remove the product files, use the Solaris Product Registry tool, as described in the following procedure:

Removing the Product Files with the Solaris Product Registry Tool

1. Become a superuser (root) by typing:

   su Password: root-password

2. Open the Solaris Product Registry tool by typing:

   /usr/bin/prodreg &

3. In the left column of the tool, select all product names containing SS12 or Sun Studio 12 and click the Uninstall button.

   The Uninstall Failed dialog box opens.

4. Read the message in the box, and then click OK if you want to uninstall the product.

   The Interactive Uninstall dialog box opens.

5. Follow the instructions in the subsequent dialog boxes until uninstallation is complete.

   Once the uninstallation is complete, you can reinstall the product software using the product installer.

6. Exit from superuser privileges by typing:

   exit

What To Do If the productregistry File Is Corrupted

If you attempted to fix the failed installation or uninstallation by using the steps in “Identifying and Fix a Failed Installation" or “Fixing a Failed Uninstallation” and you are still having problems, you need to delete the corrupted productregistry file from your system. The productregistry file is typically corrupted if you attempt to install or uninstall the software using the pkgadd command or pkgrm command.

Deleting the productregistry file removes the entries for the Sun Studio 12 software and the registry entries for the Solaris Operating System (OS) and other products. Review the steps in “Identifying and Fix a Failed Installation" or “Fixing a Failed Uninstallation” before proceeding with the steps below.

Deleting a Corrupted Product Registry File

1. Become a superuser (root) by typing:

   su Password: root-password

2. Go to the productregistry file by typing:

   cd /var/sadm/install

3. Remove the productregistry file by typing:

   rm productregistry

4. Exit from superuser privileges by typing:

   exit