aboutsummaryrefslogtreecommitdiffstats
path: root/docs/mcc-help/en/drakrpm-edit-media.xml
blob: 7ea5ecdf6454739f442789b5c980f5d6558484ba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
<?xml version='1.0' encoding='utf-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns="http://docbook.org/ns/docbook" version="5.0" xml:id="drakrpm-edit-media">
  <info>
    <title xml:id="drakrpm-edit-media-ti1">Configure Media</title>

    <subtitle>drakrpm-edit-media</subtitle>
  </info>

  <!-- 2013-01-06 marja - added Qilaq's and spturtle's corrections -->

  <!--2013-10-22 marja - improved wording, thanks to Aragorn :-) 
                       - adjusted "Add" part to changed behaviour of this tool
		       (no longer a choice to only add "update sources" is
		       given) -->

  <mediaobject>
    <imageobject>
      <imagedata xml:id="drakrpm-edit-media-im1" fileref="drakrpm-edit-media.png" revision="1" align="center" format="PNG"/>
    </imageobject>
  </mediaobject>

  <para><important>
      <para>First thing to do after an install is to add software sources
      (also known as repositories, media, mirrors). That means you must select
      the media sources to be used to install and update packages and
      applications. (see Add button below).</para>
    </important> <note>
      <para>If you install (or upgrade) Mageia using an optical media (DVD or
      CD) or a USB device, there will be a software source configured to the
      optical media used. To avoid being asked to insert the media when you
      install new packages, you should disable (or delete) this media.  (It
      will have the media type CD-Rom).</para>
    </note> <note>
      <para>Your system is running under an architecture which may be 32-bit
      (called i586), or 64-bit (called x86_64). Some packages are independent
      of whether your system is 32-bit or 64-bit; these are called noarch
      packages. They don't have their own noarch directories on the mirrors,
      but are all in both the i586 and the x86_64 media.</para>
    </note></para>

  <para>This tool is present in the Mageia Control Center under the tab
  <emphasis role="bold">Software management.</emphasis><footnote>
      <para>You can start this tool from the command line, by typing <emphasis role="bold">drakrpm-edit-media</emphasis> as root.</para>
    </footnote></para>

  <section>
    <title xml:id="drakrpm-edit-media-columns">The columns</title>

    <bridgehead>Column Enable:</bridgehead>

    <para>The checked media will be used to install new packages. Be cautious
    with some media such as Testing and Debug, they could make your system
    unusable.</para>

    <bridgehead>Column Update:</bridgehead>

    <para>The checked media will be used to update packages, it must be
    enabled. Only media with "Update" in its name should be selected. For
    security reasons, this column isn't modifiable in this tool, you must open
    a console as root and type <emphasis role="bold">drakrpm-edit-media
    --expert.</emphasis></para>

    <bridgehead>Column medium:</bridgehead>

    <para>Display the medium name. Mageia official repositories for final
    release versions contain at least:</para>

    <itemizedlist>
      <listitem>
        <para><emphasis role="bold">Core</emphasis> which contains most
        programs available supported by Mageia.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Nonfree</emphasis> which contains some
        programs which are not free</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Tainted</emphasis> free software for which
        there might be patent claims in some countries.</para>

        <para>Each medium has 4 sub-sections:</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Release</emphasis> the packages as of the
        day the this version of Mageia was released.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Updates</emphasis> the packages updated
        since release due to security or bug concerns. Everyone should have
        this medium enabled, even with a very slow internet connection.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Backports</emphasis> some packages of new
        versions backported from Cauldron (the next version under
        development).</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Testing</emphasis> which is used for
        temporary tests of new updates, to allow the bug reporters and the QA
        team to validate the corrections.</para>
      </listitem>
    </itemizedlist>
  </section>

  <section>
    <title xml:id="drakrpm-edit-media-right-button">The buttons on the
    right</title>

    <para><guibutton>Remove:</guibutton></para>

    <para>To remove a medium, click on it and then on this button. It is wise
    to remove the medium used for the installation (CD or DVD for example)
    since all the packages it contains are in the official Core release
    medium.</para>

    <para><guibutton>Edit:</guibutton></para>

    <para>Allows you to modify the selected medium settings, (URL, downloader
    and proxy).</para>

    <para><guibutton>Add:</guibutton></para>

    <para>Add the official repositories available on the Internet. These
    repositories contain only safe and well tested software. Clicking on the
    "Add" button adds the mirrorlist to your configuration, it is designed to
    make sure that you install and update from a mirror close to you. If you
    prefer to choose a specific mirror, then add it by choosing "Add a
    specific media mirror" from the drop-down "File" menu.</para>

    <para><guibutton>Up and down arrows:</guibutton></para>

    <para>Change the list order. When Drakrpm looks for a package, it reads
    the list in the displayed order and will install the first package found
    for the same release number - in the event of a version mismatch, the
    latest release will be installed. So if possible, put the fastest
    repositories at the top.</para>
  </section>

  <section>
    <title xml:id="drakrpm-edit-media-menu">The menu</title>

    <para><guimenu>File -> Update:</guimenu></para>

    <para>A window pops up with the media list. Select the ones you want to
    update and click on the <guibutton>Update</guibutton> button.</para>

    <para><guimenu>File -> Add a specific media mirror:</guimenu></para>

    <para>Suppose you aren't happy with the actual mirror, because for example
    it's too slow or often unavailable, you can choose another mirror. Select
    all the actual media and click on <guibutton>Remove</guibutton> to take
    them out. Click on <guimenu>File -> Add a specific media
    mirror</guimenu>, choose between update only or the full set (if you do
    not know, choose the <guibutton>Full set of sources</guibutton>) and
    accept the contact by clicking on <guibutton>Yes</guibutton>. This window
    opens:</para>

    <mediaobject>
      <imageobject>
        <imagedata fileref="drakrpmEditMedia2.png"/>
      </imageobject>
    </mediaobject>

    <para>You can see, on the left, a list of countries, choose yours or one
    very close by clicking on the > symbol, this will display all the
    available mirrors in that country. Select one and click on
    <guibutton>OK</guibutton>.</para>

    <para><guimenu>File -> Add a custom medium:</guimenu></para>

    <para>It is possible to install a new media (from a third party for
    example) that isn't supported by Mageia. A new window appears:</para>

    <para><mediaobject>
        <imageobject>
          <imagedata fileref="rpmdrakeEditMedia1.png"/>
        </imageobject>
      </mediaobject>Select the medium type, find a smart name that well define
    the medium and give the URL (or the path, according to the medium
    type)</para>

    <para><guimenu>Options -> Global options:</guimenu></para>

    <para>This item allows you to choose when to "Verify RPMs to be installed"
    (always or never), the download program (curl, wget or aria2) and to
    define the download policy for information about the packages (on demand
    -by default-, update only, always or never).</para>

    <para><guimenu>Options -> Manage keys:</guimenu></para>

    <para>To guarantee a high level of security, digital keys are used to
    authenticate the media. It is possible for each medium to allow or
    disallow a key. In the window that appear, select a medium and then click
    on <guibutton>Add</guibutton> to allow a new key or to select a key and
    click on <guibutton>Remove</guibutton> to disallow that key.</para>

    <para><warning>
        <para>Do this with care, as with all security-related questions</para>
      </warning><guimenu>Options -> Proxy:</guimenu></para>

    <para>If you need to use a proxy server for internet access, you can
    configure it here. You only need to give the <guibutton>Proxy
    hostname</guibutton> and if necessary a <guilabel>Username</guilabel> and
    <guilabel>Password</guilabel>.</para>

    <para/>

    <para>For more information about configuring the media, see <link ns2:href="https://wiki.mageia.org/en/Software_management">the Mageia
    Wiki page</link>.</para>
  </section>
</section>