WWWOFFLE - Eksplorator Offline World Wide Web - Wersja 2.6 ========================================================== Wymagane jest tylko 10 kroków, aby zainstalować WWWOFFLE z kodu źródłowego do w pełni pracującego i przetestowanego programu. Jeśli używasz wydania binarnego (Win32), wtedy powinieneś pominąć pierwsze 3 kroki. Kompilacja ---------- Następne dziesięć kroków powinno być wystarczające do zademonstrowania działającego WWWOFFLE. 1) Wyedytuj plik Makefile i ustaw poniższe parametry: Nazwę i port serwera (LOCALHOST) - domyślnie localhost:8080 Miejsce zainstalowania (INSTDIR) - domyślnie /usr/local Katalog buforowanych stron (SPOOLDIR) - domyślnie /var/spool/wwwoffle Położenie pliku konfiguracji (CONFDIR) - domyślnie /var/spool/wwwoffle Opcjonalnie język stron web (LANG) - domyślnie tylko Angielski Opcje kompilatora (CC i CFLAGS). (Plik Makefile zawiera pewne specyficzne opcje maszyn dla systemów nielinuksowych, które mogą wymagać odkomentowania.) 2) Skompiluj programy make all **** Ważne **** Od tej wersji WWWOFFLE naprzód, nie będę dostarczał kodu źródłowego C, który jest generowany z plików źródłowych lex (*.l). Oznacza to, że będziesz potrzebował zainstalowanej i działającej wersji lex lub flex, aby skompilować WWWOFFLE. **** Ważne **** 3) Zainstaluj programy i utwórz katalog buforowanych stron (spool) make install **** Ważne **** Jeśli już używasz WWWOFFLE, powinieneś zatrzymać obecnie działającą wersję programu, zanim przeprowadzisz instalację nowej wersji. **** Ważne **** Powinieneś zwrócić uwagę na komunikaty podawane przez make, które poprzedzone są ciągiem znaków 'WWWOFFLE:', informacje te są ważne i oznaczają, że proces instalacji napotkał na coś, co wymaga twoj interwencji. **** Ważne * Jeśli obecnie używasz wersji 2.0/2.1 **** *MUSISZ* uruchomić program endian-cache, aby przekonwertować twój bufor z zaniechanego formatu wersji 2.0/2.1 do formatu wersji 2.2. Przeczytaj plik CONVERT, aby zasięgnąć więcej szczegółowych informacji. **** Ważne * Jeśli obecnie używasz wersji 2.0/2.1 **** **** Ważne * Jeśli obecnie używasz wersji 1.x **** *MUSISZ* uruchomić program upgrade-cache, aby przekonwertować twój bufor z formatu wersji 1.x do formatu wersji 2.x. Przeczytaj plik UPGRADE, aby zasięgnąć więcej szczegółowych informacji. **** Ważne * Jeśli obecnie używasz wersji 1.x **** Konfiguracja ------------ 4) Wyedytuj plik konfiguracji. wwwoffle.conf **** Ważne * Jeśli musisz używać zewnętrznego serwera proxy HTTP **** Będziesz potrzebował dodania nazwy proxy i numeru portu do pliku konfiguracji wwwoffle.conf, w nim zawarte są instrukcje. **** Ważne * Jeśli musisz używać zewnętrznego serwera proxy HTTP **** **** Ważne * Jeśli obecnie używasz wersji 1.x **** Plik konfiguracji wwwoffle.conf został zmieniony, plik CHANGES.CONF wyjaśnia różnice od wersji 1.3. **** Ważne * Jeśli obecnie używasz wersji 1.x **** **** Ważne * Jeśli obecnie używasz wersji 2.x **** Plik konfiguracji wwwoffle.conf został zmieniony, plik CHANGES.CONF wyjaśnia różnice, natomiast upgrade-config.pl może naprawić je. **** Ważne * Jeśli obecnie używasz wersji 2.x **** 5) Uruchom działanie demona WWWOFFLE. wwwoffled -c wwwoffle.conf 6) Uruchom twoją Przeglądarkę WWW i ustaw localhost:8080 jako proxy. Zablokuj buforowanie pomiędzy sesjami w przeglądarce. Testowanie ---------- 7) a) Połącz się z Internetem b) Przekaż demonowi WWWOFFLE, że jesteś połączony wwwoffle -online c) Rozpocznij przeglądanie d) Przekaż demonowi WWWOFFLE, że jesteś rozłączony wwwoffle -offline e) Rozłącz się z Internetem 8) Powróć i przeglądnij ponownie strony, przy braku połączenia, przejdć do łączy, których nie odwiedziłeś tym razem (zobaczysz komunikat serwera WWWOFFLE w przeglądarce). 9) a) Połącz się z Internetem b) Przekaż demonowi WWWOFFLE, że jesteś połączony wwwoffle -online c) Przekaż demonowi WWWOFFLE, aby pobrał nowe strony wwwoffle -fetch d) Przekaż demonowi WWWOFFLE, że jesteś rozłączony wwwoffle -offline e) Rozłącz się z Internetem 10)a) Przejdź do http://localhost:8080/index/ i odszukaj nowo pobrane strony. b) Przeglądnij nowe strony, które właśnie zostały pobrane. Opcje Czasu Kompilacji ---------------------- W pliku wwwoffle.h znajduje się wiele dodatkowych opcji czasu kompilacji, które być może będziesz chciał zmienić. Pierwsze trzy są wkompilowane jako domyśle wartości opcji w sekcji StartUp pliku wwwoffle.conf. Są one również używane jako wkompilowane wartości domyślne dla programu wwwoffle. /*+ Domyślny numer portu używany przez demona http proxy. +*/ #define DEF_HTTP_PORT 8080 /*+ Domyślny numer portu używany do kontroli WWWOFFLE. +*/ #define DEF_WWWOFFLE_PORT 8081 /*+ Domyślny katalog spool. +*/ #define DEF_SPOOL "/var/spool/wwwoffle" /*+ Domyślny katalog pliku konfiguracji. +*/ #define DEF_CONF "/var/spool/wwwoffle" Następne cztery opcje ograniczją liczbę połączeń, które wwwoffled zaakceptuje w tym samym czasie oraz liczbę serwerów, które zostaną rozwidlone w odpowiedzi na to. Całkowita liczba MAX_SERVERS zawiera MAX_FETCH_SERVERS kiedy uruchomiony jest 'wwwoffle -fetch'. Opcje te są w wwwoffle.conf, ale absolutne wartości maksymalne mogą zostać zmienione tutaj jako wartości domyślne. /*+ Absolutna maksymalna liczba serwerów do rozwidlenia w całości. +*/ #define MAX_SERVERS 64 /*+ Domyślna całkowita liczba serwerów do rozwidlenia. +*/ #define DEF_MAX_SERVERS 8 /*+ Absolutna maksymalna liczba serwerów do rozwidlenia dla pobierania poprzednio żądanych stron. +*/ #define MAX_FETCH_SERVERS 48 /*+ Domyślna liczba serwerów do rozwidlenia dla pobierania stron. +*/ #define DEF_MAX_FETCH_SERVERS 4 Następna opcja jest liczbą katalogów poprzednich razów, które tworzoną historię pobranych stron podczas ostatnich połączeń. Jeśli ta liczba zostaje zmieniona, wymagana jest wtedy edycja pliku /var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html, poprzez dodanie łączy do tych katalogów. /*+ Liczba tworzonych katalogów poprzedniego razu (historia ostatnich połączeń). +*/ #define NUM_PREVTIME_DIR 3 Następna jest rozmiarem bufora, który jest używany podczas odczytu danych z bufora lub z gniazdka sieciowego. /*+ Rozmiar bufora w pamięci używanego podczas odczytu z bufora dyskowego lub gniazdka. +*/ #define READ_BUFFER_SIZE 1024 Następne dwie ustalają prawa dostępu, które są używane podczas tworzenia katalogów i plików w buforze (Nie zapomnij poprzedzić ich '0', bo są to liczby ósemkowe). /*+ Domyślne prawa dostępu podczas tworzenia katalogów. +*/ #define DEF_DIR_PERM 0755 /*+ Domyślne prawa dostępu przy tworzeniu plików. +*/ #define DEF_FILE_PERM 0644