Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 96 lines (63 sloc) 3.034 kb
961926f @klacke ""
authored
1
e044aaf Testing CVS commit.
Tobbe Tornquist authored
2 This is yaws, a webserver for dynamic content written in Erlang.
961926f @klacke ""
authored
3
4
5 To build and install
6
f674082 @klacke ""
authored
7
961926f @klacke ""
authored
8 1. Get and install an erlang system (http://www.erlang.org)
f674082 @klacke ""
authored
9
10 2. ./configure --prefix=/usr/local
c9778e0 @klacke added support for 2 additional configure
authored
11 This will install everything under /usr/local including var files
12 in /usr/local/var/run/yaws and etc files in
13 /usr/local/etc/yaws.*
f674082 @klacke ""
authored
14
c9778e0 @klacke added support for 2 additional configure
authored
15 A plain ./configure will install executables under
c15e16a @klacke *** empty log message ***
authored
16 /usr/local/bin and libs in /usr/local/lib/yaws etc and
17 var files will end up under /usr/local/etc and /usr/local/var
c9778e0 @klacke added support for 2 additional configure
authored
18
19
20 Note: We can also change the target directory for etc and var
1dcb026 @klacke New better install procedure, better (more interesting) yaws.conf tem…
authored
21 directories by using:
c9778e0 @klacke added support for 2 additional configure
authored
22
deddbfc Build chain modifications: Install target directories is now totally …
Mikael Karlsson authored
23 --localstatedir=DIR for files that should go in /var
24 --sysconfdir=DIR for files that should go in /etc
c9778e0 @klacke added support for 2 additional configure
authored
25 --disable-pam If we for some reason do not want pam support
26 --with-extrainclude=DIR Will add DIR to the include path
27 May be useful if e.g. pam is installed
28 somewhere where its usually not found
29 --with-defaultcharset=String Will set the default charset used
30 in generated page headers. Usually never needed.
31
32 This way you can precisely control where you install Yaws (This is
1dcb026 @klacke New better install procedure, better (more interesting) yaws.conf tem…
authored
33 usefull for computers where you do not have right access to the
c9778e0 @klacke added support for 2 additional configure
authored
34 standard systemdirs).
35
deddbfc Build chain modifications: Install target directories is now totally …
Mikael Karlsson authored
36 For example:
c15e16a @klacke *** empty log message ***
authored
37 ./configure --prefix=/home/install/yaws --localstatedir=/home/install/yaws/var --sysconfdir=/home/install/etc
deddbfc Build chain modifications: Install target directories is now totally …
Mikael Karlsson authored
38
39
c9778e0 @klacke added support for 2 additional configure
authored
40 2b. Note to packagers (rpm, deb ...) All install targets support the
41 DESTDIR variable.
42 Thus, if we do ./configure --prefix=/usr; make
43 we can subsequently do:
44 DESTDIR=/foo/bar make install
45 All yaws files will be installed under DESTDIR, but all
46 code will assume yaws should be installed under /usr
47
48
961926f @klacke ""
authored
49 3. make
f674082 @klacke ""
authored
50 This will build the system
51
deddbfc Build chain modifications: Install target directories is now totally …
Mikael Karlsson authored
52 make docs
53 (Optionnal) You can issue this command if you want to build Yaws
54 documentation.
55
f674082 @klacke ""
authored
56 make local_install
57 and perform something we call a
e5dbee8 @klacke readme docs
authored
58 local install. It will create an executable script in the $HOME/bin
c15e16a @klacke *** empty log message ***
authored
59 directory and a config file in $HOME/yaws.conf. This is for developers
60 only
961926f @klacke ""
authored
61
c15e16a @klacke *** empty log message ***
authored
62 4. To test the build, Start as bin/yaws -i
63 This will start a webserver at http://0.0.0.0:8000
e5dbee8 @klacke readme docs
authored
64 Terminate through ^C or
65 > init:stop()
961926f @klacke ""
authored
66
aef9169 @klacke ""
authored
67 5. as root make install
f674082 @klacke ""
authored
68
e5dbee8 @klacke readme docs
authored
69 6. as root start as /usr/local/bin/yaws -i
38fb85e @klacke ""
authored
70 (this starts an interactive system)
71
1dcb026 @klacke New better install procedure, better (more interesting) yaws.conf tem…
authored
72 7. This will create a webserver at http://${host} and one at https://${host}
f674082 @klacke ""
authored
73
e5dbee8 @klacke readme docs
authored
74 8. as root edit /usr/local/etc/yaws/yaws.conf
f674082 @klacke ""
authored
75
e5dbee8 @klacke readme docs
authored
76 9. Create content in /usr/local/var/yaws
961926f @klacke ""
authored
77
c9778e0 @klacke added support for 2 additional configure
authored
78 10a. Start as /usr/local/bin/yaws --daemon --heart
79 This will start a daemon (--daemon) which will be autorestarted when/if
80 it crashes or hangs (--heart)
e5dbee8 @klacke readme docs
authored
81 Also, for most unices, we create proper start scripts in
82 /etc/init.d (sysconfdir)
1dcb026 @klacke New better install procedure, better (more interesting) yaws.conf tem…
authored
83
84 10b. Or start interactive system as /usr/local/bin/yaws -i
f674082 @klacke ""
authored
85
e5dbee8 @klacke readme docs
authored
86
87 11. Example: Here is how I compile/start the yaws system that runs
88 at http://yaws.hyber.org (Ubuntu server system)
89
90 # ./configure --sysconfdir=/etc
91 # make && make install
92 # /etc/init.d/yaws start
93
94
95
Something went wrong with that request. Please try again.