103 lines
7.0 KiB
HTML
103 lines
7.0 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="task" />
|
|
<meta name="DC.Title" content="Update configuration files" />
|
|
<meta name="abstract" content="After you have configured Tomcat on the HTTP server (powered by Apache) to use the Xsockets tool, you must complete manual changes to several configuration files for the instance. There are three files you need to update: the web.xml file, the JAR file, and the httpd.conf." />
|
|
<meta name="description" content="After you have configured Tomcat on the HTTP server (powered by Apache) to use the Xsockets tool, you must complete manual changes to several configuration files for the instance. There are three files you need to update: the web.xml file, the JAR file, and the httpd.conf." />
|
|
<meta name="DC.Relation" scheme="URI" content="xsockhttp.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="configtomcat.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="testtool.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="updatexml" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Update configuration files</title>
|
|
</head>
|
|
<body id="updatexml"><a name="updatexml"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Update configuration files</h1>
|
|
<div><p>After you have configured Tomcat on the HTTP server (powered by
|
|
Apache) to use the Xsockets tool, you must complete manual changes to several
|
|
configuration files for the instance. There are three files you need to update:
|
|
the web.xml file, the JAR file, and the httpd.conf. </p>
|
|
<div class="p">To complete these steps you need to know the following
|
|
information:<ul><li>The library name that contains the Xsockets application
|
|
files. You created this file during initial <a href="cxsockets.htm#cxsockets">Xsockets
|
|
configuration</a> for an integrated client.</li>
|
|
<li>The server name that you created during <a href="configapache.htm#configapache">HTTP
|
|
server (powered by Apache) configuration</a>.</li>
|
|
</ul>
|
|
</div>
|
|
<ol><li class="stepexpand"><span>Update the web.xml file:</span><ol type="a"><li class="substepexpand"><span>From a command line, enter</span> <pre>wrklnk '/www/<server_name>/webapps/xsock/WEB-INF/web.xml'</pre>
|
|
where <samp class="codeph"><server_name></samp> is the name of the server instance you created
|
|
during Apache configuration. For example, if you choose <samp class="codeph">xsocks</samp> for
|
|
the server name, you can enter: <pre>wrklnk '/www/xsocks/webapps/xsock/WEB-INF/web.xml'</pre>
|
|
</li>
|
|
<li class="substepexpand"><span>Press 2 to edit the file.</span></li>
|
|
<li class="substepexpand"><span>Find the <samp class="codeph"></servlet-class></samp> line in the
|
|
web.xml file.</span></li>
|
|
<li class="substepexpand"><span>Insert the following code after this line: </span> <pre><init-param>
|
|
<param-name>library</param-name>
|
|
<param-value>XXXX</param-value>
|
|
</init-param></pre>
|
|
In place of the XXXX, insert the library name
|
|
that you created during <a href="cxsockets.htm#cxsockets">Xsockets configuration</a>.</li>
|
|
<li class="substepexpand"><span>Save the file and exit the edit session.</span></li>
|
|
</ol>
|
|
</li>
|
|
<li class="stepexpand"><span>Move JAR file</span> From a command line, enter this command: <pre>CPY OBJ('/QSYS.LIB/XXXX.LIB/QATTIFS2.FILE/TSOXSOCK.MBR')
|
|
TOOBJ('/www/<server_name>/webapps/xsock/WEB-INF/lib/tsoxsock.jar')
|
|
FROMCCSID(*OBJ) TOCCSID(819) OWNER(*NEW)</pre>
|
|
where XXXX is the library name that you created during <a href="cxsockets.htm#cxsockets">Xsockets
|
|
configuration</a> and <server_name> is the name of the server instance
|
|
you created during <a href="configapache.htm#configapache">HTTP server
|
|
(powered by Apache) configuration</a>. </li>
|
|
<li class="stepexpand"><strong>Optional: </strong><span>Add the authority check to
|
|
httpd.conf file.</span> This forces Apache to authenticate
|
|
users trying to access the Xsockets Web application. <div class="note"><span class="notetitle">Note:</span> It is also necessary
|
|
for getting write access to create UNIX<sup>®</sup> sockets.</div>
|
|
<ol type="a"><li class="substepexpand"><span>From a command line, enter</span> <pre>wrklnk '/www/<server_name>/conf/httpd.conf'</pre>
|
|
where <em><server_name></em> is the name of the server instance you created during
|
|
Apache configuration. For example, if you choose xsocks for the server name,
|
|
you can enter: <pre>wrklnk '/www/xsocks/conf/httpd.conf''</pre>
|
|
</li>
|
|
<li class="substepexpand"><span>Press 2 to edit the file.</span></li>
|
|
<li class="substepexpand"><span>Insert the following lines at the end of the file. </span> <pre><Location /xsock>
|
|
AuthName "X Socket"
|
|
AuthType Basic
|
|
PasswdFile %%SYSTEM%%
|
|
UserId %%CLIENT%%
|
|
Require valid-user
|
|
order allow,deny
|
|
allow from all
|
|
</Location></pre>
|
|
</li>
|
|
<li class="substepexpand"><span>Save the file and exit the edit session.</span></li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
<div class="section"></div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="xsockhttp.htm" title="The instructions here allow you to enable the Xsockets tool to be accessed through a Web browser. You can implement these instructions multiple times on the same system to create different server instances. This allows multiple versions to run at the same time on different listening ports.">Configure Xsockets to use a Web browser</a></div>
|
|
<div class="previouslink"><strong>Previous topic:</strong> <a href="configtomcat.htm" title="After you have configured HTTP server (powered by Apache) server instance, you must configure Tomcat to use the Xsockets tool in a Web browser.">Configure Tomcat</a></div>
|
|
<div class="nextlink"><strong>Next topic:</strong> <a href="testtool.htm" title="After you have completed manual updates to the configuration files, you are ready to test the Xsockets tool within a browser.">Test Xsockets tool in a Web browser</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |