| 1 | = Instalacja na dowolnym systemie Linux = |
| 2 | |
| 3 | Instalacja systemu może być wykonana w zasadzie na dowolnym systemie Linux/Unix na którym jesteśmy w stanie dostarczyć wymagane przez system pakiety. Poniżej opisany został proces instalacji krok po kroku. |
| 4 | |
| 5 | == 1. Instalacja wymaganych pakietów == |
| 6 | |
| 7 | Poniżej została zamieszczona odpowiednia lista, można jej użyć to stworzenia własnego skryptu instalacyjnego. W przypadku pakietów Postgres oraz PHP należy zwrócić uwagę na to aby były we właściwych wersjach (opisane w komentarzu). |
| 8 | |
| 9 | {{{ |
| 10 | #Base tools |
| 11 | ssh |
| 12 | vim |
| 13 | fonty |
| 14 | mc |
| 15 | nmap |
| 16 | ngrep |
| 17 | sed |
| 18 | wget |
| 19 | gzip |
| 20 | adduser |
| 21 | useradd |
| 22 | bzip2 |
| 23 | unzip |
| 24 | rsync |
| 25 | less |
| 26 | |
| 27 | # System tools |
| 28 | sudo |
| 29 | iptables |
| 30 | cron |
| 31 | iproute |
| 32 | tcpdump |
| 33 | |
| 34 | # Additional tools |
| 35 | apt-show-versions |
| 36 | gcc |
| 37 | g++ |
| 38 | cpp |
| 39 | make |
| 40 | |
| 41 | # Backup tools |
| 42 | mkisofs |
| 43 | hdparm |
| 44 | dvd+rw-tools |
| 45 | mt-st |
| 46 | smbfs |
| 47 | autofs |
| 48 | |
| 49 | # Processing tools |
| 50 | imagemagick |
| 51 | gs-common |
| 52 | html2ps |
| 53 | latex2rtf |
| 54 | antiword |
| 55 | gnuhtml2latex |
| 56 | |
| 57 | # Services |
| 58 | postgresql # >= 8.3 |
| 59 | apache2 |
| 60 | php5 # >= 5.2.6 |
| 61 | php5-cli |
| 62 | php-pear |
| 63 | php5-pgsql |
| 64 | php5-imap |
| 65 | php5-dev # zawiera narzędzia developerskie php m.in. plik phpize |
| 66 | php5-gd |
| 67 | php5-sybase |
| 68 | php5-odbc |
| 69 | subversion |
| 70 | openssl |
| 71 | ssl-cert # lub inny pakiet z certyfikatami dla apache |
| 72 | |
| 73 | # Pakiety PEAR, mogą być wyższe niż wskazane |
| 74 | pear channel-update pear.php.net |
| 75 | pear install Console_Getopt |
| 76 | pear install Auth_SASL |
| 77 | pear install Mail_Mime |
| 78 | pear install Net_SMTP |
| 79 | pear install Crypt_Rc4 |
| 80 | pear install Date |
| 81 | pear install HTTP_Request |
| 82 | pear install Mail |
| 83 | pear install Mail_Mime |
| 84 | pear install Mail_MimeDecode |
| 85 | pear install Net_SMTP |
| 86 | pear install Net_Socket |
| 87 | pear install Net_URL |
| 88 | pear install SOAP-0.11.0 |
| 89 | pear install OLE-0.6.1 |
| 90 | pear install Spreadsheet_Excel_Writer-0.9.1 |
| 91 | pear install Mail_Queue |
| 92 | pear install HTML_Template_Flexy |
| 93 | |
| 94 | # Instalacja dodatkowych modułów, których może nie być w pakietach |
| 95 | # Aby zainstalować należy użyć paczki ed-lenny-installer.tar.gz, rozpakować i wejść do katalogu katalogu w którym znajduje się skrypt install.sh. |
| 96 | |
| 97 | # Zend Optimizer |
| 98 | ./bin/optimizer.sh |
| 99 | |
| 100 | # Rozszerzenie POP3 dla php |
| 101 | ./bin/pop3.sh |
| 102 | cp conf/pop3.ini /etc/php5/conf.d/ |
| 103 | |
| 104 | }}} |
| 105 | |
| 106 | == 2. Zakladanie kont i konfiguracja grup dla edokumenty == |
| 107 | Dla poprawnego i bezpiecznego działania systemu wymagane jest założenie odpowiednich kont i grup systemowych. Przyjęliśmy że możliwość zapisu dla serwera będzie realizowana w oparciu o grupę edokumenty do której dopisywany jest użytkownik serwera (np. www-data, apache, http). |
| 108 | |
| 109 | {{{ |
| 110 | adduser --ingroup users edokumenty |
| 111 | groupadd edokumenty |
| 112 | adduser edokumenty -g edokumenty |
| 113 | adduser www-data -g edokumenty |
| 114 | }}} |
| 115 | |
| 116 | == 3. Aktywacja modulow Apache == |
| 117 | Należy upewnić się że poniżej wymienione moduły zostały aktywowane w apache: |
| 118 | * php5 |
| 119 | * ssl |
| 120 | * rewrite |
| 121 | * userdir |
| 122 | * vhost_alias |
| 123 | |
| 124 | == 4. Konfiguracja Apache == |
| 125 | |
| 126 | Zalecane miejsce na system to katalog ''home/edokumenty'', można jednak wybrać inny katalog na instalację ważne by wówczas odpowiednio skonfigurować tą lokalizację: |
| 127 | |
| 128 | {{{ |
| 129 | ServerAdmin admins@betasoft.pl |
| 130 | ServerSignature Off |
| 131 | DocumentRoot /home/edokumenty/public_html |
| 132 | DirectoryIndex index.html index.cgi index.pl index.php index.xhtml engine |
| 133 | |
| 134 | # Aliasy dla domyślnych systemów |
| 135 | <IfModule mod_alias.c> |
| 136 | Alias /edokumenty /home/edokumenty/public_html |
| 137 | </IfModule> |
| 138 | |
| 139 | # Handler dla plików php |
| 140 | <FilesMatch "(.+[.]inc$|.+[.]php$|engine)"> |
| 141 | SetHandler application/x-httpd-php |
| 142 | </FilesMatch> |
| 143 | |
| 144 | # Domyślny katalog dla redirect |
| 145 | <Directory /home/*/public_html/> |
| 146 | Options -Indexes FollowSymLinks MultiViews |
| 147 | AllowOverride Options |
| 148 | Order allow,deny |
| 149 | allow from all |
| 150 | </Directory> |
| 151 | }}} |
| 152 | |
| 153 | Dodatkowo należy umożliwić większy limit dla żądań HTTP |
| 154 | {{{ |
| 155 | echo "LimitRequestFieldSize 16384" >> /etc/apache2/apache2.conf |
| 156 | }}} |
| 157 | |
| 158 | == 5. Konfiguracja PHP == |
| 159 | Oto przykładowy skrypt zmieniający odpowiednie ustawienia w php.ini. |
| 160 | Warto zwrócić uwagę aby PHP consolowe (może mieć osobną konfigurację) również posiadało te ustawienia. |
| 161 | |
| 162 | default_charset = UTF-8 |
| 163 | memory_limit = 96M |
| 164 | upload_max_filesize = 32M |
| 165 | post_max_size = 32M |
| 166 | mbstring.internal_encoding = UTF-8 |
| 167 | enable_dl = On |
| 168 | |
| 169 | == 6. Konfiguracja PostgreSQL 8.3 == |
| 170 | W pliku postgresql.conf: |
| 171 | {{{ |
| 172 | default_with_oids = on |
| 173 | }}} |
| 174 | |
| 175 | W pliku pg_hba.conf dodajemy poniższą linijkę, lub w dowolny inny sposób zapewniamy możliwość łączenia się przez socket z bazą edokumenty bez hasła. |
| 176 | {{{ |
| 177 | local edokumenty all trust |
| 178 | }}} |
| 179 | |
| 180 | Tworzymy użytkowników (wszystkie pytania przy tworzeniu odpowiadamy NIE - N) i bazę danych i dodajemy język plpgsql |
| 181 | {{{ |
| 182 | sudo -u postgres createuser http |
| 183 | sudo -u postgres createuser edokumenty |
| 184 | |
| 185 | sudo -u postgres createdb -E UTF8 edokumenty -O edokumenty |
| 186 | sudo -u postgres createlang -d edokumenty plpgsql |
| 187 | }}} |
| 188 | |
| 189 | == 7. Utworzenie public_html i pozostałych katalogów == |
| 190 | Należy utworzyć wymagane katalogi oraz umożliwić zapis do nich TYLKO na czas instalacji procesowi serwera |
| 191 | |
| 192 | {{{ |
| 193 | cd $INSTALL_DIR |
| 194 | |
| 195 | chgrp edokumenty ~edokumenty |
| 196 | chmod g+w ~edokumenty |
| 197 | |
| 198 | mkdir -p ~edokumenty/public_html/apps/edokumenty |
| 199 | chgrp edokumenty ~edokumenty/public_html/apps/edokumenty |
| 200 | chmod g+w ~edokumenty/public_html/apps/edokumenty |
| 201 | |
| 202 | cp lib/engine ~edokumenty/public_html/ |
| 203 | chown edokumenty:users -R ~edokumenty/public_html |
| 204 | }}} |
| 205 | |
| 206 | == Konfiguracja domyślnego backupu == |
| 207 | Polecene jest ustawienie domyślnych skryptów do crona (można je znaleźć w paczce instalatora dla Debian). Skrypty zrucają bazę danych i pliki używane przez system. Najczęściej polecamy aby podmontować pod katalog /mnt/backup jakiś dodatkowy dysk (może być zewnętrzny). Więcej o backapach znajdziesz w odpowiedniej sekcji wiki. |
| 208 | |
| 209 | {{{ |
| 210 | ./bin/mk_backup_dirs.sh |
| 211 | cd $INSTALL_DIR |
| 212 | cp lib/backup/backup_db /etc/cron.daily/ |
| 213 | cp lib/backup/backup_repos /etc/cron.daily/ |
| 214 | |
| 215 | cp conf/exclude.conf /etc/backup |
| 216 | cp conf/backup.conf /etc/backup |
| 217 | }}} |