Skip to content

klik://troubleshooting

Sunday, 20 November 2005  |  pipitas

Another two section for the klik User's FAQ done today. This time "Troubleshooting" and "Tipps + Tricks". Enjoy.

Troubleshooting

Q: I got a dialog saying "Error while trying to run xmule". What does this mean? A: This could mean there was a network outage and the server providing the input files to the klik recipe could not be reached to download the ingredient packages.

Q: I get a message saying: "This package contains no application. klik can't handle it." -- What does this mean? A: You clicked on the name of a package that can not be used standalone, and therefor is not feasible for klik.

Q: Which package names are not feasible for klik? A: Examples for such packages are all libraries, or packages containing fonts or artwork.

Q: Why can't you remove those packages from the klik website which are not feasible for klik? A: We can. But it takes time. Do you want to help?

Q: I get a popup dialog telling me it is downloading a Debian package. But I am on SUSE, so I cancelled it! What gives?? A: Don't worry. The Debian package will be converted into a klik .cmg file. Most recipes are designed to use .debs as input. In general, these work just fine for SUSE.

Q: I get a popup dialog telling me it is downloading multiple RPMs. But I am on Debian, so I cancelled it! What gives?? A: Don't worry. The RPMs will be converted into a single .cmg file. Some recipes are just designed to use RPMs as input, because there was probably no equivalent .deb package available that was recent enough in its version.

Q: I read that klik uses a single file with a .cmg extension. Now I'm trying klik:/xyz and it pops up a dialog warning that it downloads a mixture of .debs, .rpms and .tgzs onto my sytem. No way! I cancelled the download. How do I get the single .cmg? A: The listed "mixture of .debs, .rpms and .tgzs" are only the input files to create the single .cmg file from. The .cmg will be created by your own system. The .cmg will contain the "ingredients.list" file for future reference.

Q: Doesn't the mixture of ".debs, .rpms and .tgzs" lead to problems when executing the .cmg? A: This is not ruled out for certain combinations of packages. We have however had some good experience with it. Our recipes try to avoid problems. Should problems occur, they can be fixed by modifying the recipe. The reason for potential problems is not the mixture of RPM and .deb per se -- those would rather be caused by "binary incompatibility" of the different packages. Binary incompatibility can also happen between 2 RPM packages.

Q: Is there a very quick and minimum download method to test if the klik client installations works in principle? A: Yes. Try "klik://xvier" first (0.4 MByte download, 0.37 MByte xvier.cmg file result). If that doesn't work, try "klik://xvier@scratch" (6.3 MByte download, 6.2 MByte xvier.cmg file result). The "@scratch" addition includes many more dependencies directly into the .cmg, without assuming them to be present on the klik client OS base system.

Q: Some klik applications do not terminate cleanly. I have some processes still running, and the mountpoint blocked. What can I do? A: First, check which mountpoint is occupied, using the "mount" command:

  mount
(this will tell you which mountpoints are occupied (f.e. "/tmp/app/1" or "/mnt/app/3"). Second, try to umount manually (as user, not as root):
  umount /tmp/app/1
  umount /mnt/app/3
(exact mountpoint depends on your local system). Third, find out which process(es) still use this mountpoint:
  lsof /tmp/app/1
Fourth, kill that process(es): kill <pid> Fifth, free the mountpoint:
  umount /tmp/app/1
Sixth, remove all remainders of the previous action:
  rm -rf /tmp/app/1

Tipps+Tricks

Q: Is there a way to discover the exact recipe which is used to construct a given application via the klik://application link? A: Yes. Run the klik client from the command line, with the "-x" switch. Interrupt the download once the first dialog pops up. Copy the last line (starting with "wget klik.atekon.de/client/install....") and modify it to not execute the recipe, but save it into a local file. (Replace the last dash, after "-O" with the recipe filename of your choice). More details are in Kurt Pfeifle's blog article.

Q: Is there a way to re-construct the recipe that was used to construct a finished .cmg file? A: No. Currently the recipe itself is not stored inside the .cmg file. But maybe it is a good idea. We will think about it.

Q: Is there a way to force the usage of the Kanotix recipe for kitty, instead of the SUSE-10.0 one? A: Yes. Try "klik://kitty@kanotix0504".

Q: Is there a way to include the maximum number of dependencies into a given recipe, say the one for xvier? A: Yes. Try "klik://xvier@scratch".

Q: Can I enforce other variations of a klik recipe, if the standard one does not work for my system? A: Yes. You can also try "klik://xvier@kanotix0504", "klik://xvier@multi" or "klik://xvier@breezy", or analogous for other application names instead of xvier.

Q: What does "klik://xvier@multi" do? A: It enforces the execution of the klik recipe that was designed to work for multiple klik client versions of Linux. Be aware that not all recipes do have variations per klik client OS.

Q: What does "klik://xvier@kanotix0504" do? A: It enforces the execution of the klik recipe that was designed for "Kanotix-2005-04", regardless what your actual klik client OS is. Be aware that not all recipes do have variations per klik client OS.

Next topics, maybe written tomorrow: Security, Roadmap, Howtos. Now done 80 out of 110 questions. I wonder how many more will arrive in my mailbox after I've dealt with them all.