/docs/en/html/nonroot.html

https://code.google.com/p/bugzilla4intranet/ · HTML · 745 lines · 742 code · 3 blank · 0 comment · 0 complexity · d121e280604a6babcbe1ef99729f68c4 MD5 · raw file 

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <HTML
    3. 

  3. ><HEAD
    4. 

  4. ><TITLE
    5. 

  5. >UNIX (non-root) Installation Notes</TITLE
    6. 

  6. ><META
    7. 

  7. NAME="GENERATOR"
    8. 

  8. CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
    9. 

  9. REL="HOME"
    10. 

  10. TITLE="The Bugzilla Guide - 3.6.4 
    11. 

  11.     Release"
    12. 

  12. HREF="index.html"><LINK
    13. 

  13. REL="UP"
    14. 

  14. TITLE="Installing Bugzilla"
    15. 

  15. HREF="installing-bugzilla.html"><LINK
    16. 

  16. REL="PREVIOUS"
    17. 

  17. TITLE="OS-Specific Installation Notes"
    18. 

  18. HREF="os-specific.html"><LINK
    19. 

  19. REL="NEXT"
    20. 

  20. TITLE="Upgrading to New Releases"
    21. 

  21. HREF="upgrade.html"></HEAD
    22. 

  22. ><BODY
    23. 

  23. CLASS="section"
    24. 

  24. BGCOLOR="#FFFFFF"
    25. 

  25. TEXT="#000000"
    26. 

  26. LINK="#0000FF"
    27. 

  27. VLINK="#840084"
    28. 

  28. ALINK="#0000FF"
    29. 

  29. ><DIV
    30. 

  30. CLASS="NAVHEADER"
    31. 

  31. ><TABLE
    32. 

  32. SUMMARY="Header navigation table"
    33. 

  33. WIDTH="100%"
    34. 

  34. BORDER="0"
    35. 

  35. CELLPADDING="0"
    36. 

  36. CELLSPACING="0"
    37. 

  37. ><TR
    38. 

  38. ><TH
    39. 

  39. COLSPAN="3"
    40. 

  40. ALIGN="center"
    41. 

  41. >The Bugzilla Guide - 3.6.4 
    42. 

  42.     Release</TH
    43. 

  43. ></TR
    44. 

  44. ><TR
    45. 

  45. ><TD
    46. 

  46. WIDTH="10%"
    47. 

  47. ALIGN="left"
    48. 

  48. VALIGN="bottom"
    49. 

  49. ><A
    50. 

  50. HREF="os-specific.html"
    51. 

  51. ACCESSKEY="P"
    52. 

  52. >Prev</A
    53. 

  53. ></TD
    54. 

  54. ><TD
    55. 

  55. WIDTH="80%"
    56. 

  56. ALIGN="center"
    57. 

  57. VALIGN="bottom"
    58. 

  58. >Chapter 2. Installing Bugzilla</TD
    59. 

  59. ><TD
    60. 

  60. WIDTH="10%"
    61. 

  61. ALIGN="right"
    62. 

  62. VALIGN="bottom"
    63. 

  63. ><A
    64. 

  64. HREF="upgrade.html"
    65. 

  65. ACCESSKEY="N"
    66. 

  66. >Next</A
    67. 

  67. ></TD
    68. 

  68. ></TR
    69. 

  69. ></TABLE
    70. 

  70. ><HR
    71. 

  71. ALIGN="LEFT"
    72. 

  72. WIDTH="100%"></DIV
    73. 

  73. ><DIV
    74. 

  74. CLASS="section"
    75. 

  75. ><H1
    76. 

  76. CLASS="section"
    77. 

  77. ><A
    78. 

  78. NAME="nonroot"
    79. 

  79. >2.6. UNIX (non-root) Installation Notes</A
    80. 

  80. ></H1
    81. 

  81. ><DIV
    82. 

  82. CLASS="section"
    83. 

  83. ><H2
    84. 

  84. CLASS="section"
    85. 

  85. ><A
    86. 

  86. NAME="AEN857"
    87. 

  87. >2.6.1. Introduction</A
    88. 

  88. ></H2
    89. 

  89. ><P
    90. 

  90. >If you are running a *NIX OS as non-root, either due
    91. 

  91.       to lack of access (web hosts, for example) or for security
    92. 

  92.       reasons, this will detail how to install Bugzilla on such
    93. 

  93.       a setup. It is recommended that you read through the
    94. 

  94.       <A
    95. 

  95. HREF="installation.html"
    96. 

  96. >Section 2.1</A
    97. 

  97. >
    98. 

  98.       first to get an idea on the installation steps required.
    99. 

  99.       (These notes will reference to steps in that guide.)</P
    100. 

  100. ></DIV
    101. 

  101. ><DIV
    102. 

  102. CLASS="section"
    103. 

  103. ><H2
    104. 

  104. CLASS="section"
    105. 

  105. ><A
    106. 

  106. NAME="AEN861"
    107. 

  107. >2.6.2. MySQL</A
    108. 

  108. ></H2
    109. 

  109. ><P
    110. 

  110. >You may have MySQL installed as root. If you're
    111. 

  111.       setting up an account with a web host, a MySQL account
    112. 

  112.       needs to be set up for you. From there, you can create
    113. 

  113.       the bugs account, or use the account given to you.</P
    114. 

  114. ><DIV
    115. 

  115. CLASS="warning"
    116. 

  116. ><P
    117. 

  117. ></P
    118. 

  118. ><TABLE
    119. 

  119. CLASS="warning"
    120. 

  120. WIDTH="100%"
    121. 

  121. BORDER="0"
    122. 

  122. ><TR
    123. 

  123. ><TD
    124. 

  124. WIDTH="25"
    125. 

  125. ALIGN="CENTER"
    126. 

  126. VALIGN="TOP"
    127. 

  127. ><IMG
    128. 

  128. SRC="../images/warning.gif"
    129. 

  129. HSPACE="5"
    130. 

  130. ALT="Warning"></TD
    131. 

  131. ><TD
    132. 

  132. ALIGN="LEFT"
    133. 

  133. VALIGN="TOP"
    134. 

  134. ><P
    135. 

  135. >You may have problems trying to set up
    136. 

  136.         <B
    137. 

  137. CLASS="command"
    138. 

  138. >GRANT</B
    139. 

  139. > permissions to the database.
    140. 

  140.         If you're using a web host, chances are that you have a
    141. 

  141.         separate database which is already locked down (or one big
    142. 

  142.         database with limited/no access to the other areas), but you
    143. 

  143.         may want to ask your system administrator what the security
    144. 

  144.         settings are set to, and/or run the <B
    145. 

  145. CLASS="command"
    146. 

  146. >GRANT</B
    147. 

  147. >
    148. 

  148.         command for you.</P
    149. 

  149. ><P
    150. 

  150. >Also, you will probably not be able to change the MySQL
    151. 

  151.         root user password (for obvious reasons), so skip that
    152. 

  152.         step.</P
    153. 

  153. ></TD
    154. 

  154. ></TR
    155. 

  155. ></TABLE
    156. 

  156. ></DIV
    157. 

  157. ><DIV
    158. 

  158. CLASS="section"
    159. 

  159. ><H3
    160. 

  160. CLASS="section"
    161. 

  161. ><A
    162. 

  162. NAME="AEN869"
    163. 

  163. >2.6.2.1. Running MySQL as Non-Root</A
    164. 

  164. ></H3
    165. 

  165. ><DIV
    166. 

  166. CLASS="section"
    167. 

  167. ><H4
    168. 

  168. CLASS="section"
    169. 

  169. ><A
    170. 

  170. NAME="AEN871"
    171. 

  171. >2.6.2.1.1. The Custom Configuration Method</A
    172. 

  172. ></H4
    173. 

  173. ><P
    174. 

  174. >Create a file .my.cnf in your 
    175. 

  175.               home directory (using /home/foo in this example)
    176. 

  176.               as follows....</P
    177. 

  177. ><TABLE
    178. 

  178. BORDER="0"
    179. 

  179. BGCOLOR="#E0E0E0"
    180. 

  180. WIDTH="100%"
    181. 

  181. ><TR
    182. 

  182. ><TD
    183. 

  183. ><FONT
    184. 

  184. COLOR="#000000"
    185. 

  185. ><PRE
    186. 

  186. CLASS="programlisting"
    187. 

  187. >&#13;[mysqld]
    188. 

  188. datadir=/home/foo/mymysql
    189. 

  189. socket=/home/foo/mymysql/thesock
    190. 

  190. port=8081
    191. 

  191. 

  192. [mysql]
    193. 

  193. socket=/home/foo/mymysql/thesock
    194. 

  194. port=8081
    195. 

  195. 

  196. [mysql.server]
    197. 

  197. user=mysql
    198. 

  198. basedir=/var/lib
    199. 

  199. 

  200. [safe_mysqld]
    201. 

  201. err-log=/home/foo/mymysql/the.log
    202. 

  202. pid-file=/home/foo/mymysql/the.pid
    203. 

  203.               </PRE
    204. 

  204. ></FONT
    205. 

  205. ></TD
    206. 

  206. ></TR
    207. 

  207. ></TABLE
    208. 

  208. ></DIV
    209. 

  209. ><DIV
    210. 

  210. CLASS="section"
    211. 

  211. ><H4
    212. 

  212. CLASS="section"
    213. 

  213. ><A
    214. 

  214. NAME="AEN875"
    215. 

  215. >2.6.2.1.2. The Custom Built Method</A
    216. 

  216. ></H4
    217. 

  217. ><P
    218. 

  218. >You can install MySQL as a not-root, if you really need to.
    219. 

  219.             Build it with PREFIX set to <TT
    220. 

  220. CLASS="filename"
    221. 

  221. >/home/foo/mysql</TT
    222. 

  222. >,
    223. 

  223.             or use pre-installed executables, specifying that you want
    224. 

  224.             to put all of the data files in <TT
    225. 

  225. CLASS="filename"
    226. 

  226. >/home/foo/mysql/data</TT
    227. 

  227. >.
    228. 

  228.             If there is another MySQL server running on the system that you
    229. 

  229.             do not own, use the -P option to specify a TCP port that is not
    230. 

  230.             in use.</P
    231. 

  231. ></DIV
    232. 

  232. ><DIV
    233. 

  233. CLASS="section"
    234. 

  234. ><H4
    235. 

  235. CLASS="section"
    236. 

  236. ><A
    237. 

  237. NAME="AEN880"
    238. 

  238. >2.6.2.1.3. Starting the Server</A
    239. 

  239. ></H4
    240. 

  240. ><P
    241. 

  241. >After your mysqld program is built and any .my.cnf file is 
    242. 

  242.             in place, you must initialize the databases (ONCE).</P
    243. 

  243. ><TABLE
    244. 

  244. BORDER="0"
    245. 

  245. BGCOLOR="#E0E0E0"
    246. 

  246. WIDTH="100%"
    247. 

  247. ><TR
    248. 

  248. ><TD
    249. 

  249. ><FONT
    250. 

  250. COLOR="#000000"
    251. 

  251. ><PRE
    252. 

  252. CLASS="screen"
    253. 

  253. >&#13;              <SAMP
    254. 

  254. CLASS="prompt"
    255. 

  255. >bash$</SAMP
    256. 

  256. >
    257. 

  257.               <B
    258. 

  258. CLASS="command"
    259. 

  259. >mysql_install_db</B
    260. 

  260. >
    261. 

  261.             </PRE
    262. 

  262. ></FONT
    263. 

  263. ></TD
    264. 

  264. ></TR
    265. 

  265. ></TABLE
    266. 

  266. ><P
    267. 

  267. >Then start the daemon with</P
    268. 

  268. ><TABLE
    269. 

  269. BORDER="0"
    270. 

  270. BGCOLOR="#E0E0E0"
    271. 

  271. WIDTH="100%"
    272. 

  272. ><TR
    273. 

  273. ><TD
    274. 

  274. ><FONT
    275. 

  275. COLOR="#000000"
    276. 

  276. ><PRE
    277. 

  277. CLASS="screen"
    278. 

  278. >&#13;              <SAMP
    279. 

  279. CLASS="prompt"
    280. 

  280. >bash$</SAMP
    281. 

  281. >
    282. 

  282.               <B
    283. 

  283. CLASS="command"
    284. 

  284. >safe_mysql &#38;</B
    285. 

  285. >
    286. 

  286.             </PRE
    287. 

  287. ></FONT
    288. 

  288. ></TD
    289. 

  289. ></TR
    290. 

  290. ></TABLE
    291. 

  291. ><P
    292. 

  292. >After you start mysqld the first time, you then connect to
    293. 

  293.             it as "root" and <B
    294. 

  294. CLASS="command"
    295. 

  295. >GRANT</B
    296. 

  296. > permissions to other
    297. 

  297.             users. (Again, the MySQL root account has nothing to do with
    298. 

  298.             the *NIX root account.)</P
    299. 

  299. ><DIV
    300. 

  300. CLASS="note"
    301. 

  301. ><P
    302. 

  302. ></P
    303. 

  303. ><TABLE
    304. 

  304. CLASS="note"
    305. 

  305. WIDTH="100%"
    306. 

  306. BORDER="0"
    307. 

  307. ><TR
    308. 

  308. ><TD
    309. 

  309. WIDTH="25"
    310. 

  310. ALIGN="CENTER"
    311. 

  311. VALIGN="TOP"
    312. 

  312. ><IMG
    313. 

  313. SRC="../images/note.gif"
    314. 

  314. HSPACE="5"
    315. 

  315. ALT="Note"></TD
    316. 

  316. ><TD
    317. 

  317. ALIGN="LEFT"
    318. 

  318. VALIGN="TOP"
    319. 

  319. ><P
    320. 

  320. >You will need to start the daemons yourself. You can either
    321. 

  321.               ask your system administrator to add them to system startup files, or
    322. 

  322.               add a crontab entry that runs a script to check on these daemons
    323. 

  323.               and restart them if needed.</P
    324. 

  324. ></TD
    325. 

  325. ></TR
    326. 

  326. ></TABLE
    327. 

  327. ></DIV
    328. 

  328. ><DIV
    329. 

  329. CLASS="warning"
    330. 

  330. ><P
    331. 

  331. ></P
    332. 

  332. ><TABLE
    333. 

  333. CLASS="warning"
    334. 

  334. WIDTH="100%"
    335. 

  335. BORDER="0"
    336. 

  336. ><TR
    337. 

  337. ><TD
    338. 

  338. WIDTH="25"
    339. 

  339. ALIGN="CENTER"
    340. 

  340. VALIGN="TOP"
    341. 

  341. ><IMG
    342. 

  342. SRC="../images/warning.gif"
    343. 

  343. HSPACE="5"
    344. 

  344. ALT="Warning"></TD
    345. 

  345. ><TD
    346. 

  346. ALIGN="LEFT"
    347. 

  347. VALIGN="TOP"
    348. 

  348. ><P
    349. 

  349. >Do NOT run daemons or other services on a server without first
    350. 

  350.               consulting your system administrator! Daemons use up system resources
    351. 

  351.               and running one may be in violation of your terms of service for any
    352. 

  352.               machine on which you are a user!</P
    353. 

  353. ></TD
    354. 

  354. ></TR
    355. 

  355. ></TABLE
    356. 

  356. ></DIV
    357. 

  357. ></DIV
    358. 

  358. ></DIV
    359. 

  359. ></DIV
    360. 

  360. ><DIV
    361. 

  361. CLASS="section"
    362. 

  362. ><H2
    363. 

  363. CLASS="section"
    364. 

  364. ><A
    365. 

  365. NAME="AEN896"
    366. 

  366. >2.6.3. Perl</A
    367. 

  367. ></H2
    368. 

  368. ><P
    369. 

  369. >&#13;      On the extremely rare chance that you don't have Perl on
    370. 

  370.       the machine, you will have to build the sources
    371. 

  371.       yourself. The following commands should get your system
    372. 

  372.       installed with your own personal version of Perl:
    373. 

  373.       </P
    374. 

  374. ><TABLE
    375. 

  375. BORDER="0"
    376. 

  376. BGCOLOR="#E0E0E0"
    377. 

  377. WIDTH="100%"
    378. 

  378. ><TR
    379. 

  379. ><TD
    380. 

  380. ><FONT
    381. 

  381. COLOR="#000000"
    382. 

  382. ><PRE
    383. 

  383. CLASS="screen"
    384. 

  384. >&#13;        <SAMP
    385. 

  385. CLASS="prompt"
    386. 

  386. >bash$</SAMP
    387. 

  387. >
    388. 

  388.         <B
    389. 

  389. CLASS="command"
    390. 

  390. >wget http://perl.org/CPAN/src/stable.tar.gz</B
    391. 

  391. >
    392. 

  392.         <SAMP
    393. 

  393. CLASS="prompt"
    394. 

  394. >bash$</SAMP
    395. 

  395. >
    396. 

  396.         <B
    397. 

  397. CLASS="command"
    398. 

  398. >tar zvxf stable.tar.gz</B
    399. 

  399. >
    400. 

  400.         <SAMP
    401. 

  401. CLASS="prompt"
    402. 

  402. >bash$</SAMP
    403. 

  403. >
    404. 

  404.         <B
    405. 

  405. CLASS="command"
    406. 

  406. >cd perl-5.8.1</B
    407. 

  407. > (or whatever the version of Perl is called)
    408. 

  408.         <SAMP
    409. 

  409. CLASS="prompt"
    410. 

  410. >bash$</SAMP
    411. 

  411. >
    412. 

  412.         <B
    413. 

  413. CLASS="command"
    414. 

  414. >sh Configure -de -Dprefix=/home/foo/perl</B
    415. 

  415. >
    416. 

  416.         <SAMP
    417. 

  417. CLASS="prompt"
    418. 

  418. >bash$</SAMP
    419. 

  419. >
    420. 

  420.         <B
    421. 

  421. CLASS="command"
    422. 

  422. >make &#38;&#38; make test &#38;&#38; make install</B
    423. 

  423. >
    424. 

  424.       </PRE
    425. 

  425. ></FONT
    426. 

  426. ></TD
    427. 

  427. ></TR
    428. 

  428. ></TABLE
    429. 

  429. ><P
    430. 

  430. >&#13;      Once you have Perl installed into a directory (probably
    431. 

  431.       in <TT
    432. 

  432. CLASS="filename"
    433. 

  433. >~/perl/bin</TT
    434. 

  434. >), you will need to
    435. 

  435.       install the Perl Modules, described below.
    436. 

  436.       </P
    437. 

  437. ></DIV
    438. 

  438. ><DIV
    439. 

  439. CLASS="section"
    440. 

  440. ><H2
    441. 

  441. CLASS="section"
    442. 

  442. ><A
    443. 

  443. NAME="install-perlmodules-nonroot"
    444. 

  444. >2.6.4. Perl Modules</A
    445. 

  445. ></H2
    446. 

  446. ><P
    447. 

  447. >&#13;      Installing the Perl modules as a non-root user is accomplished by
    448. 

  448.       running the <TT
    449. 

  449. CLASS="filename"
    450. 

  450. >install-module.pl</TT
    451. 

  451. >
    452. 

  452.       script. For more details on this script, see 
    453. 

  453.       <A
    454. 

  454. HREF="api/install-module.html"
    455. 

  455. TARGET="_top"
    456. 

  456. ><TT
    457. 

  457. CLASS="filename"
    458. 

  458. >install-module.pl</TT
    459. 

  459. >
    460. 

  460.       documentation</A
    461. 

  461. >
    462. 

  462.       </P
    463. 

  463. ></DIV
    464. 

  464. ><DIV
    465. 

  465. CLASS="section"
    466. 

  466. ><H2
    467. 

  467. CLASS="section"
    468. 

  468. ><A
    469. 

  469. NAME="AEN918"
    470. 

  470. >2.6.5. HTTP Server</A
    471. 

  471. ></H2
    472. 

  472. ><P
    473. 

  473. >Ideally, this also needs to be installed as root and
    474. 

  474.       run under a special web server account. As long as
    475. 

  475.       the web server will allow the running of *.cgi files outside of a
    476. 

  476.       cgi-bin, and a way of denying web access to certain files (such as a
    477. 

  477.       .htaccess file), you should be good in this department.</P
    478. 

  478. ><DIV
    479. 

  479. CLASS="section"
    480. 

  480. ><H3
    481. 

  481. CLASS="section"
    482. 

  482. ><A
    483. 

  483. NAME="AEN921"
    484. 

  484. >2.6.5.1. Running Apache as Non-Root</A
    485. 

  485. ></H3
    486. 

  486. ><P
    487. 

  487. >You can run Apache as a non-root user, but the port will need
    488. 

  488.         to be set to one above 1024. If you type <B
    489. 

  489. CLASS="command"
    490. 

  490. >httpd -V</B
    491. 

  491. >,
    492. 

  492.         you will get a list of the variables that your system copy of httpd
    493. 

  493.         uses. One of those, namely HTTPD_ROOT, tells you where that
    494. 

  494.         installation looks for its config information.</P
    495. 

  495. ><P
    496. 

  496. >From there, you can copy the config files to your own home
    497. 

  497.         directory to start editing. When you edit those and then use the -d
    498. 

  498.         option to override the HTTPD_ROOT compiled into the web server, you
    499. 

  499.         get control of your own customized web server.</P
    500. 

  500. ><DIV
    501. 

  501. CLASS="note"
    502. 

  502. ><P
    503. 

  503. ></P
    504. 

  504. ><TABLE
    505. 

  505. CLASS="note"
    506. 

  506. WIDTH="100%"
    507. 

  507. BORDER="0"
    508. 

  508. ><TR
    509. 

  509. ><TD
    510. 

  510. WIDTH="25"
    511. 

  511. ALIGN="CENTER"
    512. 

  512. VALIGN="TOP"
    513. 

  513. ><IMG
    514. 

  514. SRC="../images/note.gif"
    515. 

  515. HSPACE="5"
    516. 

  516. ALT="Note"></TD
    517. 

  517. ><TD
    518. 

  518. ALIGN="LEFT"
    519. 

  519. VALIGN="TOP"
    520. 

  520. ><P
    521. 

  521. >You will need to start the daemons yourself. You can either
    522. 

  522.           ask your system administrator to add them to system startup files, or
    523. 

  523.           add a crontab entry that runs a script to check on these daemons
    524. 

  524.           and restart them if needed.</P
    525. 

  525. ></TD
    526. 

  526. ></TR
    527. 

  527. ></TABLE
    528. 

  528. ></DIV
    529. 

  529. ><DIV
    530. 

  530. CLASS="warning"
    531. 

  531. ><P
    532. 

  532. ></P
    533. 

  533. ><TABLE
    534. 

  534. CLASS="warning"
    535. 

  535. WIDTH="100%"
    536. 

  536. BORDER="0"
    537. 

  537. ><TR
    538. 

  538. ><TD
    539. 

  539. WIDTH="25"
    540. 

  540. ALIGN="CENTER"
    541. 

  541. VALIGN="TOP"
    542. 

  542. ><IMG
    543. 

  543. SRC="../images/warning.gif"
    544. 

  544. HSPACE="5"
    545. 

  545. ALT="Warning"></TD
    546. 

  546. ><TD
    547. 

  547. ALIGN="LEFT"
    548. 

  548. VALIGN="TOP"
    549. 

  549. ><P
    550. 

  550. >Do NOT run daemons or other services on a server without first
    551. 

  551.           consulting your system administrator! Daemons use up system resources
    552. 

  552.           and running one may be in violation of your terms of service for any
    553. 

  553.           machine on which you are a user!</P
    554. 

  554. ></TD
    555. 

  555. ></TR
    556. 

  556. ></TABLE
    557. 

  557. ></DIV
    558. 

  558. ></DIV
    559. 

  559. ></DIV
    560. 

  560. ><DIV
    561. 

  561. CLASS="section"
    562. 

  562. ><H2
    563. 

  563. CLASS="section"
    564. 

  564. ><A
    565. 

  565. NAME="AEN930"
    566. 

  566. >2.6.6. Bugzilla</A
    567. 

  567. ></H2
    568. 

  568. ><P
    569. 

  569. >&#13;      When you run <B
    570. 

  570. CLASS="command"
    571. 

  571. >./checksetup.pl</B
    572. 

  572. > to create
    573. 

  573.       the <TT
    574. 

  574. CLASS="filename"
    575. 

  575. >localconfig</TT
    576. 

  576. > file, it will list the Perl
    577. 

  577.       modules it finds. If one is missing, go back and double-check the
    578. 

  578.       module installation from <A
    579. 

  579. HREF="nonroot.html#install-perlmodules-nonroot"
    580. 

  580. >Section 2.6.4</A
    581. 

  581. >, 
    582. 

  582.       then delete the <TT
    583. 

  583. CLASS="filename"
    584. 

  584. >localconfig</TT
    585. 

  585. > file and try again.
    586. 

  586.       </P
    587. 

  587. ><DIV
    588. 

  588. CLASS="warning"
    589. 

  589. ><P
    590. 

  590. ></P
    591. 

  591. ><TABLE
    592. 

  592. CLASS="warning"
    593. 

  593. WIDTH="100%"
    594. 

  594. BORDER="0"
    595. 

  595. ><TR
    596. 

  596. ><TD
    597. 

  597. WIDTH="25"
    598. 

  598. ALIGN="CENTER"
    599. 

  599. VALIGN="TOP"
    600. 

  600. ><IMG
    601. 

  601. SRC="../images/warning.gif"
    602. 

  602. HSPACE="5"
    603. 

  603. ALT="Warning"></TD
    604. 

  604. ><TD
    605. 

  605. ALIGN="LEFT"
    606. 

  606. VALIGN="TOP"
    607. 

  607. ><P
    608. 

  608. >One option in <TT
    609. 

  609. CLASS="filename"
    610. 

  610. >localconfig</TT
    611. 

  611. > you
    612. 

  612.         might have problems with is the web server group. If you can't
    613. 

  613.         successfully browse to the <TT
    614. 

  614. CLASS="filename"
    615. 

  615. >index.cgi</TT
    616. 

  616. > (like
    617. 

  617.         a Forbidden error), you may have to relax your permissions,
    618. 

  618.         and blank out the web server group. Of course, this may pose
    619. 

  619.         as a security risk. Having a properly jailed shell and/or
    620. 

  620.         limited access to shell accounts may lessen the security risk,
    621. 

  621.         but use at your own risk.</P
    622. 

  622. ></TD
    623. 

  623. ></TR
    624. 

  624. ></TABLE
    625. 

  625. ></DIV
    626. 

  626. ><DIV
    627. 

  627. CLASS="section"
    628. 

  628. ><H3
    629. 

  629. CLASS="section"
    630. 

  630. ><A
    631. 

  631. NAME="suexec"
    632. 

  632. >2.6.6.1. suexec or shared hosting</A
    633. 

  633. ></H3
    634. 

  634. ><P
    635. 

  635. >If you are running on a system that uses suexec (most shared
    636. 

  636.         hosting environments do this), you will need to set the
    637. 

  637.         <EM
    638. 

  638. >webservergroup</EM
    639. 

  639. > value in <TT
    640. 

  640. CLASS="filename"
    641. 

  641. >localconfig</TT
    642. 

  642. >
    643. 

  643.         to match <EM
    644. 

  644. >your</EM
    645. 

  645. > primary group, rather than the one
    646. 

  646.         the web server runs under.  You will need to run the following
    647. 

  647.         shell commands after running <B
    648. 

  648. CLASS="command"
    649. 

  649. >./checksetup.pl</B
    650. 

  650. >,
    651. 

  651.         every time you run it (or modify <TT
    652. 

  652. CLASS="filename"
    653. 

  653. >checksetup.pl</TT
    654. 

  654. >
    655. 

  655.         to do them for you via the system() command).
    656. 

  656.         <TABLE
    657. 

  657. BORDER="0"
    658. 

  658. BGCOLOR="#E0E0E0"
    659. 

  659. WIDTH="100%"
    660. 

  660. ><TR
    661. 

  661. ><TD
    662. 

  662. ><FONT
    663. 

  663. COLOR="#000000"
    664. 

  664. ><PRE
    665. 

  665. CLASS="programlisting"
    666. 

  666. >        for i in docs graphs images js skins; do find $i -type d -exec chmod o+rx {} \; ; done
    667. 

  667.         for i in jpg gif css js png html rdf xul; do find . -name \*.$i -exec chmod o+r {} \; ; done
    668. 

  668.         find . -name .htaccess -exec chmod o+r {} \;
    669. 

  669.         chmod o+x . data data/webdot</PRE
    670. 

  670. ></FONT
    671. 

  671. ></TD
    672. 

  672. ></TR
    673. 

  673. ></TABLE
    674. 

  674. >
    675. 

  675.         Pay particular attention to the number of semicolons and dots.
    676. 

  676.         They are all important.  A future version of Bugzilla will
    677. 

  677.         hopefully be able to do this for you out of the box.</P
    678. 

  678. ></DIV
    679. 

  679. ></DIV
    680. 

  680. ></DIV
    681. 

  681. ><DIV
    682. 

  682. CLASS="NAVFOOTER"
    683. 

  683. ><HR
    684. 

  684. ALIGN="LEFT"
    685. 

  685. WIDTH="100%"><TABLE
    686. 

  686. SUMMARY="Footer navigation table"
    687. 

  687. WIDTH="100%"
    688. 

  688. BORDER="0"
    689. 

  689. CELLPADDING="0"
    690. 

  690. CELLSPACING="0"
    691. 

  691. ><TR
    692. 

  692. ><TD
    693. 

  693. WIDTH="33%"
    694. 

  694. ALIGN="left"
    695. 

  695. VALIGN="top"
    696. 

  696. ><A
    697. 

  697. HREF="os-specific.html"
    698. 

  698. ACCESSKEY="P"
    699. 

  699. >Prev</A
    700. 

  700. ></TD
    701. 

  701. ><TD
    702. 

  702. WIDTH="34%"
    703. 

  703. ALIGN="center"
    704. 

  704. VALIGN="top"
    705. 

  705. ><A
    706. 

  706. HREF="index.html"
    707. 

  707. ACCESSKEY="H"
    708. 

  708. >Home</A
    709. 

  709. ></TD
    710. 

  710. ><TD
    711. 

  711. WIDTH="33%"
    712. 

  712. ALIGN="right"
    713. 

  713. VALIGN="top"
    714. 

  714. ><A
    715. 

  715. HREF="upgrade.html"
    716. 

  716. ACCESSKEY="N"
    717. 

  717. >Next</A
    718. 

  718. ></TD
    719. 

  719. ></TR
    720. 

  720. ><TR
    721. 

  721. ><TD
    722. 

  722. WIDTH="33%"
    723. 

  723. ALIGN="left"
    724. 

  724. VALIGN="top"
    725. 

  725. >OS-Specific Installation Notes</TD
    726. 

  726. ><TD
    727. 

  727. WIDTH="34%"
    728. 

  728. ALIGN="center"
    729. 

  729. VALIGN="top"
    730. 

  730. ><A
    731. 

  731. HREF="installing-bugzilla.html"
    732. 

  732. ACCESSKEY="U"
    733. 

  733. >Up</A
    734. 

  734. ></TD
    735. 

  735. ><TD
    736. 

  736. WIDTH="33%"
    737. 

  737. ALIGN="right"
    738. 

  738. VALIGN="top"
    739. 

  739. >Upgrading to New Releases</TD
    740. 

  740. ></TR
    741. 

  741. ></TABLE
    742. 

  742. ></DIV
    743. 

  743. ></BODY
    744. 

  744. ></HTML
    745. 

  745. >
    746.