aboutsummaryrefslogtreecommitdiffstats
path: root/docs/mcc-help/en/drakrpm-edit-media.xml
blob: 7a21330753e85fe4469ea6e0a3880a53aee2c06d (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
<?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 -->

  <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 (as
      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>Your system is running under an architecture than may be 32-bit
      called i586, or 64-bit called x86_64. Take care to choose repositories
      that suit your system or are not dependent of the architecture, these
      are called noarch packages.</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 contains only sure and well tested software. Clicking on the
    add button opens a pop up window giving the choices of installing the
    "Update sources only" or the "Full set of sources". The first choice the
    essential, the second is more useful.</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 found package
    (for a same release number, if not, the last release will be installed).
    So if possible, place the fastest repositories on 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>
  </section>
</section>