aboutsummaryrefslogtreecommitdiffstats
path: root/docs/docs/stable/mcc-help/hi/drakrpm-edit-media.xml
blob: e9356da55339824ef2a8c55c980ec0e428f32863 (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
<?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:lang="hi" xml:id="drakrpm-edit-media">
  <info>
    <title xml:id="drakrpm-edit-media-ti1">Configure Media</title>

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

  

  

  <mediaobject>
    <!-- 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) -->
<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>