Chapter 10: Troubleshooting UPS Product
Chapter 10: Troubleshooting UPS Product Installations
This chapter provides a few hints if things don't seem to work after installing a product.
- The 'setpath' package was part of the old Full Fermilab Unix Environment suite, which many newer installations do not include. Users can source /etc/profile or /etc/login (bash vs csh) to restore the "usual" path components instead of doing setup setpath.
- If you don't find a product that you expect to see on the FTP server, it could be that the product is flagged as belonging to a special category to which you don't have access (e.g., site-only and U.S.-only are two of the categories used on fnkits; see section 22.3.2 The Recognized Product Categories). You may need to try with a different userid. It is also possible, if not terribly likely, that the file's permissions are set incorrectly on the server.
- If the $PATH goes away, restore it by running:
- To print out diagnostic information about what might be wrong with the installation, run ups verify:
- Try setting up just the main product and none of its dependencies. This should help determine which file has the problem, the main one or a dependency. Use -j in the setup command:
- Print out verbose information using the -v option with setup:
- Check file permissions. Any scripts called by the table file must be both readable and executable. The product executable(s) must of course be executable. The product database files must be readable.
- To examine the temporary file that the setup command creates and sources, run the command:% ups setup upd v4_8_0 /var/tmp/fileOCfayf
- For most UPS commands, the -s option can be used to simulate the command (i.e., create the temporary file) without executing it. It also returns the path of the temporary file it created, for example:
- If home directories move or if older versions of products have been deleted, you might want to prevent execution of unsetup files prior to a subsequent setup. In this case, don't unsetup the product. Just setup the product again using -k:
This page last revised in May 2014