Instrukcja obsługi


HOWTO - Czyli jak zainstalować Kadu ze źródeł.

Ten dokument opisuje jak zainstalować program Kadu od wersji 0.3.2 do najnowszych.



Spis treści:

  1. Wstęp
  2. Wymagane pakiety
  3. Jak to zrobić - instalacja
  4. Jak to zrobić - ustawianie zmiennej QTDIR i KDEDIR
  5. Jak to zrobić - wysyłanie sms
  6. Jak to zrobić - patch KaduBis aby obrazków było więcej
  7. Jak to zrobić - Szyfrowanie rozmów
  8. Powrót do spisu treści Instrukcji

1. Wstęp


W dokumencie tym postaram się wyjaśnić jak zainstalować z pakietu źródłowego program Kadu. System bazowy to dystrybucja Mandrake 9.0. W innych dystrybucjach może to wyglądać podobnie ale nie koniecznie. Dotyczy on wersji 0.3.2 i nowszych. Starsze wersje nie będą omawiane.


2. Wymagane pakiety:


  • Glibc 2.2.5-16mdk
  • Glibc-devel 2.2.5-16mdk
  • glibc_lsb 2.2.90-11mdk
  • libarts-devel 1.0.3-7mdk
  • freetype2 2.0.9-3mdk
  • freetype2-devel 2.0.9-3mdk
  • libgcc1 3.3-1mdk
  • XFree86-libs 4.2.1-3mdk
  • XFree86-devel 4.2.1-3mdk
  • libjpeg62 6b-25mdk
  • libjpeg62-devel 6b-25mdk
  • liblcms1 1.09-1mdk
  • libmng1 1.0.3-2mdk
  • libpng3 1.2.4-3mdk
  • libpng3-devel 1.2.4-3mdk
  • libqt3 3.0.5-7mdk
  • libqt3-devel 3.0.5-7mdk
  • libstdc++5 3.2-1mdk
  • libstdc++5-devel 3.2-1mdk
  • zlib1 1.1.4-3mdk
  • zlib1-devel 1.1.4-3mdk

Większość z tych pakietów na pewno będzie już zainstalowane w twoim systemie. Niektóre będą wymagały spełnienia innych zależności. Jednak że chciałbym uczulić na obecność w systemie pakietów developerskich czyli pakietów z bibliotekami nagłówkowymi. Częste pytania typu: "./configure nie znajduje Qt lub KDE" to brak nie wspomnianych programów ale właśnie bibliotek nagłówkowych. Więcej szczegółów znajdziesz w rozdziale poniżej.

Z powrotem na górę dokumentu

3. Jak To Zrobić - instalacja


Postępuj zgodnie z instrukcją podaną poniżej.

  1. Pierwszym krokiem będzie rozpakowanie źródeł. Oczywiście można to zrobić poleceniem:
             gunzip kadu-nr_wersji.tar.gz
             tar -xf kadu-nr_wersji.tar
    ale można oczywiście prościej np.: w Midnight Commander lub w X-ach ark-iem. Wybór należy do użytkownika.
  2. Logujemy się w systemie z uprawnieniami administratora poleceniem:
             su
  3. W powstałym katalogu wydajemy polecenia:
    ./configure
        make
        make install
    lub korzystamy ze skryptu "Instaluj" lub jego angielskiej wersji "setup", który w większości przypadków jest najlepszym rozwiązaniem. Dla RedHata 8 i Auroxa 8, przygotowałem specjalna wersję skryptu "Instaluj" o nazwie Instaluj-RH8. Napisany jest w unikodzie z uwzględnieniem struktury katalogów RedHat 8.

  4. Kadu wersja 0.3.3-pre1 domyślnie zainstalowana w usr/local/. Instalacja przebiega pomyślnie, natomiast próba startu powoduje wyrzucenie błędu: nie znaleziono libgadu.so.2
    Lekarstwo: zrobić link symboliczny do libgadu.so.2, które zainstalowało się w /usr/local/lib/, w katalogu /usr/lib w następujący sposób:
            ln -s /usr/local/lib/libgadu.so.2 /usr/lib/
    lub zaktualizowanie pliku /etc/ld.so.conf o ścieżke do istniejącego LibGadu i wydanie polecenia:
    /sbin/ldconfig
    Wszystko oczywiście z uprawnieniami root-a.
  5. Pomocnym rozwiązaniem jest też wydanie polecenia:
             ./configure --help |less
    i przeczytanie wszystkich możliwych opcji konfiguracyjnych.

    A to nie które z nich:

    * instalacja do wybranego przez siebie katalogu
             ./configure --prefix=/twoj_podany_katalog
    * możliwość wyłączenia instalacji dokumentacji wraz z Kadu
             ./configure --disable-doc
    * symbole dla debugera nie są wkompilowywane aby je włączyć
             ./configure --enable-debug
    * możliwość wyłączenia kompilacji libgadu i zlinkowania z już istniejącą w systemie instalacją
             ./configure --with-existing-libgadu
    * wkompilowywana informacja o typie dystrybucji, np. źródła, paczka dla określonego systemu itp.
             ./configure --enable-dist-info=DIST
    *bez szyfrowania wiadomości w ssl
             ./configure --without-openssl

Z powrotem na górę dokumentu

4. Jak To Zrobić - ustawianie zmiennej QTDIR i KDEDIR


OD WESJI KADU 0.3.3 rc1 ZMIENNA KDEDIR JEST POTRZEBNA TYLKO DO INSTALACJI POD KDE. SAMO KADU JUZ KDE NIE WYMAGA

Często zdarzają się problemy ze zmienną QTDIR i KDEDIR (zwłaszcza w RedHat lub Mandrake) co skutkuje nieznalezieniem albo biblioteki Qt albo KDE lub nie przekopiowaniu przy instalacji wszystkich plików. Dotyczy to w szczególności polskich locali, co skutkuje brakiem polskiej wersji językowej. Zakładam ze masz zainstalowane zarówno QT3.0.x jak i odpowiednie pakiety(lub całość) KDE3.0.X

Oto przykładowe rozwiązanie tego problemu. Jako root w /etc/profile dopisać na końcu pliku:

#####################################################
# QT
#####################################################

QTDIR=/usr/local/qt
PATH=$QTDIR/bin:$PATH
MANPATH=$QTDIR/doc/man:$MANPATH
LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export QTDIR PATH MANPATH LD_LIBRARY_PATH

#####################################################
# KDE OD WERSJI 0.3.3-rc1 nie wymagane dla instalacji innej niż do KDE
#####################################################

KDEDIR=/usr/local/kde
PATH=$KDEDIR/bin:$PATH
export KDEDIR PATH

Oczywiście takie katalogi muszą istnieć jeżeli są gdzie indziej ścieżka musi prowadzić do nich

Jeżeli już mamy zainstalowane Kadu i nie ma polskiej wersji to doraźnie można zrobić to przekopiowując ze źródeł plik kadu/po/pl/kadu.mo do katalogu z localami, np. w Mandrake 9.0 jest to /usr/share/locale/pl/LC_MESSAGES/kadu.mo

Z powrotem na górę dokumentu

5. Jak to zrobić - wysyłanie sms


Program Kadu ma możliwość wysyłania sms-ów. W tym celu należy skompilować program sms, który się znajduje w paczce ze źródłami. Aby tego dokonać w katalogu sms wydajemy dwa polecenia:

  1. make, i jeżeli wszystko przebiegnie pomyślnie tzn. nie będzie błędów,
  2. make install.

W większości przypadków to działa jednakże program ten nie jest tworzony przez zespół Kadu i nie bierzemy odpowiedzialności za jego kompilacje. W razie problemów w katalogu sms znajduje się szczątkowa dokumentacja autora.

Jeżeli wszystko przebiegło bez błędów należy tylko w oknie konfiguracyjnym Kadu podać ścieżkę dostępu do tego programu a wiec:

U mnie (a jest to domyślna ścieżka przy instalacji) ta ścieżka wygląda tak: /usr/local/bin/sms

Oczywiście ten program musi się tam znajdować jeżeli masz go zainstalowany gdzie indziej ścieżka musi prowadzić do niego

Do wersji 0.3.3-pre5 program ten kompiluje się wraz z programem Kadu i otrzymuje nazwę kadusms, ścieżka dostępu ustawia się samoczynnie istnieje jednak możliwość wyboru innego programu. Wtedy musimy podać do niego ścieżkę dostępu.

Domyślnie program jako adresata wpisuje nazwę użytkownika w formie: użytkownik@localhost.localdomain

Aby to zmienić w katalogu domowym tworzymy plik o nazwie: .smsrc w treści którego wpisujemy: mailaddr=moja_nazwa Od tej pory sms będzie podpisany tak jak tego sobie życzysz.

Od wersji 0.3.3-rc1 program do wysyłania sms jest już autorstwa Kadu Team i jest integralną częścią programu Kadu. Nie wymaga odrębnej kompilacji

Z powrotem na górę dokumentu

6. Jak to zrobić - patch KaduBis aby obrazków było więcej


Na wersję 0.3.2 został utworzony patch, dzięki któremu można mieć w Kadu więcej obrazków zwanych emotikonami. Można go pobrać stąd: http://kadu.net/kadubis.tar.gz

Aby się nim posłużyć należy pobrany plik rozpakować do katalogu ze źródłami Kadu, tak aby drzewo wyglądało następująco:

../Źródła_Kadu
        /kadu
        /kadubis
        kadu-gg3d_emotions.path

Plik kadu-gg3d_emotions.path jest wewnątrz katalogu kadubis. Należy go więc przenieść oczko wyżej aby wszystko się zgadzało z powyższym schematem
Użyć programu patch w następujący sposób:
# patch -p0 < kadu-gg3d_emotions.patch

  1. powinny pokazać się trzy linijki z informacją o pomyślnym patchowaniu plików
  2. następnie zbudować normalnie Kadu
  3. katalog images wraz z zawartością kopiujemy do katalogu (domyślny dla standardowej instalacji):

/usr/local/kde/share/apps/kadu/images

Po poprawnej instalacji pozostaje jeszcze tylko w okienku konfiguracyjnym podać ścieżkę do katalogu images, zrestartować Kadu i powinno działać

Od wersji 0.3.3 KaduBis jest już dostępny jako thems domyślny i nie jest potrzebny restart Kadu

!!! Patch KaduBis można nakładać tylko na wersję 0.3.2 !!!

Na stronie Kadu.net jest do pobrania thems kompatybilny z Gadu-Gadu 5.0. Wystarczy go rozpakować do katalogu z emotikonami

Z powrotem na górę dokumentu

7. Jak to zrobić - Szyfrowanie rozmów


Od wersji 0.3.3-pre3 jest dostępna opcja eksperymentalnego szyfrowania rozmów w ssl. Aby móc go używać musimy wykonać następujące czynności:

  • Kadu kompilujesz z opcja --with-openssl, (od wersji 0.3.3.rc2 opcja ta jest domyślną jeżeli nie używasz instalatora)
  • generujesz sobie klucz publiczny (w oknie konfiguracyjnym), Tylko długość1024 jest obsługiwana przez protokół, jeżeli jeszcze masz możliwość (która będzie w najbliższym czasie zablokowana) korzystaj tylko z niej,
  • w menu kontekstowym w oknie listy kontaktów, dla konkretnego kontaktu z listy wybieramy opcje Wyślij mój klucz publiczny (taka z kłódka). Twój klucz zostanie wysłany adresatowi.
  • jeśli masz czyjś klucz publiczny, to w oknie chat możesz manipulować klawiszem z kłódką. Jeśli jest zamknięta to wysyłasz wiadomość zaszyfrowaną,
  • teoretycznie szyfrowanie ssl jest kompatybilne z szyfrowaniem z PowerGG z pod Windows.

Z powrotem na górę dokumentu

Valid HTML 4.01!