1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Installing the WebIssues Server</title>
<link rel="stylesheet" href="common/style.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.0" />
<meta name="keywords" content="webissues, issue tracking, bug tracking, team collaboration, server" />
<link rel="start" href="index.html" title="The WebIssues Server Manual" />
<link rel="up" href="installation.html" title="Chapter 2. Installation Guide" />
<link rel="prev" href="installation.html" title="Chapter 2. Installation Guide" />
<link rel="next" href="upgrade_server.html" title="Upgrading the WebIssues Server" />
</head>
<body>
<div id="header">
<div id="header-bar">
<img id="header-logo" src="common/webissues.png" alt="WebIssues" />
<div id="header-title">The <span class="application">WebIssues Server</span> Manual</div>
<div id="header-abstract">Issue tracking and team collaboration system</div>
</div>
<div id="header-links"><a accesskey="h" href="index.html">Home</a> » <a accesskey="u" href="installation.html">Installation Guide</a></div>
</div>
<div class="navlinks">
<div class="navleft">« <a accesskey="p" href="installation.html">Installation Guide</a></div>
<div class="navright"><a accesskey="n" href="upgrade_server.html">Upgrading the <span class="application">WebIssues Server</span></a> »</div>
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="install_server"></a>Installing the <span class="application">WebIssues Server</span></h2>
</div>
</div>
</div>
<p>This chapter lists the steps required to install a new instance of the <span class="application">WebIssues Server</span>.</p>
<div class="orderedlist">
<ol type="1">
<li>
<p>Download and unpack the <code class="literal">webissues-server</code> package. Move all files from the unpacked directory to the web server's document root or your public HTML directory. Refer to the appropriate documentation for more information about configuring the web server.</p>
</li>
<li>
<p>Create a database and a user with sufficient privileges to create tables. The <a class="link" href="database.html" title="Creating the database">Database</a> chapter contains instructions for creating the database using the standard command line tools. If you are using a different tool for managing the databases, refer to the relevant documentation for more information.</p>
</li>
<li>
<p>Create the <code class="literal">storage</code> and <code class="literal">log</code> subdirectories in the server's location. Make sure they are writable for the web server and not accessible for anyone else.</p>
</li>
<li>
<p>Copy <code class="literal">config/config-template.inc.php</code> to <code class="literal">config/config.inc.php</code> and edit the created file to configure database connection and other settings. See <a class="link" href="configuration.html" title="Configuring WebIssues">Configuration</a> for more information.</p>
</li>
<li>
<p>Point your browser to the <code class="literal">setup.php</code> script in the server's location, for example <code class="literal">http://www.example.com/setup.php</code> and follow the installation steps. The script will check the configuration, create the database tables, set up the administrator account and import an initial set of issue types.</p>
</li>
</ol>
</div>
<p>After the setup is finished, you will be able to connect to your server using the <span class="application">WebIssues</span> Desktop Client application to configure the projects, folders, issue types and user accounts. Use the location of the <code class="literal">index.php</code> script as the server's URL, for example <code class="literal">http://www.example.com/index.php</code>.</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>Make sure the configuration file, file attachments and server logs are not accessible for unauthorized users. See the <a class="link" href="security.html" title="Security settings">Security</a> chapter for more information about security settings.</p>
</div>
<p>You can check if the <span class="application">WebIssues Server</span> is working by opening its URL in the browser. It will connect to the database, test if it is configured correctly and display a status message. You can also use the error log to check if there are any problems.</p>
</div>
<div class="navlinks">
<div class="navleft">« <a accesskey="p" href="installation.html">Installation Guide</a></div>
<div class="navright"><a accesskey="n" href="upgrade_server.html">Upgrading the <span class="application">WebIssues Server</span></a> »</div>
</div>
<div id="copyright">
<p class="copyright">Copyright © 2007-2008 WebIssues Team</p>
</div>
</body>
</html>
|
