Troubleshooting Packages

On Photon OS, tdnf is the default package manager. The standard syntax for tdnf commands is the same as that for DNF and Yum:

tdnf [options] <command> [<arguments>...]

The main configuration files reside in /etc/tdnf/tdnf.conf. The repositories appear in /etc/yum.repos.d/ with .repo file extensions. For more information, see the Photon OS Administration Guide.

The cache files for data and metadata reside in /var/cache/tdnf. The local cache is populated with data from the repository:

ls -l /var/cache/tdnf/photon
	total 8
	drwxr-xr-x 2 root root 4096 May 18 22:52 repodata
	d-wxr----t 3 root root 4096 May  3 22:51 rpms

You can clear the cache to help troubleshoot a problem, but doing so might slow the performance of tdnf until the cache becomes repopulated with data. Cleaning the cache can remove stale information. Clear the cache as follows:

tdnf clean all
	Cleaning repos: photon photon-extras photon-updates 
	Cleaning up everything

Some tdnf commands can help you troubleshoot problems with packages:

  • makecache

    This command updates the cached binary metadata for all known repositories. You can run it after you clean the cache to make sure you are working with the latest repository data as you troubleshoot.


    tdnf makecache
            Refreshing metadata for: 'VMware Photon Linux 1.0(x86_64)Updates'
            Refreshing metadata for: 'VMware Photon Extras 1.0(x86_64)'
            Refreshing metadata for: 'VMware Photon Linux 1.0(x86_64)'
            Metadata cache created.
  • tdnf check-local

    This command resolves dependencies by using the local RPMs to help check RPMs for quality assurance before publishing them. To check RPMs with this command, you must create a local directory and place your RPMs in it. The command, which includes no options, takes the path to the local directory containing the RPMs as its argument. The command does not, however, recursively parse directories; it checks the RPMs only in the directory that you specify.

    For example, after creating a directory named /tmp/myrpms and placing your RPMs in it, you can run the following command to check them:

    tdnf check-local /tmp/myrpms
        ing all packages from: /tmp/myrpms
         10 packages
         completed without issues
  • tdnf provides

    This command finds the packages that provide the package that you supply as an argument. If you are used to a package name for another system, you can use tdnf provides to find the corresponding name of the package on Photon OS.


    tdnf provides docker
        r-1.11.0-1.ph1.x86_64 : Docker
            : photon
        r-1.11.0-1.ph1.x86_64 : Docker
            : @System
     For a file, you must provide the full path. Example: 
     tdnf provides /usr/include/stdio.h
         glibc-devel-2.22-8.ph1.x86_64 : Header files for glibc
         Repo     : photon
         glibc-devel-2.22-8.ph1.x86_64 : Header files for glibc
         Repo     : @System
     The following example shows you how to find the package that provides a pluggable authentication module, which you might need to find if the system is mishandling passwords. 

    tdnf provides /etc/pam.d/system-account shadow-4.2.1-7.ph1.x86_64 : Programs for handling passwords in a secure way Repo : photon shadow-4.2.1-8.ph1.x86_64 : Programs for handling passwords in a secure way Repo : photon-updates

    For more commands see the [Photon OS Administration Guide](../../administration-guide/).

If a package that is installed is not working, try re-installing it. Example:

tdnf reinstall shadow
	shadow 	x86_64 	4.2.1-7.ph1   3.85 M
Last modified March 24, 2021: big docs v4 cleanup (80869a1a7)