Last modified by Aaron Rosenzweig on 2011/05/09 01:46

From version 58.1
edited by ghulands
on 2008/08/18 23:37
Change comment: Added in to modify the httpd.conf's <Directoy/> settings
To version 53.1
edited by Pascal Robert
on 2007/09/03 17:10
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ghulands
1 +XWiki.probert
Content
... ... @@ -6,26 +6,20 @@
6 6  
7 7  When you turn on your web server, Apache will listen on the network interfaces that were configured when it starts. If you change networks, you may need to manually restart apache. You can do this by either stopping and restarting Personal Web Sharing, or you can run "apachectl restart" from the commandline as the root user. Because this can get annoying if you are working on a laptop, or periodically using VPN's, there are a couple ways to make this process easier.
8 8  
9 -= Optional Extra Configuration: Explicitly Setting Your Hostname =
9 += Restarting Apache Fix #1: Explicitly Setting Your Hostname =
10 10  
11 11  {{info title="Useful Information"}}
12 12  
13 -The changes in this section are only required if you want your hostname to be stable across network changes. While this simplifies many aspects of development (like testing cookies and https), it may cause problems with those specific aspects (cookies, https, etc.) if you need to be able to access your dev machine from a remote machine, including if you need to be able to test your web app from a Parallels VM.
13 +The changes in this section are only required if you want your hostname to be stable across network changes. While this simplifies many aspects of development (like testing cookies), it causes problems if you need to be able to access your webserver from a remote machine, including if you need to be able to test your web app from a Parallels VM.
14 14  
15 -Bonjour Delays: Apparently the procedure here is also useful for preventing "Bonjour" delays when you launch the browser to test your app on your development machine.
16 -
17 17  {{/info}}
18 18  
19 19  == Edit Apache Config ==
20 20  
21 -{{warning title="Bonjour, comment ça va? .... Trés bien, merci!"}}
19 +Note: **Do NOT try to use the Bonjour / Rendezvous name of your machine in this step.** It will cause you grief. Accept this and don't even try. You have been warned.
22 22  
23 -*Do NOT try to use the Bonjour / Rendezvous name of your machine in this step.* It will cause you grief. Accept this and don't even try. You have been warned.
21 +Edit **/etc/httpd/httpd.conf**, find the line containing **ServerName** and change it to this:
24 24  
25 -{{/warning}}
26 -
27 -Edit **/etc/httpd/httpd.conf**, find the line containing **ServerName** and change it to this. If you use Leopard (OS X 10.5), the file is at **/etc/apache2/httpd.conf**.
28 -
29 29  {{code}}
30 30  
31 31  ServerName localhost
... ... @@ -32,56 +32,14 @@
32 32  
33 33  {{/code}}
34 34  
35 -That line may be commented out by default. You can simply uncomment it (remove the leading pound sign). You will also need to find this block
29 +That line may be commented out by default. You can simply uncomment it (remove the leading pound sign) and then restart apache:
36 36  
37 37  {{code}}
38 38  
39 -# First, we configure the "default" to be a very restrictive set of
40 -# features.
41 -#
42 -<Directory />
43 - Options FollowSymLinks
44 - AllowOverride None
45 - Order deny,allow
46 - Deny from all
47 -</Directory>
48 -
49 -{{/code}}
50 -
51 -And modify like so:
52 -
53 -{{code}}
54 -
55 -# First, we configure the "default" to be a very restrictive set of
56 -# features.
57 -#
58 -<Directory />
59 - Options FollowSymLinks
60 - AllowOverride None
61 -# Order deny,allow
62 -# Deny from all
63 -</Directory>
64 -
65 -{{/code}}
66 -
67 -Then restart apache:
68 -
69 -{{code}}
70 -
71 71  sudo apachectl restart
72 72  
73 73  {{/code}}
74 74  
75 -== Tell the adaptor to use localhost ==
76 -
77 -Edit **/System/Library/WebObjects/Adaptors/Apache/apache.conf** to make sure that your enabled/uncommented WebObjectsConfig property looks like this:
78 -
79 -{{code}}
80 -
81 -WebObjectsConfig http://localhost:1085 10
82 -
83 -{{/code}}
84 -
85 85  == Tell wotaskd to Use Localhost Too ==
86 86  
87 87  Edit **/System/Library/WebObjects/JavaApplications/wotaskd.woa/Contents/Resources/Properties**
... ... @@ -124,15 +124,10 @@
124 124  
125 125  You may want to set this in your global WOLips settings so you don't have to set it every time you make a new launch configuration. You will need to go back and modify existing launch configurations with these settings even if you set it globally. Global settings only apply to newly created launch configurations.
126 126  
127 -= Apache Restart =
79 += Restarting Apache Fix #2: Kickstart =
128 128  
129 -{{info title="Why would I need this?"}}
81 +The alternative way to restart apache is to have a script run any time your network changes. It turns out that OS X supports such a capability already via Kickstart.
130 130  
131 -If you have a laptop and you get an "Application cannot be found" or some such error in the browser after auto-switching networks (for example going from a work network to a home network), restarting apache can resolve the error condition most of the time. A script is shown below to do that.
132 -If you already implemented the "localhost" explicit hostname setup above, then you will probably not need to bother with this section.
133 -
134 -{{/info}}
135 -
136 136  == Making a restart script ==
137 137  
138 138  Create a script named /usr/local/bin/restartApache and set the contents to:
... ... @@ -145,3 +145,47 @@
145 145  /usr/sbin/apachectl start
146 146  
147 147  {{/code}}
95 +
96 +== Modifying Kicker ==
97 +
98 +1. Edit /System/Library/SystemConfiguration/Kicker.bundle/Contents/Resources/Kicker.xml
99 +1. At the end of the <array> section, add the following block of XML:
100 +
101 +{{code}}
102 +
103 +<dict>
104 + <key>execCommand</key>
105 + <string>/usr/local/bin/restartApache</string>
106 + <key>execUID</key>
107 + <integer>0</integer>
108 + <key>keys</key>
109 + <array>
110 + <string>State:/Network/Global/DNS</string>
111 + <string>State:/Network/Global/IPv4</string>
112 + <string>State:/Network/Global/IPv6</string>
113 + <string>State:/Network/Global/NetInfo</string>
114 + </array>
115 + <key>name</key>
116 + <string>restart_apache</string>
117 + </dict>
118 +
119 +{{/code}}
120 +
121 +== Restart ==
122 +
123 +Restart your machine (you may be able to get away with just logging out and back in). Any network changes will now automatically restart Apache.
124 +
125 +== Extra Credit ==
126 +
127 +I also like to have a growl notification fire when my Apache restarts. To do this:
128 +
129 +1. grab the growl shell script from [[http://www.macosxhints.com/dlfiles/growl_sh.txt]].
130 +1. next, at the end of your /usr/local/bin/restartApache script, you can add:
131 +
132 +{{code}}
133 +
134 +export G_APPLICATION_ICON=EOModeler.app
135 +export G_TITLE=WebObjects
136 +/usr/local/bin/growl "Apache Restarted"
137 +
138 +{{/code}}