bump up to release 0.28.5
[tools/mic.git] / doc / FAQ.rst
1 FAQ
2 ===
3
4 Q: When creating an image, MIC shows:
5    "Error <creator>: URLGrabber error: http://.../.../repos/oss/ia32/packages/repodata/repomd.xml"
6
7 A: Perhaps your network has some issues, or your proxy doesn't work.
8    Try another proxy or find out the network issue.
9
10 Q: MIC complains "ERROR: found 1 resolver problem, abort!"
11
12 A: This is not an issue of MIC, it's caused by the repo you used.
13    Make sure the packages in the repo you used have proper dependencies.
14
15 Q: I used '-A i586' to create an i586 image, but it showed
16    "nothing provided ....". What's wrong with it?
17
18 A: Use '-A i686'. i586 is lower than i686, so many packages will be missing
19    from the installation.
20
21 Q: Error shows: "uninstallable providers: somepackageA"
22
23 A: It's caused by the missing package in the repo. To find it out, modify the
24    "%packages" section with only one item 'somepackageA' in kickstart file,
25    then you can root cause what's the missing dependency.
26
27 Q: MIC shows in the log:
28    "file /usr/share/whatever conflicts between attempted installs of somepackageA and somepackageB"
29
30 A: There are conflicts between some packages in the repo you used, but this
31    is not an issue with MIC. Please make sure you are using a proper repo.
32
33 Q: Error shows: Command 'modprobe' is not available.
34
35 A: In some distributions, when you use sudo, the PATH variable will be changed
36    and you will lose some important paths. Run 'export PATH=/sbin:$PATH'
37    before running MIC.
38
39 Q: MIC lost some packages which are specified in '--includepkgs'/'--excludepkgs'
40
41 A: Assume you want to include/exclude some packages in one repo, you will use
42    '--includepkgs'/'--excludepkgs' option in the according repo command line,
43    but you should list these packages to %packages section too, otherwise they
44    will not take any effect.
45
46 Q: How does mic select packages? And how to set the priority of a repo?
47
48 A: In general, mic will select a higher version if two or more available in
49    all repos, if the version is the same, a higher release number is
50    prefferred. But if you assign a priority to one repo, mic will prefer to
51    select packages from the repo with higher priority, even in case a higher
52    version is available in the repo with a lower priority. Actually the
53    default priority for a repo is 99, the range of a repo priority is 1~99,
54    the larger number has the lower priority.
55    An example is given:
56      "repo --name=base --baseurl=http://whateverurl --prioirity=1"
57
58