<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head profile="http://internetalchemy.org/2003/02/profile">
<link rel="foaf" type="application/rdf+xml" title="FOAF" href="http://www.openlinksw.com/dataspace/uda/about.rdf" />
<link rel="schema.dc" href="http://purl.org/dc/elements/1.1/" />
<meta name="dc.title" content="3. Quick Start & Tours" />
<meta name="dc.subject" content="3. Quick Start & Tours" />
<meta name="dc.creator" content="OpenLink Software Documentation Team ; " />
<meta name="dc.copyright" content="OpenLink Software, 1999 - 2009" />
<link rel="top" href="index.html" title="OpenLink Virtuoso Universal Server: Documentation" />
<link rel="search" href="/doc/adv_search.vspx" title="Search OpenLink Virtuoso Universal Server: Documentation" />
<link rel="parent" href="quicktours.html" title="Chapter Contents" />
<link rel="prev" href="qsvdbsrv.html" title="Virtual Database Server" />
<link rel="next" href="qswebdav.html" title="WebDAV" />
<link rel="shortcut icon" href="../images/misc/favicon.ico" type="image/x-icon" />
<link rel="stylesheet" type="text/css" href="doc.css" />
<link rel="stylesheet" type="text/css" href="/doc/translation.css" />
<title>3. Quick Start & Tours</title>
<meta http-equiv="Content-Type" content="text/xhtml; charset=UTF-8" />
<meta name="author" content="OpenLink Software Documentation Team ; " />
<meta name="copyright" content="OpenLink Software, 1999 - 2009" />
<meta name="keywords" content="" />
<meta name="GENERATOR" content="OpenLink XSLT Team" />
</head>
<body>
<div id="header">
<a name="qswebserver" />
<img src="../images/misc/logo.jpg" alt="" />
<h1>3. Quick Start & Tours</h1>
</div>
<div id="navbartop">
<div>
<a class="link" href="quicktours.html">Chapter Contents</a> | <a class="link" href="qsvdbsrv.html" title="Virtual Database Server">Prev</a> | <a class="link" href="qswebdav.html" title="WebDAV">Next</a>
</div>
</div>
<div id="currenttoc">
<form method="post" action="/doc/adv_search.vspx">
<div class="search">Keyword Search: <br />
<input type="text" name="q" /> <input type="submit" name="go" value="Go" />
</div>
</form>
<div>
<a href="http://www.openlinksw.com/">www.openlinksw.com</a>
</div>
<div>
<a href="http://docs.openlinksw.com/">docs.openlinksw.com</a>
</div>
<br />
<div>
<a href="index.html">Book Home</a>
</div>
<br />
<div>
<a href="contents.html">Contents</a>
</div>
<div>
<a href="preface.html">Preface</a>
</div>
<br />
<div class="selected">
<a href="quicktours.html">Quick Start & Tours</a>
</div>
<br />
<div>
<a href="newadminui.html">Where to Start</a>
</div>
<div>
<a href="qsclientcon.html">Client Connections</a>
</div>
<div>
<a href="qsvdbsrv.html">Virtual Database Server</a>
</div>
<div class="selected">
<a href="qswebserver.html">Web Server</a>
<div>
<a href="#qsvirtdir" title="Virtual Directories">Virtual Directories</a>
<a href="#qsmultihome" title="Multi Homing">Multi Homing</a>
</div>
</div>
<div>
<a href="qswebdav.html">WebDAV</a>
</div>
<div>
<a href="qswebservices.html">Web Services</a>
</div>
<div>
<a href="qstexpwsmodules.html">Exposing Persistent Stored Modules as Web Services</a>
</div>
<div>
<a href="qsvsmx.html">VSMX - Virtuoso Service Module for XML</a>
</div>
<div>
<a href="qssqltoxml.html">SQL to XML</a>
</div>
<div>
<a href="qsnntp.html">NNTP</a>
</div>
<div>
<a href="vspquickstart.html">Dynamic Web Pages</a>
</div>
<div>
<a href="qsvspexamples.html">VSP Examples</a>
</div>
<div>
<a href="qshostingplugs.html">Third-Party Runtime Typing, Hosting & User Defined Types</a>
</div>
<div>
<a href="troutips.html">Troubleshooting Tips</a>
</div>
<br />
</div>
<div id="text">
<a name="qswebserver" />
<h2>3.4. Web Server</h2>
<a name="qsvirtdir" />
<h3>3.4.1. Virtual Directories</h3>
<p>The term virtual directory applies to the mechanism to hide the physical location of a Web
resource under different path which user agents use to retrieve it. This mechanism in virtuoso is a
part of host definition.</p>
<p>This method is useful when one server has to keep many Web sites. Using a redirect mechanism is not a universal way to do this.
It is better to define virtual hosts and paths to the directory entries which contain Web pages.</p>
<a name="qsvirtdirpl" />
<h4>3.4.1.1. Creating Virtual Directories Programmatically</h4>
<p>For an overview of virtual directories, and how to configure them in PL, refer to the <a href="webserver.html#virtdir">Virtual Directories Section</a>.</p>
<br />
<a name="qsvirtdirui" />
<h4>3.4.1.2. Setup in Administration Interface</h4>
<p>This step by step example will define a virtual directory /help that will point to the directory /departments/support/</p>
<ol>
<li>
<p>From the Conductor UI go to Web Application Server/ Virtual Domains & Directories.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Http Hosts and Directories" src="../images/ui/virtdir1.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.1.2.1. Http Hosts and Directories</td>
</tr>
</table>
</li>
<li>
<p>Open the "folder" icon for your {Default Web Site}.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Edit URL mappings" src="../images/ui/virtdir2.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.1.2.1. Edit URL mappings</td>
</tr>
</table>
</li>
<li>
<p>Click the link "New Directory" to add a new virtual directory.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Add virtual directory" src="../images/ui/virtdir3.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.1.2.1. Add virtual directory</td>
</tr>
</table>
</li>
<li>
<p>Select for "Type" File system, as this mapping example will be
from one directory to another, and click "Next".</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Use File system template" src="../images/ui/virtdir4.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.1.2.1. Use File system template</td>
</tr>
</table>
</li>
<li>
<p>Enter details in the form to define the mapping. Most of the fields are optional.
In this example, only the logical and physical paths and the default page name are required.
Click finally the button "Save Changes".
</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Mapping details" src="../images/ui/virtdir5.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.1.2.1. Mapping details</td>
</tr>
</table>
</li>
<li>
<p>The following URLs will then be equivalent:</p>
<ul>
<li>http://localhost:8890/help</li>
<li>http://localhost:8890/departments/support/index.html</li>
</ul>
</li>
</ol>
<br />
<br />
<a name="qsmultihome" />
<h3>3.4.2. Multi Homing</h3>
<p>The term Multi Homing refers to the practice of maintaining more than one server on one machine,
differentiated by their apparent host name. It is often desirable for companies sharing a web server to have
their own domains, with web servers accessible as www.company1.com and www.company2.com, without requiring
the user to know any extra path information.</p>
<a name="qsvirthostpl" />
<h4>3.4.2.1. Creating Multiple Homes Programmatically</h4>
<p>For an overview of Multi Homing, and how to configure it with PL, refer to the
<a href="webserver.html#virtandmultihosting"> Virtual Hosting and Multi Hosting</a> section.</p>
<br />
<a name="qsvirthostui" />
<h4>3.4.2.2. Setup in Administration Interface</h4>
<p>This step by step example will define a virtual home for the URL http://www.ahelp.com/
to the server www.a.com and directory /departments/support/</p>
<ol>
<li>
<p>Have a domain name allocated in the DNS for the ahelp.com that points to the
same IP address of the a.com that is hosting a Virtuoso server.
</p>
</li>
<li>
<p>From the Conductor UI go to Web Application Server/ Virtual Domains & Directories.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Http Hosts and Directories." src="../images/ui/virtdir1.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.2.2.1. Http Hosts and Directories.</td>
</tr>
</table>
</li>
<li>
<p>To add a new host definition, enter for "Port" 80, enter for "HTTP Host" www.ahelp.com and select the "Add" button.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Add new site" src="../images/ui/virthost2.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.2.2.1. Add new site</td>
</tr>
</table>
</li>
<li>
<p>Click for the new defined site the "Edit" link in order to define the mapping between the virtual host and the actual listening host domain names.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="New site mapping" src="../images/ui/virthost3.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.2.2.1. New site mapping</td>
</tr>
</table>
</li>
<li>
<p>Click the "folder" icon for the new defined site and then click the "Edit" link for the Logical Path "/".</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Set Logical Path" src="../images/ui/virthost3a.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.2.2.1. Set Logical Path</td>
</tr>
</table>
</li>
<li>
<p>Enter details in the form to define the mapping. Most of the fields are optional. In this example, only the logical and physical paths and the default page name are required.</p>
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Mapping details" src="../images/ui/virthost4.png" />
</td>
</tr>
<tr>
<td>Figure: 3.4.2.2.1. Mapping details</td>
</tr>
</table>
</li>
<li>
<p>The following URLs will then be equivalent:</p>
<ul>
<li>http://www.ahelp.com/</li>
<li>http://www.a.com/departments/support/index.html</li>
</ul>
</li>
</ol>
<br />
<br />
<table border="0" width="90%" id="navbarbottom">
<tr>
<td align="left" width="33%">
<a href="qsvdbsrv.html" title="Virtual Database Server">Previous</a>
<br />Virtual Database Server</td>
<td align="center" width="34%">
<a href="quicktours.html">Chapter Contents</a>
</td>
<td align="right" width="33%">
<a href="qswebdav.html" title="WebDAV">Next</a>
<br />WebDAV</td>
</tr>
</table>
</div>
<div id="footer">
<div>Copyright© 1999 - 2009 OpenLink Software All rights reserved.</div>
<div id="validation">
<a href="http://validator.w3.org/check/referer">
<img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" />
</a>
<a href="http://jigsaw.w3.org/css-validator/">
<img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" height="31" width="88" />
</a>
</div>
</div>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
71d40963b505df4524269198e237b3e3
>
files
>
838
