[svn/pld-doc]: rev 148 - in pld-doc/docbook: . howto
averne w svn.pld-dc.org
averne w svn.pld-dc.org
Sob, 3 Sty 2004, 16:53:19 CET
Author: averne
Date: 2004-01-03 16:53:12 +0100 (Sat, 03 Jan 2004)
New Revision: 148
Added:
pld-doc/docbook/pl_book__master.docb
pld-doc/docbook/pl_konfiguracja.chp
pld-doc/docbook/pl_konfiguracja__siec.sec
pld-doc/docbook/pl_konfiguracja__sysconfig.sec
pld-doc/docbook/pl_konfiguracja__sysconfig___console.sec
pld-doc/docbook/pl_wstep.chp
Removed:
pld-doc/docbook/pl_konfiguracja__siec.docb
pld-doc/docbook/pl_wstep__wstep.docb
Modified:
pld-doc/docbook/howto/pl_howto__master.docb
Log:
- wprowadzono podzial na rozdzialy i sekcje
- dodano glowny dokument, z ktorego generowany bedzie podrecznik
- zamieniono czesc plikow z rozdzialow/ksiazek na sekcje
- dodano rozdzial pl_konfiguracja oraz sekcje pl_konfiguracja__sysconfig
- dodano konfirugracje sysconfig/console
Modified: pld-doc/docbook/howto/pl_howto__master.docb
===================================================================
--- pld-doc/docbook/howto/pl_howto__master.docb 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/howto/pl_howto__master.docb 2004-01-03 15:53:12 UTC (rev 148)
@@ -6,6 +6,7 @@
<book lang="pl"><title></title>
<bookinfo>
<title>Porady dla piszących dokumentacje PLD</title>
+ <author><firstname>PLD-doc</firstname><surname>Team</surname></author>
</bookinfo>
&howto1;
&howto2;
Added: pld-doc/docbook/pl_book__master.docb
===================================================================
--- pld-doc/docbook/pl_book__master.docb 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_book__master.docb 2004-01-03 15:53:12 UTC (rev 148)
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!ENTITY wstep SYSTEM "pl_wstep.chp">
+<!ENTITY konfiguracja SYSTEM "pl_konfiguracja.chp">
+<!ENTITY konfiguracja__sysconfig SYSTEM "pl_konfiguracja__sysconfig.sec">
+<!ENTITY konfiguracja__sysconfig___console SYSTEM "pl_konfiguracja__sysconfig___console.sec">
+<!ENTITY konfiguracja__siec SYSTEM "pl_konfiguracja__siec.sec">
+]>
+<book lang="pl"><title>PLD Linux Distribution</title>
+ <bookinfo>
+ <title>Podręcznik użytkownika i administratora</title>
+ </bookinfo>
+ &wstep;
+ &konfiguracja;
+</book>
Added: pld-doc/docbook/pl_konfiguracja.chp
===================================================================
--- pld-doc/docbook/pl_konfiguracja.chp 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_konfiguracja.chp 2004-01-03 15:53:12 UTC (rev 148)
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<chapter>
+<title>Konfiguracja systemu</title>
+<para>Ten rozdział prezentuje metody konfiguracji parametrów systemu.</para>
+&konfiguracja__sysconfig;
+&konfiguracja__siec;
+</chapter>
Deleted: pld-doc/docbook/pl_konfiguracja__siec.docb
===================================================================
--- pld-doc/docbook/pl_konfiguracja__siec.docb 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_konfiguracja__siec.docb 2004-01-03 15:53:12 UTC (rev 148)
@@ -1,323 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- $LastChangedDate$ $LastChangedBy$ $Rev$ -->
-<section>
- <title>
- Zainstalowaliśmy PLD ale nie mamy skonfigurowanej
- sieci, co dalej?
- </title>
- <section>
- <title>
- Sprawdzamy jaką mamy kartę sieciową
- </title>
- <para>
- Na szczęście większość dostępnych na rynku kart
- sieciowych jest oparta na układzie Realteka, 3Com'a
- bądź Intela. Wszystkie kernele z serii 2.2.x i 2.4.x
- które dostępne są w postaci gotowych pakietów rpm, jak
- również te znajdujące się w repozytorium serwera CVS
- PLD (cvs.pld-linux.org) które możemy sobie zbudować
- posiadają skompilowane moduły do tych kart sieciowych.
- </para>
- <para>
- Przejdźmy do sedna sprawy.
- </para>
- <para>
- Jak teraz sprawdzić jaką mam kartę sieciową? To proste.
- Instalujemy pakiet pciutils. Znajduje się on na
- jednym z CD PLD Linux Distribution.
- </para>
-<screen>
-[root w styx krzysiek]# mount /mnt/cdrom/
-[root w styx krzysiek]#
-[root w styx krzysiek]# rpm -ivh /mnt/cdrom/PLD/RPMS/pciutils-2.1.10-7.i686.rpm
-</screen>
-<para>
- Następnie wystarczy jak wpiszemy polecenie lspci. Wśród różnych
- urządzeń znajdziemy również naszą sieciówkę.
-</para>
-<screen>
-[root w styx krzysiek]# lspci
-[...]
-00:0e.0 Ethernet controller: Realtek Semiconductor Co., Ltd. RTL-8139/8139C/8139C+ (rev 10)
-[...]
-[root w styx krzysiek]#
-</screen>
-<para>
- Opcjonalnie, jeżeli nie chcemy, bądź nie umiemy lub nie chce nam się
- instalować pakietu pciutils, a potrzebujemy zidentyfikować naszą
- kartę sieciową wydajmy takie oto polecenie:
-</para>
-<screen>
-[root w styx krzysiek]# dmesg |grep -i eth
-[...]
-eth0: Identified 8139 chip type 'RTL-8139C'
-[...]
-[root w styx krzysiek]#
-</screen>
-<para>
- Wśród wielu informacji zwróć uwagę na fragment "RTL-8139/8139C/8139C+".
- Jest to wskazówka przydatna przy szukaniu odpowiedniego modułu.
-</para>
- </section>
- <section>
- <title>Instalujemy naszą sieciówkę</title>
- <para>
- Gdzie znajdziemy moduły do naszej karty? Znajdują
- się one w katalogu /lib/modules/2.2.22/net/. UWAGA!
- W PLD w kernelach z serii 2.4.x lokalizacja jest nieco
- inna, np.: /lib/modules/2.4.20/kernel/drivers/net/
- Posiadając już informacje płynące z punktu pierwszego
- wiemy mniej więcej którego modułu mamy poszukiwać.
- Możemy więc wydać polecenie:
- </para>
-<screen>
-[root w styx krzysiek]# ls /lib/modules/2.2.22/net/813*
-/lib/modules/2.2.22/net/8139too.o.gz
-[root w styx krzysiek]#
-</screen>
-<para>
- Oto i nasz moduł :-)
- Co dalej? musimy go załadować do pamięci. Robimy to poleceniem modprobe
-</para>
-<screen>
-[root w styx krzysiek]# modprobe 8139too
-[root w styx krzysiek]#
-</screen>
-<para>
- Zwróć uwagę, że pominąłem w nazwie modułu "o.gz". Upewnijmy się teraz
- czy nam się udało.
-</para>
-<screen>
-[root w styx krzysiek]# lsmod |grep 8139too
-8139too 13536 0 (autoclean)
-[root w styx krzysiek]#
-</screen>
-<para>
- Pięknie :-)
- Wyedytujmy teraz plik /etc/modules.conf
-</para>
-<screen>
-[root w styx krzysiek]# vim /etc/modules.conf
-</screen>
-<para>
- Zróbmy w nim następujący wpis:
-</para>
-<screen>
-alias eth0 8139too
-</screen>
-<para>
- Dzięki temu po restarcie komputera nasz moduł będzie ładowany
- automatycznie podczas startu systemu. Wyglada na to, że kartę mamy
- już zainstalowaną, wystarczy ją teraz poprawnie skonfigurować.
-</para>
- </section>
- <section>
- <title>Konfiguracja karty sieciowej</title>
- <para>
- Zakładam, że Twój komputer posiada jedną kartę
- sieciowa. Będzie ona widoczna w systemie jako eth0.
- Wyedytuj więc plik ifcfg-eth0
- </para>
-<screen>
-[root w styx krzysiek]# vim /etc/sysconfig/interfaces/ifcfg-eth0
-</screen>
-<para>
- Aby karta działała poprawnie powinieneś mieć tam podobne ustawienia:
-</para>
-<screen>
-DEVICE="eth0"
-</screen>
-<para>
- Opcja ta określa symbol urządzenia widocznego w systemie.
-</para>
-<screen>
-IPADDR="192.168.0.2/24"
-</screen>
-<para>
- Ta opcja określa adres karty sieciowej oraz maskę podsieci.
- "/24" odpowiada masce 255.255.255.0
-</para>
-<screen>
-ONBOOT="yes"
-</screen>
-<para>
- Ustaw na "yes" jeśli chcesz (a zakładam, że tak ;-)) aby interfejs
- podnosił się razem z systemem.
-</para>
-<screen>
-BOOTPROTO="none"
-</screen>
-<para>
- Ta opcja pozwala dokonać wyboru, w jaki sposób karta sieciowa ma
- otrzymywać adres. Powyższy wpis sprawia, że system pobiera wszystkie
- ustawienia z posiadanych plików konfiguracyjnych. Wykorzystuje się
- jeszcze BOOTPROTO="dhcp", które wymusza pobranie przez kartę ustawień
- z serwera DHCP. Aby zadziałało to ustawienie, potrzebny nam będzie
- pakiet dhcp-client. Znajduje on się również na jednym z CD PLD.
- Instalujemy go w sposób analogiczny do pakietu pciutils.
-</para>
-<para>
- Okej.. to mamy już skonfigurowaną naszą kartę sieciową, ale to jeszcze
- nie koniec :)
-</para>
- </section>
- <section>
- <title>Konfiguracja sieci</title>
- <para>
- Musimy teraz otworzyć naszej karcie sieciowej
- "okno na świat" i pokazać pewne ważne dla niej
- adresy, pod które musi trafić ;-) W tym celu
- udajmy się do pliku network.
- </para>
-<screen>
-[root w styx krzysiek]# vim /etc/sysconfig/network
-</screen>
-<para>
- Przechodzimy do konfiguracji.
-</para>
-<screen>
-NETWORKING=yes
-</screen>
-<para>
- Ustawiamy na "yes" jeżeli chcemy komunikować się z siecią.
-</para>
-<screen>
-IPV4_NETWORKING=yes
-</screen>
-<para>
- Ustawiamy na "yes" jeżeli będziemy korzystać z protokołu ipv4.
-</para>
-<screen>
-IPV4_FORWARDING=no
-</screen>
-<para>
- Zakładam, że to stacja robocza, więc nie potrzebujemy forwardingu.
-</para>
-<screen>
-HOSTNAME="styx"
-</screen>
-<para>
- Tutaj ustawiamy nazwę naszego komputera. Spore pole do popisu dla
- Twojej inwencji twórczej ;-)
-</para>
-<screen>
-NISDOMAIN="localdomain"
-</screen>
-<para>
- Tutaj wystarczy domyślne "localdomain"
-</para>
-<screen>
-GATEWAY="192.168.0.1"
-GATEWAYDEV="eth0"
-</screen>
-<para>
- Dwie ważne opcje. Pierwsza określa adres IP naszej bramki
- umożliwiającej nam komunikację ze światem. Druga zaś urządzenie,
- które będzie się z nią komunikować.
- To tyle jeżeli chodzi o konfigurację tego pliku. Jeżeli nie jesteś
- zainteresowany takimi protokołami jak IPX czy IPv6.
-</para>
-<para>
- Pozostaje nam jeszcze tylko jeden plik: resolv.conf Wyedytujmy go
- sobie. Jeśli go nie posiadasz, możesz go utworzyć za pomocą dowolnego
- edytora.
-</para>
-<screen>
-root w styx krzysiek]# vim /etc/resolv.conf
-</screen>
-<para>
- Co w nim powinno się znajdować? Tak naprawdę wystarczy jeden wpis.
- Jeżeli posiadasz w swojej sieci serwer DNS, wystarczy, że wpiszesz
- coś takiego:
-</para>
-<screen>
-nameserver 192.168.0.1
-</screen>
-<para>
- Powyższy adres jest adresem mojego serwera DNS. Jeżeli nie posiadasz
- takiego serwera, zrób następujący wpis:
-</para>
-<screen>
-nameserver 194.204.159.1
-nameserver 194.204.152.34
-</screen>
-<para>
- Te adresy są adresami serwerów DNS TPSA. Generalnie wystarczy tylko
- adres primary DNS'a, ale drugi też nie zaszkodzi ;-)
-</para>
-<para>
- Warto również w pliku resolv.conf umieścić wpis:
-</para>
-<screen>
-domain localdomain
-</screen>
-<para>
- Zamiast localdomain możesz wpisać nazwę Twojej domeny, jeżeli takową
- posiadasz.
- Warto również wyedytować plik hosts:
-</para>
-<screen>
-[root w styx krzysiek]# vim /etc/hosts
-</screen>
-<para>
- Zrób w nim wpis w formie: IP host.domena host np.:
-</para>
-<screen>
-192.168.0.2 localhost.localdomain localhost
-</screen>
-<para>
- Oczywiście jeżeli posiadasz swoją domenę, zamiast localdomain wpisz
- jej nazwę, również jeśli ustawiłeś własny HOSTNAME wpisz go zamiast
- localhost. Oto przykład takiego wpisu:
-</para>
-<screen>
-213.25.115.88 platinum.elsat.net.pl platinum
-</screen>
-<para>
- Wydawać się może że to mało istotny szczegół, a jednak, jak się
- okazuje, nie do końca. Niektóre demony wymagają takich wpisów do
- poprawnego funkcjonowania. Jako przykład warto wymienić tu postfiksa.
- Również do szybszej identyfikacji, bez konieczności odwoływania się
- do serwera DNS.
-</para>
- </section>
- <section>
- <title>Happy End (?) ;-)</title>
- <para>
- Wygląda na to, że przebrnęliśmy przez cały ten proces.
- Pozaostało nam tylko jedno - uruchomienie naszej
- sieciówki. Wykonajmy takie polecenie:
- </para>
-<screen>
-[root w styx krzysiek]# /etc/rc.d/init.d/network restart
-Ustawianie parametrów sieci........................................[ ZROBIONE ]
-Podnoszenie interfejsu eth0........................................[ ZROBIONE ]
-[root w styx krzysiek]#
-</screen>
-<para>
- Hm.. wygląda na to, że nam się udało :-)
-</para>
- </section>
- <section>
- <title>Modułu do mojej karty nie ma w PLD, co mam zrobić?</title>
- <para>
- Tak też oczywiście może się zdarzyć. W takim wypadku
- będziesz musiał skorzystać z dyskietki, którą na pewno
- masz, o ile kupiłeś nową kartę. Prawdopodobnie
- znajdziesz na niej sterowniki dla Linuksa. Jeżeli nie,
- poszukaj ich w internecie (www.google.com). Przeczytaj
- plik README bądź INSTALL, w którym znajdziesz sposób
- instalacji sterownika w systemie.
- </para>
- </section>
- <section>
- <title>Podziękowania</title>
- <para>
- Sebastian Kowalik AKA Chajdesz za styl i literówki.
- </para>
- <para>
- Rafał Paweł Janiczek AKA {eRJot} za niezwykle cenne
- uwagi i wytknięcie mi poważnych błędów merytorycznych.
- </para>
- </section>
-</section>
Copied: pld-doc/docbook/pl_konfiguracja__siec.sec (from rev 147, pld-doc/docbook/pl_konfiguracja__siec.docb)
Added: pld-doc/docbook/pl_konfiguracja__sysconfig.sec
===================================================================
--- pld-doc/docbook/pl_konfiguracja__sysconfig.sec 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_konfiguracja__sysconfig.sec 2004-01-03 15:53:12 UTC (rev 148)
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<section>
+ <title>Podstawowa konfiguracja systemu: /etc/sysconfig</title>
+<para>Ten rozdział prezentuje metody konfiguracji podstawowych parametrów systemu.</para>
+&konfiguracja__sysconfig___console;
+</section>
Added: pld-doc/docbook/pl_konfiguracja__sysconfig___console.sec
===================================================================
--- pld-doc/docbook/pl_konfiguracja__sysconfig___console.sec 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_konfiguracja__sysconfig___console.sec 2004-01-03 15:53:12 UTC (rev 148)
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<section>
+ <title>Ustawienia konsoli</title>
+ <para>
+ Dzięki plikowi /etc/sysconfig/console możemy ustawić takie parametry jak czcionka konsoli,
+ mapa klawiatury, kodowanie fontów oraz zarządzanie energią.
+ </para>
+ <para>
+ Aby zmienić czcionkę, edytujemy parametr:
+ <screen>
+CONSOLEFONT=lat2u-16
+ </screen>
+ Do wyboru mamy czcionki zamieszczone w katalogu /usr/share/consolefonts. Aby zaaplikować zmiany,
+ wykonujemy komendę
+ <screen>
+/etc/rc.d/init.d/console start
+ </screen>
+ </para>
+ <para>
+ Aby zmienić kodowanie znaków, edytujemy parametr:
+ <screen>
+CONSOLEMAP=8859-2
+ </screen>
+ </para>
+ <para>
+ Aby zmienić mapowanie klawiatury, edytujemy parametr:
+ <screen>
+KEYTABLE=pl2
+ </screen>
+ </para>
+ <para>
+ Aby ustawić numery konsol, dla których aplikowane są parametry, zmieniamy:
+ <screen>
+SET_FONT_TERMINALS="1 2 3 4 5 6 7 8"
+ </screen>
+ Przedstawiony parametr, deklaruje zmianę ustawień dla konsol tty1-tty8.
+ </para>
+ <para>
+ Aby opcje zarządzania energią, edytujemy parametry:
+ <screen>
+POWER_SAVE=on
+BLANK_TIME=10
+POWERDOWN_TIME=60
+ </screen>
+ Parametr BLANK_TIME określa liczbę minut nieaktywności do wygaszenia ekranu, POWERDOWN_TIME
+ do wyłączenia monitora.
+ </para>
+ <para>
+ Aby zmienić kolor czcionki lub tła, edytujemy parametr:
+ <screen>
+FOREGROUND_COLOUR=red
+BACKGROUND_COLOUR=green
+ </screen>
+ Do wyboru posiadamy kolory black|red|green|yellow|blue|magenta|cyan|white|default.
+ </para>
+ <para>
+ Aby zmienić domyślny tryb NUM Locka, edytujemy parametr:
+ <screen>
+NUM_LOCK=on
+ </screen>
+ Do wyboru posiadamy atrybut on lub off.
+ </para>
+</section>
Copied: pld-doc/docbook/pl_wstep.chp (from rev 144, pld-doc/docbook/pl_wstep__wstep.docb)
===================================================================
--- pld-doc/docbook/pl_wstep__wstep.docb 2004-01-02 23:21:18 UTC (rev 144)
+++ pld-doc/docbook/pl_wstep.chp 2004-01-03 15:53:12 UTC (rev 148)
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<!-- $LastChangedDate$ $LastChangedBy$ $Rev$ -->
+<chapter>
+ <title>
+ Wstęp
+ </title>
+ <section>
+ <title>
+ Czym jest Linux
+ </title>
+ <para>
+ Tu wklei się jakiś tekst o tym, czym jest Linux
+ i dlaczego będzie rządził na wieki wieków.
+ A może coś innego? Czekam na propozycje.
+ </para>
+ </section>
+ <section>
+ <title>
+ Po co właściwie mi ten podręcznik?
+ </title>
+ <para>
+ Celem tego podręcznika jest pomoc w zainstalowaniu PLD
+ Linux Distribution na Twojej maszynie. Nie jest to i
+ nigdy nie będzie zamiennik dokumentacji online, jaką
+ możesz znaleźć w systemie.
+ </para>
+ <para>
+ Jeśli będzie to Twoja pierwsza instalacja Linuksa,
+ gorąco zachęcamy Cię do przeczytania wpierw tego
+ podręcznika. Nawet jeśli jesteś doświadczonym
+ użytkownikiem, warto przestudiować instrukcje dotyczące
+ instalacji, aby upewnić się, że wszystko pójdzie gładko.
+ </para>
+ <para>
+ Ponieważ Linux rozwija się wyjątkowo dynamicznie (łatki
+ na kernel pojawiające się każdego dnia nikogo już nie
+ dziwią), aktualizacja tego podręcznika może być trudna.
+ Ale staramy się jak możemy.
+ </para>
+ <para>
+ Podręcznik, który właśnie czytasz podzielony został na
+ kilka sekcji:
+ </para>
+ <itemizedlist>
+ <listitem><para>Instalacja</para></listitem>
+ <listitem><para>Konfiguracja sieci</para></listitem>
+ <listitem><para>Konfiguracja środowiska graficznego</para></listitem>
+ <listitem><para>...</para></listitem>
+ </itemizedlist>
+ </section>
+</chapter>
Deleted: pld-doc/docbook/pl_wstep__wstep.docb
===================================================================
--- pld-doc/docbook/pl_wstep__wstep.docb 2004-01-03 15:43:46 UTC (rev 147)
+++ pld-doc/docbook/pl_wstep__wstep.docb 2004-01-03 15:53:12 UTC (rev 148)
@@ -1,54 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-2"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-<!-- $LastChangedDate$ $LastChangedBy$ $Rev$ -->
-<book lang="pl">
- <bookinfo>
- <title>
- Wstęp
- </title>
- </bookinfo>
- <chapter>
- <title>
- Czym jest Linux
- </title>
- <para>
- Tu wklei się jakiś tekst o tym, czym jest Linux
- i dlaczego będzie rządził na wieki wieków.
- A może coś innego? Czekam na propozycje.
- </para>
- </chapter>
- <chapter>
- <title>
- Po co właściwie mi ten podręcznik?
- </title>
- <para>
- Celem tego podręcznika jest pomoc w zainstalowaniu PLD
- Linux Distribution na Twojej maszynie. Nie jest to i
- nigdy nie będzie zamiennik dokumentacji online, jaką
- możesz znaleźć w systemie.
- </para>
- <para>
- Jeśli będzie to Twoja pierwsza instalacja Linuksa,
- gorąco zachęcamy Cię do przeczytania wpierw tego
- podręcznika. Nawet jeśli jesteś doświadczonym
- użytkownikiem, warto przestudiować instrukcje dotyczące
- instalacji, aby upewnić się, że wszystko pójdzie gładko.
- </para>
- <para>
- Ponieważ Linux rozwija się wyjątkowo dynamicznie (łatki
- na kernel pojawiające się każdego dnia nikogo już nie
- dziwią), aktualizacja tego podręcznika może być trudna.
- Ale staramy się jak możemy.
- </para>
- <para>
- Podręcznik, który właśnie czytasz podzielony został na
- kilka sekcji:
- </para>
- <itemizedlist>
- <listitem><para>Instalacja</para></listitem>
- <listitem><para>Konfiguracja sieci</para></listitem>
- <listitem><para>Konfiguracja środowiska graficznego</para></listitem>
- <listitem><para>...</para></listitem>
- </itemizedlist>
- </chapter>
-</book>
Więcej informacji o liście dyskusyjnej pld-doc