Difference between pages "Help:Funtoo Editing Guidelines" and "Install/Overview"

(Difference between pages)
 
 
Line 1: Line 1:
This guide is meant to serve as a reference for those who are interested in helping improve the Funtoo wiki.  
+
<noinclude>
 +
{{InstallPart|an initial overview of the installation process as well as LiveCD download and boot instructions.}}
 +
</noinclude>
 +
== Installation Overview ==
  
== &#123;&#123;Kernelop&#125;&#125; ==
+
This is a basic overview of the Funtoo installation process:
To display kernel options, we encourage you to use the <tt>kernelop</tt> template. To use the <tt>kernelop</tt> template, create an entry similar to the following example:  
+
<pre>
+
{{kernelop|title=foo,bar|desc=
+
kernel options pasted from "make menuconfig"
+
<&#47;pre>}}
+
</pre>
+
  
Adding this entry will give you the following output:
+
# [[#Live CD|Download and boot the live CD of your choice]].
{{kernelop|title=foo,bar|desc=
+
# [[#Prepare Hard Disk|Prepare your disk]].
kernel options
+
# [[#Creating filesystems|Create]] and [[#Mounting filesystems|mount]] filesystems.
}}
+
# [[#Installing the Stage 3 tarball|Install the Funtoo stage tarball]] of your choice.
 +
# [[#Chroot into Funtoo|Chroot into your new system]].
 +
# [[#Downloading the Portage tree|Download the Portage tree]].
 +
# [[#Configuring your system|Configure your system]] and [[#Configuring your network|network]].
 +
# [[#Configuring and installing the Linux kernel|Install a kernel]].
 +
# [[#Installing a Bootloader|Install a bootloader]].
 +
# [[#Finishing Steps|Complete final steps]].
 +
# [[#Restart your system|Reboot and enjoy]].
  
Here's a more concrete example:
+
=== Live CD ===
{{kernelop|title=File systems|desc=
+
<M> Second extended fs support         
+
[ ]  Ext2 extended attributes         
+
[ ]  Ext2 execute in place support   
+
<M> Ext3 journalling file system support
+
}}
+
  
Examples of usage:  
+
Funtoo doesn't provide an "official" Funtoo Live CD. We recommend using the Gentoo-based [http://www.sysresccd.org/ System Rescue CD] as it contains lots of tools and utilities and supports both 32-bit and 64-bit systems. Download it here:
* [[Fglrx]]
+
* [[Acpid]]
+
* [[Microcode]]
+
  
== Displaying Source Code ==
+
* Download from '''[http://build.funtoo.org/distfiles/sysresccd/systemrescuecd-x86-4.5.0.iso osuosl.org]'''
 +
* Download from '''[http://ftp.osuosl.org/pub/funtoo/distfiles/sysresccd/systemrescuecd-x86-4.5.0.iso funtoo.org]'''
  
To display source code, use the <tt>&#60;syntaxhighlight&#62;</tt> tag, which has the ability to perform syntax highlighting on the source code for easier reading:
+
{{Note|If using an older version of System Rescue CD, '''be sure to select the <code>rescue64</code> kernel at the boot menu if you are installing a 64-bit system'''. By default, System Rescue CD used to boot in 32-bit mode though the latest version attempts to automatically detect 64-bit processors.}}
  
 +
==== Network Access ====
  
<pre>
+
Once you have booted System Rescue CD, see if you have Internet access. Internet access is required for installing Funtoo Linux:
<syntaxhighlight lang="python">
+
import system
+
</syntaxhighlight>
+
</pre>
+
  
 +
<console>
 +
# ##i##ping www.google.com
 +
PING www.google.com (216.58.217.36) 56(84) bytes of data.
 +
64 bytes from den03s10-in-f4.1e100.net (216.58.217.36): icmp_seq=1 ttl=57 time=30.1 ms
 +
</console>
  
Note that the language should be specified in the <tt>lang</tt> attribute. For a list of supported languages, see [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages this list].
+
If the ping is successful (you see <code>64 bytes</code> messages as above,) then your Network is set up. Hit Control-C to stop the ping.  
  
== &#123;&#123;File&#125;&#125; ==
+
If you need to set up a WiFi connection for Internet access, then this needs to be done using the System Rescue CD graphical environment. Run <code>startx</code> to start a graphical session:
To display the contents of a file, use the <tt>file</tt> template.  
+
<pre>
+
{{file
+
| file name | <pre>
+
contents of the file
+
<&#47;pre>}}
+
</pre>
+
  
This produces:
+
<console>
{{file
+
# ##i##startx
| file name | <pre>
+
</console>
contents of the file
+
</pre>}}
+
  
Examples of usage:
+
Then, use the NetworkManager applet (icon in lower right) to connect to a WiFi network of your choice. Next, open a terminal inside your graphical environment, and you should be able to use the terminal to complete the rest of the steps.
* [[UEFI Install Guide]]
+
* [[MediaWiki]]
+
* [[Clang]]
+
  
== &#60;tt&#62; and &#60;code&#62; ==
+
==== Remote Install ====
To emphasize filenames, commands, and other technical "jargon," use the  <tt>&#60;tt&#62;</tt> or <tt>&#60;code&#62;</tt> option. To use these, follow the example below:
+
<pre>
+
The <tt>/etc/fstab</tt> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
</pre>
+
  
This example produces the following output (notice the difference between the fonts?): <br> The <tt>/etc/fstab</tt> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
Alternatively, you can log into System Rescue CD over the network via SSH to perform the install from another computer, and this may be more convenient way to install Funtoo Linux.
  
== &#60;console&#62; ==
+
If you'd like to complete the install remotely, here's how. First, you will need to ensure that System Rescue CD has a functioning network connection. Then, you will need to set a root password for System Rescue CD:
To display console output, use the <tt>&#60;console&#62;</tt> tag:
+
  
For a root console:
 
<pre>
 
 
<console>
 
<console>
###i## run a command as root
+
# ##i##passwd
 +
New password: ##i##********
 +
Retype new password: ##i##********
 +
passwd: password updated successfully
 +
#
 
</console>
 
</console>
</pre>
+
 
Produces:
+
Once you have typed in a password, you will now need to determine the IP address of System Rescue CD, and then you can use <code>ssh</code> to connect to it. To determine the IP address currently being used by System Rescue CD, type <code>ifconfig</code>:
 +
 
 
<console>
 
<console>
###i## run a command as root
+
# ##i##ifconfig
 
</console>
 
</console>
  
{{Fancyimportant|The <tt>##i##</tt> text tags the rest of the line as being ''user input'' ("i" is for "input"). It is then highlighted in a noticeable color so it stands out from text that is not typed in by the user.}}
+
One of the interfaces should have an IP address (listed as <code>inet addr:</code>) from your LAN. You can then connect remotely, from another system on your LAN, to System Rescue CD, and perform steps from the comfort of an existing OS. On your remote system, type the following, replacing <code>1.2.3.4</code> with the IP address of System Rescue CD. Connecting from an existing Linux or MacOS system would look something like this:
  
Examples of usage:
 
* [[Rootfs over encrypted lvm]]
 
* [[Boot-Update]]
 
* [[Fonts]]
 
For a non-root console:
 
<pre>
 
 
<console>
 
<console>
$##i## run a command as user
+
(remote system) $ ##i##ssh root@1.2.3.4
 +
Password: ##i##**********
 
</console>
 
</console>
</pre>
 
Produces:
 
<console>
 
$##i## run a command as user
 
</console>
 
Examples of usage:
 
* [[Zope HOWTO]]
 
* [[Benchmarking]]
 
  
[[Category:Wiki Development]]
+
{{Note|If you'd like to connect remotely from an existing Microsoft Windows system, you'll need to download an SSH client for Windows, such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY].}}
 +
 
 +
After you've logged in via SSH, you're now connected remotely to System Rescue CD and can perform the installation steps.

Revision as of 09:50, February 6, 2015


Note

This is a template that is used as part of the Installation instructions which covers: an initial overview of the installation process as well as LiveCD download and boot instructions.. Templates are being used to allow multiple variant install guides that use most of the same re-usable parts.


Installation Overview

This is a basic overview of the Funtoo installation process:

  1. Download and boot the live CD of your choice.
  2. Prepare your disk.
  3. Create and mount filesystems.
  4. Install the Funtoo stage tarball of your choice.
  5. Chroot into your new system.
  6. Download the Portage tree.
  7. Configure your system and network.
  8. Install a kernel.
  9. Install a bootloader.
  10. Complete final steps.
  11. Reboot and enjoy.

Live CD

Funtoo doesn't provide an "official" Funtoo Live CD. We recommend using the Gentoo-based System Rescue CD as it contains lots of tools and utilities and supports both 32-bit and 64-bit systems. Download it here:

Note

If using an older version of System Rescue CD, be sure to select the rescue64 kernel at the boot menu if you are installing a 64-bit system. By default, System Rescue CD used to boot in 32-bit mode though the latest version attempts to automatically detect 64-bit processors.

Network Access

Once you have booted System Rescue CD, see if you have Internet access. Internet access is required for installing Funtoo Linux:

# ping www.google.com
PING www.google.com (216.58.217.36) 56(84) bytes of data.
64 bytes from den03s10-in-f4.1e100.net (216.58.217.36): icmp_seq=1 ttl=57 time=30.1 ms

If the ping is successful (you see 64 bytes messages as above,) then your Network is set up. Hit Control-C to stop the ping.

If you need to set up a WiFi connection for Internet access, then this needs to be done using the System Rescue CD graphical environment. Run startx to start a graphical session:

# startx

Then, use the NetworkManager applet (icon in lower right) to connect to a WiFi network of your choice. Next, open a terminal inside your graphical environment, and you should be able to use the terminal to complete the rest of the steps.

Remote Install

Alternatively, you can log into System Rescue CD over the network via SSH to perform the install from another computer, and this may be more convenient way to install Funtoo Linux.

If you'd like to complete the install remotely, here's how. First, you will need to ensure that System Rescue CD has a functioning network connection. Then, you will need to set a root password for System Rescue CD:

# passwd
New password: ********
Retype new password: ********
passwd: password updated successfully
#

Once you have typed in a password, you will now need to determine the IP address of System Rescue CD, and then you can use ssh to connect to it. To determine the IP address currently being used by System Rescue CD, type ifconfig:

# ifconfig

One of the interfaces should have an IP address (listed as inet addr:) from your LAN. You can then connect remotely, from another system on your LAN, to System Rescue CD, and perform steps from the comfort of an existing OS. On your remote system, type the following, replacing 1.2.3.4 with the IP address of System Rescue CD. Connecting from an existing Linux or MacOS system would look something like this:

(remote system) $ ssh root@1.2.3.4
Password: **********
Note

If you'd like to connect remotely from an existing Microsoft Windows system, you'll need to download an SSH client for Windows, such as PuTTY.

After you've logged in via SSH, you're now connected remotely to System Rescue CD and can perform the installation steps.