Apache

Pieniä vinkkejä

• Apache-version tarkastaminen
  • httpd -v

Asennus

Linux

1. sudo apt-get update
2. sudo apt install libxml2-utils
3. sudo passwd ubuntu
4. sudo usermod -aG sudo ubuntu Asetetaan oikeus sudo-komentoihin
5. sudo apt update
6. sudo apt -y install apache2
7. sudo systemctl restart apache2
8. sudo iptables -I INPUT -m state --state NEW -p tcp --dport 80 -j ACCEPT
9. sudo netfilter-persistent save
10. sudo apt install curl
11. curl localhost --> pitäisi näkyä html-koodia
12. http://localhost tai http://127.0.0.1 tai http://IP-osoite --> pitäisi näkyä Apache2 Ubuntu Default Page.
    1. Tulostuvan sivun sijainti /var/www/html/index.html

Localhost-hakemiston muuttaminen

• Hakemistot kannatta perustaa oletushakemiston /var/www/html alihakemistoiksi. Html-hakemistossa ja alihakemistoissa olevien tiedostojen käyttäjät voivat olla tällöin esim. ubuntu:ubuntu tai oma käyttäjätunnus.
• Jos /home/käyttäjätunnus tai sen alihakemistoista halutaan tehdä localhost-hakemisto, www-data:www-data -oikeus täytyy antaa käyttäjätunnus-hakemistolle ja sen alihakemistoille sekä kaikille tiedostoille. Tällöin käyttäjätunnus-hakemiston muihin hakemistoihin, jotka ovat esimerkiksi Ubuntun Documents, ei enää ole suoraan pääsyä.
• Jos localhost-hakemisto halutaan kuitenkin muuttaa esimerkiksi hakemistoon /home/käyttäjätunnus/rantapallo:

1. sudo nano /etc/apache2/sites-available/000-default.conf
   1. DocumentRoot /home/käyttäjätunnus/rantapallo
2. sudo nano /etc/apache2/apache2.conf
   1. <Directory /home/käyttäjätunnus/>
3. sudo systemctl restart apache2
4. mkdir /home/käyttäjätunnus/rantapallo
5. cp /var/www/html/index.html /home/käyttäjätunnus/rantapallo
6. sudo chown -R www-data:www-data /home/käyttäjätunnus     -R muuttaa käyttäjätunnushakemiston ja sen alihakemistot käyttäjälle ja ryhmälle www-data:www-data
   1. Tarvittaessa www-data -käyttäjän olemassaolo tarkistetaan getent passwd www-data (tuloksena käyttäjätiedot) tai id -u www-data && id -g www-data (tuloksena tunnus) Ja tarvittaessa käyttäjä luodaan komennolla: sudo useradd -r -s /usr/sbin/nologin -d /var/www www-data
7. sudo chmod -R 755 /home/käyttäjätunnus
8. http://localhost

• Virhe: Selain ilmoittaa, ettei ole oikeutta nähdä tiedostoa.
  • Tarkistetaan tiedosto: sudo nano /etc/hosts
    • 127.0.0.1 localhost ja esim. 127.0.1.1 ?tietokoneen-nimi?
  • Katsotaan Apachen lokitiedosto: nano /var/log/apache2/error.log

Apache poistaminen

1. sudo apt remove apache2
2. sudo apt purge apache2

macOS

Apache on esiasennettu macOS-käyttöjärjestelmään, esimerkiksi Sequoia. Esiasennus ei ole välttämättä ajantasainen. Usein asennetaan asennusohjelma Homebrew, jolla voidaan asentaa ja päivittää viimeisin Apache-versio. Tällöin Apache asettuu Homebrew:n kansioon eikä ole sama kuin macOS-käyttöjärjestelmään asennettu.

• Vaihtoehtoisesti voi Apachen sijaan käyttää Nginx, joka on asennettava. Kannattaa verrata niiden ominaisuuksia. Ks. esim. Install Nginx & Multiple PHP Versions on macOS 15 Sequoia.
• Pikavinkit:
  • Virheloki: cat /var/log/apache2/error_log

Salasana on oman käyttäjätunnuksen salasana. Kertaalleen käynnistettyä ei tarvitse uudestaan käynnistää vaikka tietokone sammutetaan. Käynnistyminen saattaa kestää jonkin aikaa, jolloin tulee virheilmoituksia kuten 'Safari can't open the page "localhost" because Safari can't connect to the server "localhost".'

Apachen käynnistys:    sudo apachectl start
Uuudelleenkäynnistys kun apache on valmis:   sudo apachectl restart
Uudelleenkäynnistys välittömästi:    sudo apachectl -k restart
Pois päältä:   sudo apachectl stop

Testaus:    localhost    (anna selaimen hakuriviille, niin tulostuu: It works!)
Php.ini tiedoston tarkistus:    sudo apachectl -t
Versionumero:   httpd -v
Säätö: httpd.conf -tiedosto
Virheiden etsintä: sudo apachectl configtest

• Html, php ym. -sivujen kotihakemisto on joko käyttäjäkohtainen tai järjestelmäkohtainen. Ilman mitään toimenpiteitä tulostuva It works! -sivu on järjestelmäkohtainen ja se löytyy hakemistosta Macintosh HD/Library/WebServer/Documents/index.html.en mutta lähtökohtaisesti hakemistoon ei ole kirjoitusoikeuksia. Seuraavaksi kannattaa asentaa käyttäjäkohtainen Sites-hakemisto.

Käyttäjäkohtaisen Sites-hakemiston asentaminen

Tämä ohje suorittaa komennolla localhost eli http://localhost tiedostoja, jotka ovat /käyttäjänimi/Sites -hakemistossa eli hakemistossa ~/Sites

macOS Sequoia (11/2024)

• Merkittävin muutos aiempaan Catalinan asennusohjeeseen on php-ohjelmointikielen esiasennuksen poistuminen macOS 12 -versiosta alkaen.

https://discussions.apple.com/docs/DOC-250008906

• nano -editorin ohje: Tallennus ja poistuminen ctrl-x ja Y ja jos tehty muutoksia tai uusi tiedosto, vielä enter. Pelkkä tallennus ctrl-o ja enter. Ctrl-w etsii ja kun painat ctrl-w ja vain enter, siirtyy seuraavaan aikaisemmin haettuun kohtaan samalla hakusanalla.

1. Luo Sites -niminen hakemisto Finderissa oman käyttäjätunnuksen kotihakemiston juureen Macintosh HD/Käyttäjät/käyttäjänimesi/Sites tai pääteohjelmalla mkdir ~/Sites
   1. Lisää hakemistoon index.html -niminen tiedosto testausta varten: echo "<h1>Tulostuu omasta Sites-hakemistosta</h1>" > ~/Sites/index.html
2. Katso Finderissa sivupalkista talokuvakkeen kohdalta millä käyttäjänimellä olet kirjautunut tai pääteohjelmassa komennolla whoami ja käytä kyseistä käyttäjänimeä seuraavassa.
3. Ota kopiot muutettavista tiedostoista:
   1. cp /etc/apache2/httpd.conf ~/Sites
   2. cp /etc/apache2/extra/httpd-userdir.conf ~/Sites
4. sudo nano /etc/apache2/httpd.conf
   1. Poista seuraavista risuaidat:
      1. LoadModule userdir_module libexec/apache2/mod_userdir.so
      2. Include /private/etc/apache2/extra/httpd-userdir.conf
   2. Jos haluat ottaa käyttöön Perl-ohjelmointikielen poista myös risuaita LoadModule perl_module libexec/apache2/mod_perl.so
5. sudo nano /etc/apache2/extra/httpd-userdir.conf
   1. Poista risuaita riviltä:
      1. Include /private/etc/apache2/users/*.conf
6. sudo nano /etc/apache2/users/käyttajanimi.conf
   1. Lisää seuraavat rivit. Jos otit Perlin käyttöön, poista risuaita rivin edestä.

<Directory "/Users/<your short user name>/Sites/"> 
  AddLanguage en .en 
  AddHandler perl-script .pl
  #PerlHandler ModPerl::Registry   
  Options Indexes MultiViews FollowSymLinks ExecCGI 
  AllowOverride None 
  Require host localhost
</Directory>

7. Myönnä Apache-palvelimelle pääsyoikeus omaan Sites-hakemistoon ja sen alihakemistoihin:
1. chmod +a "_www allow execute" ~
8. Testaa edelliset muutokset, tulos pitäisi olla: Syntax OK
   1. apachectl configtest
9. sudo apachectl graceful
10. Anna selaimessa http://localhost/~käyttäjänimi/ ja pitäisi tulostua oman Sites-hakemiston index.html -tiedoston sisältö. Vastaavasti pelkkä localhost tulostaa järjestelmäkohtaisen It works!
    1. Hakemistoon voi asentaa esim. ohjelman MediaWiki joka käynnistetään localhost/mediawiki Katso myös aiheeseen liittyvä kohta MediaWiki#Collection
11. Tarvittaessa asetetaan käyttäjänimi.conf -tiedoston käyttöoikeus: sudo chmod 644 /etc/apache2/users/käyttäjänimi.conf
12. Tarvittaessa asetetaan oikeat kirjoitusoikeudet käyttäjän Sites-hakemistolle.
    1. sudo chmod -R a+w ~/Sites
    2. tai alihakemistokohtaisesti: sudo chmod -R a+w ~/Sites/alihakemisto

macOS Catalina (12/2021)

Big Sur

Lähde https://medium.com/@firstsquares/macos-catalina-set-up-localhost-e4a0b5d5be33

• nano -editorissa tallennus ja poistuminen ctrl-x ja Y ja uuden tiedoston ollessa kyseessä enter. Pelkkä tallennus ctrl-o ja enter. Uutta tiedostoa luotaessa on lisäksi painettava Y-kirjaimen jälkeen enter. Jos et ole tehnyt muutoksia ctrl-x poistuu suoraan. Ctrl-w etsii ja kun painat ctrl-w ja vain enter se siirtyy seuraavaan aikaisemmin haettuun kohtaan samalla hakusanalla.

1. Luo Sites-hakemisto Finderissa Macintosh HD/Käyttäjät/käyttäjänimesi/Sites tai pääteohjelmalla mkdir ~/Sites
   1. Lisää sinne index.html testausta varten: echo "<h1>Tulostuu omasta Sites-hakemistosta</h1>" > ~/Sites/index.html
2. Katso Finderissa sivupalkista talokuvakkeen kohdalta millä käyttäjänimellä olet kirjautunut ja käytä sitä seuraavassa. Tai pääteohjelmassa komennolla whoami
3. sudo nano /etc/apache2/httpd.conf
   1. Poista #-merkit seuraavien edestä ja tallenna tiedosto:

LoadModule php7_module libexec/apache2/libphp7.so
LoadModule userdir_module libexec/apache2/mod_userdir.so
Include /private/etc/apache2/extra/httpd-userdir.conf

1. 2. Lisää #-merkki kohtaan <Directory "/Library/WebServer/Documents"> ja alempana #Require all granted ja lisää sen alle rivi Require all Denied
   3. Jos asennus ei toimi, kokeile poista myös seuravista:

LoadModule authz_core_module libexec/apache2/mod_authz_core.so
LoadModule authz_host_module libexec/apache2/mod_authz_host.so
LoadModule include_module libexec/apache2/mod_include.so
LoadModule rewrite_module libexec/apache2/mod_rewrite.so

4. sudo nano /etc/apache2/extra/httpd-userdir.conf
1. Poista #-merkki riviltä Include /private/etc/apache2/users/*.conf
5. sudo nano /etc/apache2/users/käyttäjänimi.conf
   1. Lisää rivit ja tallenna.

<Directory "/Users/käyttäjänimi/Sites/">
AddLanguage en .en
AllowOverride All
Options Indexes MultiViews  FollowSymLinks
AllowOverride All
Require local
</Directory>

6. Aseta tiedoston käyttöoikeus: sudo chmod 644 /etc/apache2/users/käyttäjänimi.conf
7. Jos Apache on jo aikaisemmin käynnistetty, käynnistä uudelleen: sudo apachectl restart
8. Anna selaimessa: http://localhost/~käyttäjänimi/
   1. Hakemistoon voi asentaa nyt esim. ohjelman mediawiki joka käynnistetään localhost/mediawiki Katso myös aiheeseen liittyvä kohta MediaWiki#Collection
9. Asetetaan oikeat kirjoitusoikeudet hakemistoon
   1. sudo chmod -R a+w ~/Sites
   2. Tai alihakemistokohtaisesti: sudo chmod -R a+w ~/Sites/alihakemisto

Sierra (4/2017)

• Tämä ohje suorittaa komennolla http://localhost tiedostoja, jotka ovat /käyttäjänimesi/Sites -hakemistossa eli hakemistossa ~/Sites

Aivan alkup lähde (ei enää Sierra) https://getgrav.org/blog/mac-os-x-apache-setup-multiple-php-versions

1. Selvitä php-versio: php -v
2. Luo Sites-hakemisto Finderissa Macintosh HD/Käyttäjät/käyttäjänimesi/Sites tai pääteohjelmalla mkdir ~/Sites
   1. Lisää sinne index.html testausta varten: echo "<h1>Tulostuu omasta Sites-hakemistosta</h1>" > ~/Sites/index.html
3. Katso Finderissa sivupalkista talokuvakkeen kohdalta millä käyttäjänimellä olet kirjautunut ja käytä seuraavassa sitä.
4. sudo nano /etc/apache2/httpd.conf
   1. nano -editorissa ctrl-w etsii ja kun painat ctrl-w ja vain enter se siirtyy seuraavaan aikaisemmin haettuun kohtaan samalla hakusanalla. Tallennus ja poistuminen ctrl-x ja Y. Jos et ole tehnyt muutoksia ctrl-x poistuu suoraan.
   2. Hae ctrl-w hakusanalla: DocumentRoot
      1. DocumentRoot "/Library/WebServer/Documents" muunna DocumentRoot "/Users/käyttäjänimi/Sites"
      2. Muunna <Directory "/Users/käyttäjänimi/Sites">
      3. Samassa <Directory> -lohkossa muunna AllowOverride All
   3. Muunna käyttäjä ja ryhmä, jotka ovat selvästi alempana tiedosto kuin edellä olevat: User käyttäjänimi ja Group staff
   4. Hae ctrl-w hakusanalla: ServerName
      1. Poista ServerName local_server:80 edestä risuaita. Muutoin saat virheilmoituksia AH00557: httpd: apr_sockaddr_info_get() failed for x.local ja AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 127.0.0.1. Set the 'ServerName' directive globally to suppress this message
5. Jos PHP 7.0 lisää vielä kohdat jotka tämän ohjeen alla otsikolla "Jos PHP 7.0 lisää vielä"
6. ctrl-x ja Y ja enter
7. sudo apachectl -k restart
8. http://localhost ja pitäisi tulostua mitä index.html:ssä, mutta välttämättä hakemistossa olevat ohjelmat eivät toimi, vaan saat antaessasi localhost/ohjelmannimi virheilmoituksen "Forbidden 403, You don’t have permission to access /filename/ on this server". Tee seuraavat muutokset:

• Tarkista mikä Apache-versio on käytössä: httpd -v
• ls /etc/apache2/users/ Tarkista löytyykö tiedosto: käyttäjänimi.conf
  • Jos ei löydy: sudo nano /etc/apache2/users/käyttäjänimesi.conf ja anna salasana tai jos löytyy niin avaa tiedosto samalla tavoin
  • El Capitan, Yosemite, Mavericks: Liitä seuraava koodi tiedostoon JOS Apache 2.4 ja paina ctrl-x

<Directory "/Users/käyttäjänimesi/Sites/">
AllowOverride All
Options Indexes MultiViews FollowSymLinks
Require all granted
</Directory>

• • Liitä seuraava koodi tiedostoon JOS Apache 2.2 ja paina ctrl-x

<Directory "/Users/käyttäjänimesi/Sites/">
Options Indexes MultiViews
AllowOverride All
Order allow,deny
Allow from all
</Directory>

• Tarkista käyttöoikeus komennolla: ls -l /etc/apache2/users/käyttäjänimesi.conf joka pitäisi olla: -rw-r--r-- 1 root wheel 133 Aug 13 2015 käyttäjänimi.conf
  • Jos ei ole: sudo chmod 644 /etc/apache2/users/käyttäjänimi.conf
• Tarkista että seuraavien rivien edessä ei ole # -merkkiä. Hae ctrl-w -komennolla rivejä kirjoittamalla niiden alkuosa. Useamman edessä on ainakin El Capitanissa #-merkki. Poistu ctrl-x ja paina y ja enter.

sudo nano /etc/apache2/httpd.conf
LoadModule authz_host_module libexec/apache2/mod_authz_host.so
LoadModule authz_core_module libexec/apache2/mod_authz_core.so
LoadModule userdir_module libexec/apache2/mod_userdir.so
LoadModule php5_module libexec/apache2/libphp5.so
Include /private/etc/apache2/extra/httpd-userdir.conf

sudo nano /etc/apache2/extra/httpd-userdir.conf
Include /private/etc/apache2/users/*.conf

• Jos Apache on jo aikaisemmin käynnistetty, käynnistä uudelleen: sudo apachectl restart
• Kyseiseen hakemistoon voit asentaa nyt esim. ohjelman mediawiki joka käynnistetään localhost/mediawiki
• Katso myös aiheeseen liittyvä kohta MediaWiki#Collection

• Jos PHP 7.0 lisää vielä:
  • <FilesMatch "^\.([Hh][Tt]|[Dd][Ss]_[Ss])"> Require all denied </FilesMatch> -kohdan alle rivit:

<FilesMatch \.php$>
   SetHandler application/x-httpd-php
</FilesMatch>

• • ja etsi <IfModule dir_module> DirectoryIndex index.html </IfModule> ja lisää index.php riville, joka näyttää sitten seuraavalta: DirectoryIndex index.php index.html

• Jos saat virheilmoituksen "Forbidden 403, You don’t have permission to access /filename/ on this server" kun yrität avata oman käyttäjähakemiston tiedostoja, katso että käyttäjänimesi.conf tiedostossa on oikea apache-version mukainen koodi ja #-merkkejä ei ole rivien edellä kuten edellä on mainittu. (alkuperäinen ohje
  • Tee muutokset vaihtoehdon 2 kohdasta "Tarkista mikä Apache..." alkaen.

• Sivu ei avaudu:
  • Jos http://localhost -komennolla selaimessa ei avaudu, tarkista että /etc/hosts -tiedosto sisältää 127.0.0.1 localhost -rivin
  • Tarkista että #-merkki on rivin LoadModule php5_module libexec/apache2/libphp5.so edellä tiedostossa /etc/apache2/httpd.conf
• Ei toimi:
  • Ehkä vaatii muutoksia httpd.conf -tiedostoon, joita on kerrottu vaihtoehto 2:ssa

.htaccess ylikirjoitus ja URL-uudelleenkirjoituksen salliminen

Jos käytät kuitenkin Macintosh HD/Kirjasto/WebServer/Documents/ -hakemistossa olevaa, kts. ohje http://coolestguidesontheplanet.com/get-apache-mysql-php-phpmyadmin-working-osx-10-10-yosemite/

Apache, User, Group

• Todennäköistä on että käyttäessäsi esimerkiksi MediaWiki-ohjelman tiedostotallennusta, Apache tallentaa tiedostot User _www ja Group staff tai Group _www. Voit muuttaa tätä asetusta esimerkiksi että tallennus tapahtuu omalla käyttäjätunnuksellasi kuten: User omamackäyttäjätunnus ja Group staff. Jos haluat taas root -tunnuksen niin User root ja Group wheel Muutos vaikuttaa ilmeisesti vain tästä hetkestä eteenpäin eli olemassaoleviin hakemisto ja tiedosto-oikeuksiin se ei vaikuta.

cd /private/etc/apache2/
sudo vi httpd.conf
anna salasana
a Tämä a-kirjain avaa syöttötoiminnon vi-editorissa.
Etsi kohta, jossa on User ja Group.
 User omakäyttäjänimi
 Group staff
esc :wq Paina esc kaksoispiste w ja q perätysten niin tiedot tallennetaan ja poistutaan editorista.
sudo apachectl graceful Käynnistetään Apache uudestaan graceful toiminnolla.

• Jos olet päivittänyt Mavericksiin Lionista tai Yosemiteen Maverickista muodostuu uusi httpd.conf -tiedosto. Vanha on ehkä samassa kansiossa nimellä httpd.conf.pre-update

Ongelmia

• Sivunpäivitysongelma OSX Yosemite. Tallennat esimerkiksi xcode:lla muokkaamaasi tiedoston cmd-s ja päivität saman tien Safarissa tai Firefoxissa sivun, johon tiedosto vaikuttaa (cmd-r). Sivu ei päivity kuin vasta noin minuutin kuluttua. Firefoxissa välimuisti on otettu pois käytöstä (siellä mutkan takana about.configissa). Saattaa olla kyse Apache-ongelmasta???

Komentoja

• Uudelleenkäynnistys: /usr/sbin/apachectl restart
• Sammutus: ./usr/sbin/apachectl stop
• Käynnistys: ./usr/sbin/apachectl start
• Levytila: df -h
• Palvelimen lokitiedostot: cd /var/log

Apache Tomcat

Apache Tomcat 7

Katso sivu Cyclos

Apache Tomcat 6

• Installing Apache Tomcat 6 on Mac OS X Leopard http://www.malisphoto.com/tips/tomcatonosx.html

BASH

Lähde: http://www.macdevcenter.com/pub/a/mac/2004/02/24/bash.html

• Ensin asetetaan JAVA_HOME ympäristömuuttuja kohdalleen.
• Tietokone suorittaa tietyt komennot jotka on laitettu joko käyttäjän hakemistoon tiedostoon .profile käynnistettäessä pääteohjelma tai jos laitetaan tiedostoon /etc/profile niin suorittaa kaikille käyttäjille
• ~/.profile tiedosto pitää mahdollisesti luoda, sitä ei ole valmiina
• /etc/profile löytyy siis /etc hakemistosta
• Tomcat 6 varten lisää profile -tiedostoon /etc hakemistossa:
  • # environment variables
  • export JAVA_HOME=/Library/Java/Home
  • Tallenna ctrl-x, Yes, Enter
• Poistu pääteohjelmasta ja Lopeta se eli sammuta!
• Käynnistä uudestaan ja syötä komento env
  • Tulosteessa pitäisi nyt näkyä JAVA_HOME=/Library/Java/Home

Asennus jatkuu

• Siirry sivulle http://tomcat.apache.org/download-60.cgi
• Lataa uusin 6.0.x Core tar.gz -tiedosto
  • Jatkossa sijoita komentoihin oikea tiedostonimi, tässä se on nyt 18
• Pääteohjelmassa:
  • cd /Library
  • mkdir Tomcat
  • chown root Tomcat
  • chgrp admin Tomcat
  • cd Tomcat
  • Pura tiedosto Tiedostohaut hakemistosta tar -xvf ~/Downloads/apache-tomcat-6.0.18.tar
  • Tee symbolinen linkki osoittamaan ln -s apache-tomcat-6.0.18 Home
• cd Home/conf
• nano tomcat-users.xml
  • Lisää heti </tomcat-users> rivin yläpuolelle:
  • <user username="administrator" password="salasanasi" roles="standard,manager,admin"/>
  • Tallenna Ctrl-X, Yes, Enter
• cd ../bin
• rm *.bat *.exe
• ./startup.sh
• Kirjoita internetselaimessasi osoite http://localhost:8080/ ja Tomcat nettisivu pitäisi aueta

Sammuttaminen ja käynnistäminen

• Hakemistossa /Library/Tomcat/apache-tomcat-6.0.x/bin
  • Sammuta komennolla ./shutdown.sh
  • Käynnistä komennola ./startup.sh

Suojaaminen tietokoneen ulkopuoliselta käytöltä

• Siirry Tomcat-hakemistoon /conf
• nano server.xml
  • Lisää rivin <Engine name="Catalina" defaultHost="localhost"> jälkeen

<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127.0.0.1,0:0:0:0:0:0:0:1%0,::1" />

• • Tallenna Ctrl-X,Yes,Enter