From Mageia wiki
Revision as of 18:18, 7 July 2012 by Marja (talk | contribs) (removed draft template, page won't be revised)
Jump to: navigation, search

Some notes

This page is meant to help us write the help texts for
DrakX-installer. This text will be used to update the XML manual in Calenco as it is that which is parsed by this script to create the .po help text files for use in the installer.

Please put all the titles of DrakX installer screens with a help button here, plus a screenshot of that screen.

Please add any missing items.

Please look in Lebarhon's page, too: Installation of Mageia in dual boot with Windows

I shrunk the screenshots I made to 600x450, but that isn't necessary any more. Please upload them in their original size (800x600) and add |600 to the name of the picture (that'll shrink them to a width of 600 pixels):

[[File:Name_of_your_picture.png|600px]]

Current missing screenshots:

  • Individual package selection screen


Please look at the doc-discuss mail about "help buttons in installer - useful existing Calenco documentation"
The original (Mdv2005) order of the help texts was:

"A flow chart image showing a simplifed version of the installation process."
Installation Flow Chart (Simplified)

drakx-selectLanguage-sect1.xml * - selectLanguage.html - updated in Calenco
drakx-acceptLicense-sect1.xml * - acceptLicense.html - updated in Calenco
drakx-selectKeyboard-sect1.xml * - selectKeyboard.html - updated in Calenco
drakx-selectInstallClass-sect1.xml * - selectInstallClass.html - updated in Calenco
drakx-doPartitionDisks-sect1.xml * - doPartitionDisks.html - updated in Calenco
drakx-resizeFATChoose-sect1.xml * - resizeFATChoose.html - updated in Calenco
drakx-takeOverHdChoose-sect1.xml - takeOverHdChoose.html - updated in Calenco
drakx-takeOverHdConfirm-sect1.xml * takeOverHdConfirm.html - updated in Calenco
drakx-ask_mntpoint_s-sect1.xml * - ask_mntpoint_s.html - updated in Calenco
drakx-formatPartitions-sect1.xml * - formatPartitions.html - updated in Calenco
drakx-partition_with_diskdrake-sect1.xml *
drakx-choosePackages-sect1.xml - choosePackages.html
drakx-setRootPassword-sect1.xml * (not in ennael's list)
drakx-addUser-sect1.xml * - addUser.html
drakx-setupBootloaderBeginne-sect1.xml * - setupBootloaderBeginner.html
drakx-misc-params-sect1.xml * - misc-params.html
drakx-installUpdates-sect1.xml - installUpdates.html
drakx-exitInstal-sect1.xml * - exitInstall.html

Also needed:
diskdrake.html - diskdrake-sect1.xml - (maybe I'm wrong about this one, maybe this is generated from drakx-partition_with_diskdrake-sect1.xml?)
setupX.html - drakx-setupX-sect1.xml
(index.html will be automatically generated)



The page has been separated into two sections, the one here which is for the Installation section and another page for the Configuration section. The configuration takes place after the package installation process.

PLEASE CHOOSE A LANGUAGE TO USE

drakx-selectLanguage-sect1.xml

PLEASE CHOOSE A LANGUAGE TO USE.png

First open the tree relative to the continent you are located in, and then choose the language you speak. Your language choice will affect the installer, the documentation, and the system in general.

Click the Multiple languages button near the bottom of the list to go to the screen to select additional languages for your workstation, thereby installing the language-specific files for system documentation and applications. For example, if Spanish friends are to use your machine, select English as the default language in the first screen and Español in the Multiple languages screen.

Note:
You are advised to install the language of your keyboard and the language of the country you live in as additional languages if they are not the same as your preferred language.
Note:
About UTF-8 (unicode) support: Unicode is a character encoding intended to cover all existing languages. Mageia uses UTF-8 by default for all languages
  • If you know UTF-8 encoding doesn't work well for your language, tick the box Old compatibility (non-UTF) encoding at the top of the Multiple languages screen
  • Be aware that this will then apply to all languages on your system

Note that you're not limited to choosing a single additional language. You may choose several, or even install them all by selecting the All languages box. Selecting support for a language means translations, fonts, spell checkers, etc. will also be installed for that language. Make sure you select all languages which are likely to be useful on the machine now, it may be difficult to configure support for languages not chosen at install time at a later date.

Tip: To switch between the various languages installed on your system, you can launch the localedrake command as root to change the language used by the entire system. Running the command as a regular user will only change the language settings for that particular user.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120306)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : Preliminary: simonnzg 17:21, 1 March 2012 (UTC)

--


Multiple languages

MULTIPLE LANGUAGES.png

LICENSE AGREEMENT

drakx-acceptLicense-sect1.xml LICENSE AGREEMENT.png

Before continuing, you should carefully read the terms of the license. It covers the entire Mageia distribution. If you agree with all the terms it contains, select Accept and click on Next. If you do not agree, clicking on Quit will reboot your computer.


Tip:

If you are curious about any technical changes which have occurred in the distribution since the last release, you can click on the Release Notes button to display them.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120306)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : simonnzg 17:24, 1 March 2012 (UTC) (I'll ignore the American spelling of "licence")

--

INSTALL/UPGRADE

Should this be in the Partitioning section? grenoya : to in partitioning by, yes it's missing a 'installer configuration' or something like that

It's the first step before deciding to partition or not, isn't it? I would have thought "Install" was what you choose if you don't have an installation to upgrade. Upgrade is ONLY chosen if you can upgrade what is already installed. ??No?? simonnzg 17:34, 1 March 2012 (UTC)

Johnr 13:46 2 March 2012 (UTC): If you select "Upgrade" the actual partitioning step is skipped, you are only asked to confirm the partitions' name and if it's to be formatted.

simonnzg 22:50, 2 March 2012 (UTC) : That would make sense.

drakx-selectInstallClass-sect1.xml

INSTALLorUPGRADE.png

This step is shown only if an existing Linux partition is found on your machine.

DrakX now needs to know if you want to install from scratch or upgrade your existing Mageia system:

  • Upgrade. If you have an older Mageia operating system, this option allows you to upgrade it. Your existing partitioning scheme and user data won't be altered. Most of the other configuration steps remain available and are similar to a standard installation.
  • Install. Use this option for everything except upgrading an existing Mageia installation.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120307)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

@ Simonnzg @ grenoya

Now reworded the Install part according to Simon's brilliant idea (marja) @ grenoya: do you agree with the text? agreed ! (grenoya)

English validation : simonnzg 22:50, 2 March 2012 (UTC) : I have significantly changed the wording but will need to run another new install to be sure what I have said is what actually happens! I have removed the note about Mandriva as I think it's no-longer necessary. If the option to upgrade doesn't mention Mandriva, then that is good enough. Let's hope the upgrade script checks to see what it's upgrading! Thanks for removing the note about Mdv. and for putting Upgrade above Install (so correct order) (marja)

--

KEYBOARD

Does this belong in the License section? No, it follows the Licence screen so is separate (JohnR)

drakx-selectKeyboard-sect1.xml

KEYBOARD.png

Note:
DrakX shows one or more keyboards, depending on which language(s) you have chosen

Depending on the language you chose (see http://en.wikipedia.org/wiki/Keyboard_layout), DrakX automatically selects a particular type of keyboard configuration. Verify that the selection suits you or choose another keyboard layout.

If your keyboard isn't in the list shown, click on More to get a full list, and select your keyboard there. Note that after having chosen your keyboard, you will return to the first screen and it'll seem that a keyboard from this first screen was chosen. You can safely ignore this and go on, the keyboard you chose from the full list will now be configured!

If you choose a keyboard layout based on a non-Latin alphabet, an extra dialogue will allow you to choose the key binding which will switch the keyboard between the Latin and non-Latin layouts.

Additional information: You may have a keyboard which does not correspond exactly to your language: for example, if you are an English-speaking Swiss native, you may have a Swiss keyboard. Or if you speak English and are located in Québec, you may find yourself in the same situation where your native language and country-set keyboard don't match. In either case, this installation step will allow you to select an appropriate keyboard.


--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120308)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : MrsB

--

More

KEYBOARD full list.png

PARTITIONING

drakx-doPartitionDisks-sect1.xml

PARTITIONING.png

You now need to decide where you want to install Mageia on your hard drive. If your hard drive is empty or if an existing operating system is using all the available space you will have to re-partition the drive. Basically, partitioning a hard drive means to logically divide it in order to create the space required for your new Mageia system.

Because the process of partitioning a hard drive is usually irreversible and can lead to data loss, partitioning can be intimidating and stressful for the inexperienced user. Fortunately, the installer includes a wizard which simplifies this process. Before continuing with this step, read through the rest of this section and above all, take your time.

Depending on the configuration of your hard drive, several options are available:

  • Use free space. This option will perform an automatic partitioning of your blank drive(s). If you use this option there will be no further prompts.


  • Use existing partitions. The wizard has detected one or more existing Linux partitions on your hard drive. If you want to use them, choose this option. You will then be asked to choose the mount points associated with each of the partitions. The legacy mount points are selected by default, and for the most part it's a good idea to keep them. You will also be asked to choose the partitions to be formatted or preserved.


  • Use the free space on the Windows partition. If Windows®¶ is installed on your hard drive, you might have to create free space for GNU/Linux. To do so, you can either delete your Windows®¶ partition and data (see the Erase entire disk solution below) or resize your FAT or NTFS partition. Resizing can be performed without the loss of any data, provided you've previously defragmented the Windows®¶ partition. Backing up your data is strongly recommended. Using this option is recommended if you want to use both Mageia and Windows®¶ on the same computer in a dual boot configuration.

Before choosing this option, please understand that after this procedure, the size of your Windows®¶ partition will be smaller than when you started, which means you will have less free space to store your data or to install new software.


  • Erase entire disk. If you want to delete all data and all partitions present on your hard drive and replace them with Mageia, choose this option. Be warned that you won't be able to undo this operation after you confirm.

Warning: If you choose this option, all data on your disk will be deleted.


  • Remove Windows(TM). This option appears when the hard drive is entirely taken up by Windows®¶. Choosing this option will simply erase everything on the drive, partitioning everything from scratch.

Warning: If you choose this option, all data on your disk will be lost.


  • Custom disk partitioning. Choose this option if you want to manually partition your hard drive. Be careful, it is a powerful but dangerous choice and you can very easily lose all your data. That's why this option is only recommended if you have performed custom disk partitioning before, and have enough GNU/Linux experience to know what you are doing.

--


THE ABOVE TEXT IS IN CALENCO (CHECKED 20120308) with a link to another page added

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya (removed references to the 'Starter Guide', none exists for now for Mageia)

English validation : MrsB (Changed "DrakX" in paragraph 2 to "the installer", few other minor additions)

--

Custom disk partitioning

drakx-partition_with_diskdrake-sect1.xml

Partitioning-custom.png

At this point, you need to choose which partition(s) will be used for the installation of your Mageia system. If partitions have already been defined, either from a previous installation of GNU/Linux or by another partitioning tool, you can use those existing partitions. Otherwise, hard drive partitions must be defined here.

To create partitions, you must first select a hard drive. You can select the disk for partitioning by clicking on the relevant tab at the top - sda for the first drive, sdb for the second and so on.

To partition the selected hard drive, you can use these options:

Clear all: this option deletes all partitions on the selected hard drive

Auto allocate: this option enables you to automatically create ext4 and swap partitions in the free space of your hard drive

More: gives access to additional features:

Save partition table: saves the partition table to a USB stick or a floppy. Useful for later partition-table recovery if necessary. It is strongly recommended that you perform this step.

Restore partition table: allows you to restore a previously saved partition table from a USB stick or a floppy disk.

Rescue partition table: if your partition table is damaged, you can try to recover it using this option. Please be careful and remember that it doesn't always work.

Reload partition table: discards all changes and reloads the partition table that was originally on the hard drive.

Removable media auto-mounting: unchecking this option will force users to manually mount and unmount removable media such as USB sticks, floppies and CD-ROMs.

Wizard: use this option if you wish to use a wizard to partition your hard drive. This is recommended if you do not have a good understanding of partitioning.

Undo: use this option to cancel your changes.

Toggle between normal/expert mode: allows additional actions on partitions (type, options, format) and gives more information about the hard drive.

Done: when you have finished partitioning your hard drive, this will save your changes back to disk.


Tip:

When defining the size of a partition, you can fine tune the partition size by using the Arrow keys on your keyboard.

Note:
you can reach any option using the keyboard. Navigate through the partitions using Tab and the Up/Down arrows.

When a partition is selected, you can use:

   ¶Ctrl-¶c¶ to create a new partition (when an empty partition is selected)
   ¶Ctrl-¶d¶ to delete a partition
   ¶Ctrl-¶m¶ to set the mount point

--

tech validation : grenoya

English validation : (half-MrsB)

-- Grenoya : I can't be sure that all the expert command still exists (like: Removable media auto-mounting) so i let the 'floppy' word until i make some more tests in virtualbox

2012/03/08 : replace 'floppy' by 'USB stick or floppy' everywhere. On other steps, we have witnesses that usb is working. So It should but less faulse :)

MrsB: I'm not sure about the floppy either, it could maybe be tested with a USB stick as not many people have floppies any more.

Use existing partitions

drakx-ask_mntpoint_s-sect1.xml Partitioning-use-existing.png

      • Can't find help text in calenco :\ ***

It is this text: drakx-ask_mntpoint_s-sect1.xml


Choosing Mount Points

Listed here are the existing Linux partitions detected on your hard drive. You can keep the choices made by the wizard, since they are good for most common installations. If you make any changes, you must at least define a root partition (/). Do not choose too small a partition or you will not be able to install enough software. In most cases it is best to also create a /home partition, to store your data on (only possible if you have more than one Linux partition available).

Each partition is listed as follows: "Device", "Capacity", "Mount point","Type"

"Device", is structured: "hard drive type", "hard drive number", "partition number" (for example, "sda5").

When the mount points are correct, or corrected, click next. You'll then be given the choice to format one or more of the partitions you just chose to install Mageia on. Usually, formatting / and saving /home (if the same partition was your /home before), is a good choice.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120309)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : exporting to Calenco, despite missing validation. Please check the text there, too, after I uploaded it. (marja) It seems Ok to me marja (MrsB)



Erase and use entire disk

drakx-takeOverHdConfirm-sect1.xml

Partitioning-entire-disk.png

Click on Next if you want to delete all data and partitions present on this hard drive. Be careful, after clicking on Next you will not be able to recover any data and partitions present on this hard drive, including any Windows®¶ data.

Click on Previous to quit this operation without losing data and partitions present on this hard drive.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120308)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : MrsB

--

Missing 1 screenshot for make space on windows partition but I can't make on of those - MrsB

there is one here: Installation of Mageia in dual boot with Windows#All partitioning solutions


I think we are still missing the actual resizing screen.

That is this picture, you can see it'll leave at least 15231 MB to Windows:

Case2CursorResize.png

Choose FAT Partition to Be Resized

More than one Microsoft partition has been detected on your hard drive. Please choose the one which you want to resize in order to install your new Mageia operating system.

Each partition is listed as follows: "Linux name", "Windows name" "Capacity".

"Linux name" is structured: "hard drive type", "hard drive number", "partition number" (for example, "sda1").

"Hard drive type" is "sd"

  • This is standard for hard drives now and has nothing to do with SD Memory Cards. Hard drives were previously prefixed "hd" for IDE drives or "sd" for SATA drives but they are all now prefixed with "sd".

"Hard drive number" is actually a letter and always follows "sd":

  • "a" means "first hard drive";
  • "b" means "second hard drive";
  • and so on...


"Windows name" is the letter of your hard drive under Windows®¶ (the first disk or partition is called "C:").

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120309), except for "(all hard drive type are now seen the same way by the system)"

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : moving to Calenco despite missing validation. I'll leave out "(all hard drive type are now seen the same way by the system)" Please correct there, too. (marja 2012-03-09) Validated and altered slightly (MrsB 2012-03-09) Updated on Calenco now too.

Grenoya 12/03/08 : I don't want to remove the explanation of "Hard Drive Type", that's why I put an explanation (surely not good English /o\). I don't know if putting an explanation is good idea or not. If we don't, people can though there is a hardware problem ("my IDE is seen as SATA"), If we do, it looks weird. WDYT ?

--

FORMATTING

drakx-formatPartitions-sect1.xml

FORMATTING.png

If you chose to reuse some legacy GNU/Linux partitions, you may wish to reformat some of them and erase any data they contain. To do so, please select those partitions as well.

Please note that it's not necessary to reformat all pre-existing partitions. You must reformat the partitions containing the operating system (such as /, /usr or /var) but not the partitions containing data you wish to keep (typically /home).

Please be careful when selecting partitions. After the formatting is completed, all data on the selected partitions will be deleted and you won't be able to recover it.

Click on Next when you're ready to format the partitions.

Click on Previous if you want to choose other partitions for your new Mageia operating system installation before formatting.

Click on Advanced if you wish to select partitions which will be checked for bad blocks on the disk.

--

THE ABOVE TEXT IS IN CALENCO (CHECKED 20120306)

IF YOU CHANGE IT, PLEASE SEND A MESSAGE TELLING EXACTLY WHAT YOU CHANGED TO THE DOC-DISCUSS MAILING LIST

tech validation : grenoya

English validation : MrsB

Is the rest of this, below, to be included or just notes? It will need correcting if it is to be used.

Grenoya : it's what was already written in the wiki when I imported from calenco. I did not wanted to remove other's work. --

  • Select the partitions that will be part of your new system, that you want to format
  • There will be no possibility to go back once you'll click 'next'
  • this step will erase all the data that are curently on the part of the disk covered by your partition
  • '/' parfotting is mandatory
  • if you are keeping partitions from a previous install, select them for formatting only if you are sure you will not loose any important data
  • You can perform 'bad block check' through the 'advanced' interface

Advanced

Bad block check accessible by clicking the Advanced button:

Formatting-advanced.png

  • If you clicked on the “Advanced” button you will be presented with this screen where you can check any of the partitions that are being formatted for bad blocks, if drakx find any they will be marked as bad so that the file system does not get corrupted.

EXTRA MEDIA

This currently appears in the Partitioning section and is titled Package Group Selection, neither seem correct really. grenoya : 'Package Group Selection' make sense for me (thinking on how it may work behind, adding the complet path of the packages in a list...). And after a second thought : maybe the original idea was to have no more than 4 sections in order not to frighten people.

Extra-media.png

At this stage you can add extra locations to download and install extra software that could not fit on the DVD.

  • None: Selecting this option and clicking the “next button” will move onto the next step in the installation.
  • CD-ROM: If you have a DVD of previously downloaded Mageia rpm files you can put it in to the DVD drive, and select this option.
  • Network (HTTP) After you have selected this option and clicked the “next button” drakx asks what type of connection you want to configure. The default is “Wired (Ethernet)”

This option allows you to set up and start a network connection so that you can down load extra software programs from an on line software repository using the HTTP Internet protocols.

  • Network (FTP) When you select this option drakx will set up and connect to an on line software repository using the FTP Internet protocols.
  • Network (NFS) If this option is chosen drakx will set up and connect to an on line or local software repository using the NFS Internet protocols.
  • Note: You may have problems if you choose wireless (Wi-Fi) or some of the other connection types due to lack of drivers. Once the system is installed you have the chance to use the wired connection to down load any further drivers needed for other connection types.

DESKTOP SELECTION

DESKTOP SELECTION.png

At this stage of the installation you can choose which desktop you wish to use. If KDE or Gnome are selected then that desktop plus a whole package of useful software gets installed. Other desktops, such as LXDE, are available by selecting "Custom" here and clicking on "Next".

If the “Custom” option is chosen you can select alternate or multiple desktops and other useful bundles of software which have been separated into groups such as "Web/FTP" and "Multimedia Station" to make things easier. You can select any, or all, of these groups by simply placing a tick next to them. You can also select individual programs if you prefer to do so.

  • Note: If you are unsure which desktop to choose here, clicking on the picture will give a zoomed in view of that desktop which might help.


(MrsB: altered and enhanced - 2012-3-9 - not yet updated on Calenco!)

PACKAGE GROUP SELECTION

This is again titled Package Group Selection but is only accessible through choosing Custom at the Desktop Selection screen.

Package-group-selection.png

If you selected the “Custom” option on the last screen here you can choose what groups of software you want to install, depending on whether you want to use the computer as a workstation or server. You can also install the desktop you prefer.

  • Workstation: In this group you can select bundles of software to set up the PC as an Office, Games, Multimedia, Internet Station, Network Computer (client) or Development workstation.
  • Server: The server group will allow you to set the PC up as a Web/FTP, Mail, Database, Firewall/Router or Network server.
  • Graphical Environment: Is another name for “desktop”, so here you can select the desktop you want and any other desktops you want to explore.

Just above the “Help Button” drakx keeps a count of how much space you have and how much space all that selected software will require on your hard drive and will not allow you to select more software than you have space for. Clicking the “Next Button” will start copying, installing and setting up your software selections.

  • Note: Its always a good idea to select the “Configuration” bundle as Mageia has some excellent tools and “Documentation” is always handy to have locally on your hard drive, space permitting.


If you untick everything you get this screen..

Type-of-install.png


Individual package selection
Individual-package-selection.png

INSTALLATION

Package-installation.png

During the installation process drakx will display the estimated time for the file coping process to finish.

  • Details: If you click this button drakx will display a list of individual software packages as they are being installed, also indicated by a progress bar. The second progress bar shows a representation of all the software packages selected.
  • Release Notes: This button if clicked will bring up the “release notes”. This tells you a bit about Mageia installation media's, on-line software Repositories and major features while the file copy and installation proceeds.
  • Cancel: This will stop the software installation and bring you back to the “package Group Selection” Screen where you can choose where your packages come from.


Go to the Configuration section or back to the top of this one