Dokumentacja:Instalacja

Kadu

Wstęp

W dokumencie tym postaram się wyjaśnić jak zainstalować 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.

Wymagane pakiety

Pakiety wymagane przy instalacji pakietu binarnego np. kadu-0.4.0-RC1mdk.i586.rpm

  • Glibc
  • Glibc-devel
  • glibc_lsb
  • freetype2
  • libgcc1
  • XFree86-libs
  • libjpeg62 6b
  • liblcms1
  • libmng1
  • libpng3
  • libqt3 wersja >=3.1.0
  • libstdc++5
  • zlib1
  • libopenssl 0.9.7
  • libexpat0
  • libfontconfig1
  • libsndfile w wersji >=1.0

Istotną biblioteką dla wersji od 0.4.0-cvs jest libsndfile w wersji >=1.0 Nie wszystkie dystrybucje ją posiadają konieczne więc będzie jej pobranie z Internetu.

Pakiety dodatkowe wymagane przy kompilacji źródeł

  • gcc
  • Glibc-devel
  • freetype2-devel
  • XFree86-devel
  • libopenssl 0.9.7-devel
  • zlib1-devel
  • libjpeg62-devel 6b
  • libpng3-devel
  • libqt3-devel w wersji >= 3.1.0
  • libstdc++5-devel
  • libsndfile-devel w wersji >= 1.0

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. Chciałbym uczulić na obecność w systemie pakietów developerskich czyli pakietów z bibliotekami nagłówkowymi SĄ ONE NIEZBĘDNE PRZY KOMPILACJI ŹRÓDEŁ. Częste pytania typu: "./configure nie znajduje Qt" to brak nie wspomnianego programu ale właśnie bibliotek nagłówkowych. Więcej szczegółów znajdziesz w rozdziale poniżej.

Jak To Zrobić - instalacja

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

Instalacja z pakietów binarnych

Instalacja pakietu binarnego kadu-nr_wersji.i586.rpm (zalecana dla początkujących)

Pobieramy pakiet binarny ze strony http://www.kadu.net/ dla swojej dystrybucji w naszym przypadku jest to Mandrake Logujemy się do systemu jako root poleceniem 

  bash-2.05b$ su -
  Password: "choć nic nie widać to tutaj piszesz hasło root-a i naciskasz ENTER"
  [root@localhost]#

Przechodzimy do katalogu gdzie pobraliśmy pakiet binarny 

  [root@localhost]# cd ~/nazwa katalogu gdzie jest plik rpm

wydajemy polecenie: 

  [root@localhost]# rpm -ivh kadu-nr_wersji.i586.rpm

Jeżeli rpm nie zgłosił błędów i ujrzeliśmy takie coś: 

  [root@localhost]# rpm -ivh kadu-0.3.6-1mdk.i586.rpm
  Preparing...                ########################################### [100%]
  1:kadu                      ########################################### [100%]
  [root@localhost]#

To oznacza, że nasze kadu zainstalowało się bez problemów. Wpisujemy na konsoli polecenie: 

  [root@localhost]# exit

i jako zwykły użytkownik wydajemy polecenie: 

  bash-2.05b$ kadu

Od tego momentu cieszymy się z używania :)

Instalacja ze źródeł

Pierwszym krokiem będzie rozpakowanie źródeł. Oczywiście można to zrobić poleceniem: 

  bash-2.05b$ tar xjf kadu-nr_wersji.tar.bz2

ale można oczywiście prościej np.: w Midnight Commander (UWAGA: ark nie nadaje się do tego, bo zmienia daty modyfikacji plików). Logujemy się w systemie z uprawnieniami administratora poleceniem: 

  bash-2.05b$ su
  Password: "choć nic nie widać to tutaj piszesz hasło root-a i naciskasz ENTER"
  [root@localhost]#

Wyboru modułów dostępnych ze źródłami Kadu dokonujemy w ukrytym pliku .config edytując go dowolnym edytorem tekstu (Ten fragment chyba można opuścić, skoro pojawiają się szczegółowe opisy modułów w innej części Wiki - Sad.) 

  # KADU CONFIGURATION FILE
  # y - yes, compiled into kadu (static)	<- moduł będzie kompilowany statycznie
  # m - module, compiles as .so (shared)	<- moduł będzie kompilowany dynamicznie jako bibloteka *.so
  # n - no, module disabled		<- moduł nie będzie kompilowany
  
  ######## dokowanie #######
  module_docking=y			<-- podstawowy moduł obsługi dokowanie musi być załadowany.
  module_x11_docking=m		<-- moduł dokowania dla menadżerów okien typu KDE, Gnome.
  module_wmaker_docking=n		<-- moduł dokowania w WindowMaker.
  module_desktop_docking=n		<-- moduł dokowania w dowolnym miejscu ekranu. Symuluje
  					dokowanie w menadżerach które nie obsługują dokowania.
  ######## dźwięk ########
  module_sound=y 			<-- podstawowy moduł obsługi dźwięku musi być załadowany
  module_ext_sound=m 		<-- obsługa dźwięku przez zewnętrzny program, trzeba podać do
       				niego ścieżkę w oknie konfiguracji.
  module_dsp_sound=m 		<-- obsługa dźwięku przez /dev/dsp.
  module_arts_sound=n 		<-- obsługa dźwięku przez serwer aRts
  module_esd_sound=n 		<-- obsługa dźwięku przez esd (Gnome itp)
  module_nas_sound=n 		<-- sieciowa obsługa dźwięku
  module_alsa_sound=n 		<-- obsługa dźwięku przez ALSA
  ####### powiadamianie #######
  module_notify=y 			<-- podstawowy moduł obsługi powiadamiania  musi być załadowany
  module_window_notify=m 		<-- powiadamianie wyskakującym okienkiem 
  module_hints=m 			<-- powiadamianie dymkiem
  ###### Speech syntezator mowy ######
  module_speech=n 			<--łączy Kadu z zewnętrznym programem "powiedz". Umożliwia odczytywanie
  			tekstu i powiadamianie  syntetyczną mową.
  ######## p2p ######
  module_dcc=m 			<-- podstawowy moduł obsługi połączeń bezpośrednich
  module_voice=m 			<-- podstawowy moduł obsługi rozmów głosowych
  ##### sms ######
  module_sms=m 			<-- podstawowy moduł obsługi SMS
  module_default_sms=m 		<-- obsługa podstawowych bramek sms: PlusGSM, ERA, Idea
  ########## Pozostałe ######
  module_account_management=m 	<-- umożliwia rejestrację nowych użytkowników powinien być zainstalowany
  module_encryption=m 		<-- Szyfrowanie rozmów przez OpenSSL
  module_autoaway=m 		<-- automatyczna zmiana statusu po zadanym czasie
  module_config_wizard=m 		<-- moduł startowy generalnie potrzebny przy pierwszym
  				uruchomieniu. Pomoże założyć konto na serwerze Gadu-Gadu
  				oraz skonfigurować program.
  module_autoresponder=m 		<-- automatycznie odpowie na wiadomość nadesłana podczas
  	 			naszej nieobecności przy klawiaturze gdy autoaway zmieni
  				status na zajęty.
  module_echo=n 			<--moduł testowy (co to jeszcze robi w żródłach Kadu)
  ####### Moduły nie wspierane przez Kadu Team ######
  (jeżeli go nie ma w źródłach zostanie automatycznie pobrany z kadu.net wymagane jest połączenie sieciowe)
  module_tcl_scripting=n		<-- obsługa skryptów TCL bardzo fajne w połączeniu
  				z KaduPro (Takie coś jak PowerGG w Windows)
  module_xmms=n			<-- pobiera dane z XMMS i dołącza je do opisu.
  module_amarok=n			<-- pobiera dane z AmaroK i dołącza je do opisu.
  module_filedesc=n			<-- pobiera dane z pliku i dołącza je do opisu.
  module_mail=n			<-- obsługuje zewnętrzne kąta e-mail
  module_spellchecker=n		<-- sprawdza i zaznacza błędy w tekście pisanym w oknie rozmowy.
  module_pcspeaker=n		<-- obsługuje głośnik systemowy
  module_xosd_notify=n		<-- wyświetlanie komunikatów w stylu XOSD
  module_weather=n			<-- podaje prognozę pogody dla skonfigurowanego kontaktu
  module_ao_sound=n		<-- obsługuje dźwięk przez bibliotekę ao (alsa, oss, esd, aix, irix, nas, sun, netbsd, openbsd)
  module_ext_info=n			<-- umożliwia przechowywanie dodatkowych informacji o kontaktach
  module_dcopexport=n		<-- gratka dla shellomanów czyli przekazywanie poleceń systemowych bezpośrednio z okna rozmowy.
  
  ########## Ikony #######
  # y - yes, install with kadu	<-- temat będzie zainstalowany (jeżeli go nie ma w źródłach zostanie automatycznie
  			pobrany z kadu.net wymagane jest połączenie sieciowe)
  # n - no, icon theme disabled 	<-- temat zostanie pominięty
  icons_default=y
  icons_crystal16=n
  icons_crystal22=n
  icons_nuvola16=n
  icons_nuvola2

W powstałym katalogu korzystamy ze skryptu Instaluj, który w większości przypadków jest najlepszym rozwiązaniem, lub wydajemy polecenia: 

  [root@localhost]#./configure
  [root@localhost]# make
  [root@localhost]# make install

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=/twój_podany_katalog
  • 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

Jak To Zrobić - ustawianie zmiennej QTDIR

Często zdarzają się problemy ze zmienną QTDIR (zwłaszcza w RedHat lub Mandrake) co skutkuje nieznalezieniem biblioteki Qt. Zakładam, że masz zainstalowane Qt 3.0.x. Wpierw musisz namierzyć gdzie znajduje się Qt w Twoim systemie. Ścieżka może być różna, np. w Mandrake jest to /usr/lib/qt3, gdzie indziej może to być np. /usr/local/qt czy /usr/local/lib/qt3. Następnie przed kompilacją możesz wykonać z konsoli: 

export QTDIR=/usr/lib/qt3


Innym sposobem może być dopisanie (jako root) na końcu pliku /etc/profile następujących linii: 

   $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


Można też dopisać do /etc/ld.so.conf ścieżkę do bibliotek i plikow wykonywalnych z pakietu Qt: 

   /usr/lib/qt3/lib


Zwróć uwagę na ścieżkę do biblioteki Qt3 - może ona się różnić w zależności od dystrybucji.

Jak To Zrobić - instalacja dodatkowych modułów

Zanim przeczytasz poniższe rady sprawdź czy w repozytorium Kadu dla Twojego systemu nie ma gotowej paczki binarnej z modułem, który chcesz zainstalować. Jeśli jest, to po prostu ściągnij ją i zainstaluj. Wówczas pozostanie Ci jedynie załadować moduł w Zarządcy Modułów (F4).

Aby samodzielnie skompilować i zainstalować dodatkowe moduły należy:

  1. Rozpakować źródła dokładnie tą samą wersję Kadu, którą mamy w systemie.
  2. Rozpakować źródła modułu.
  3. Źródła modułu przekopiować do katalogu modules w źródłach Kadu.
  4. Wyedytowąć ukryty plik .config wpisując przy nazwach modułów =m, chyba że któregoś modułu nie potrzebujesz wtedy =n.
  5. Uruchomić ./configure.
  6. Przejść do katalogu z modules i wykonać make a nastepnie jako root make install
  7. UWAGA!!! wszystkie zainstalowane wcześniej moduły przy instalacji zostaną usunięte.
  8. W zarządcy modułów wybrać zainstalowany moduł i załadować go.

TIP: Jeśli nie chcesz zainstalować nowy moduł nie narażająć się na utratę innych modułów, możesz pominąć make install i samodzielnie skopiować pliki nazwa_modułu.so, nazwa_modułu.desc do $prefix/share/kadu/modules, zawartość katalogu data (jeśli istnieje do) $prefix/share/kadu/modules/data/nazwa_modulu oraz pliki nazwa_modulu_*.qm z podkatalogu translations (jeśli są) do $prefix/share/kadu/modules/translations. Aby tego dokonać potrzebujesz uprawnień roota

Jak to zrobić - instalacja dodatkowych zestawów emotikonów

Na stronie http://www.kadu.net/ jest do pobrania temat kompatybilny z Gadu-Gadu 5.0. Wystarczy go rozpakować do katalogu z emotikonami 

  tar xjf kadu-emots-zestaw288.tar.bz2
  cp -P -r -v ./GG5.0/  $PREFIX/share/apps/kadu/themes/emoticons

Oczywiście $PREFIX to ścieżka jaką narzuciłeś przy instalacji. W instalatorze domyślnie $PREFIX=/usr, konfigurując "ręcznie" ./configure domyślnie jest $PREFIX=/usr/local

Najnowsze wersje posiadają już zestaw kompatybilny z Windows Gadu-Gadu 5.0.4 i nie wymagają dodatkowej instalacji. Natomiast istnieje możliwość instalowania nowych zestawów, które są zgodne z Windows Gadu-Gadu, gdyż obecnie Kadu stosuje tą samą metodę sterownia emotikonami. Dodatkowe emotikony wystarczy skopiować do katalogu z emotikonami jak wyżej i wówczas będą dostępne jako oddzielny zestaw, bądź do katalogu ../gadu-gadu/3 lub kolejny nr, wtedy będą dołączone do istniejącego zestawu.

Jak to zrobić - szyfrowanie rozmów

W Kadu jest dostępna opcja szyfrowania rozmów przy pomocy SSL. Aby móc go używać musimy wykonać następujące czynności:

1. Kadu musi być skompilowane z obsługą modułów. Przed kompilacją sprawdź w pliku .config czy moduł encryption jest zaznaczony do kompilacji (literka m lub y) 2. W Menu wybieramy Menadżera modułów i ładujemy moduł encryption 3. Przechodzimy do okna konfiguracji zakładka Chat. Zaznaczamy opcje "Użyj szyfrowania" i generujemy sobie klucz prywatny i publiczny (w oknie konfiguracyjnym), 4. w menu kontekstowym w oknie listy kontaktów, dla konkretnego kontaktu z listy wybieramy opcje Wyślij mój klucz publiczny (taka z kłódką). Twój klucz zostanie wysłany adresatowi. 5. 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ą, 6. szyfrowanie SSL jest kompatybilne z szyfrowaniem z PowerGG z pod Windows. Klucze publiczne są przenośne z Windows do Linuksa i z Linuksa do Windows.

Jak to zrobić - polska wersja językowa

Od wersji 0.3.5 kadu jest niezależne od lokalizacji systemu. Wyboru języka dokonuje się w oknie konfiguracji

Aby Kadu było od razu w polskiej wersji językowej locale w systemie muszą być ustawione na pl_PL. Można to sprawdzić wykonując polecenie: 

  [root@localhost]$ locale
  
  LANG=pl_PL
  LC_CTYPE=pl_PL
  LC_NUMERIC=pl_PL
  LC_TIME=pl_PL
  LC_COLLATE=pl_PL
  LC_MONETARY=pl_PL
  LC_MESSAGES=pl_PL
  LC_PAPER=pl_PL
  LC_NAME=pl_PL
  LC_ADDRESS=pl_PL
  LC_TELEPHONE=pl_PL
  LC_MEASUREMENT=pl_PL
  LC_IDENTIFICATION=pl_PL
  LC_ALL=

Jeżeli zamiast pl_PL zobaczymy coś innego to znaczy że system nasz nie jest ustawiony na język polski. W zależności od dystrybucji (w Mandrake musisz mieć zainstalowany pakiet locales-pl***.mdk.rpm, w Debianie wykonaj dpkg-reconfigure locales) zmiany dokonuje się za pomocą różnych narzędzi lub edytując pliki konfiguracyjne. W jaki sposób musisz poszukać w HOWTO do swojej dystrybucji.

Kompilacja Kadu na MacOS X

Kompilacja Kadu na MacOS X

Kompilacja Kadu na Solarisie x86

Nalezy w pliku .config wylaczyc moduly zalezne od sound,

a w pliku naglowkowym kadu.h dodac 
#include <fcntl.h>

Sprawdzone kadu 0.5 z 'SunOS 5.11 NexentaOS_20061012 i86pc i386 i86pc Solaris'

Copyright 2001-2004 Kadu Team

Źródło: "http://www.kadu.net/w/Dokumentacja:Instalacja"
Osobiste