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.
Example:
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 Checking all packages from: /tmp/myrpms Found 10 packages Check 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.Example:
tdnf provides docker docker-1.11.0-1.ph1.x86_64 : Docker Repo : photon docker-1.11.0-1.ph1.x86_64 : Docker Repo : @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.
If a package that is installed is not working, try re-installing it. Example:
```
tdnf reinstall shadow
Reinstalling:
shadow x86_64 4.2.1-7.ph1 3.85 M
```