?? freehost.html
字號:
<HTML><HEAD><!-- Created by texi2html 1.56k from freehost.texi on 17 January 2002 --><TITLE>FreeHost 3270 version 0.1
</TITLE></HEAD><BODY><H1>FreeHost 3270 User's Manual
</H1><H2>version 0.1
</H2><ADDRESS>Art Gillespie
</ADDRESS><P><P><HR><P><H1><A NAME="SEC1" HREF="freehost_toc.html#TOC1">Overview</A></H1><P>
<H2><A NAME="SEC2" HREF="freehost_toc.html#TOC2">What is FreeHost 3270?</A></H2><P>FreeHost 3270 is a set of Java Servlets and a Java Applet that enable sites to deploy TN3270 applications to multiple clients via the Web (or on an intranet or VPN). With FreeHost 3270, a single servlet container + web server can deliver TN3270 clients as well as proxied connectivity to a virtually limitless number of users through their browser. The FreeHost 3270 client applet was written to be compatible with the earliest Java implementations and does not require that users download the Java 1.2 plugin for VM compatability.
<H2><A NAME="SEC3" HREF="freehost_toc.html#TOC3">Architecture</A></H2><P>
<H2><A NAME="SEC4" HREF="freehost_toc.html#TOC4">Helping out</A></H2><P>FreeHost 3270 needs all the help it can get. Anyone interested in testing, submitting patches, writing documentation, suggesting new features, and so on is welcome to do so at <A HREF="http://sourceforge.net/projects/freehost3270">http://sourceforge.net/projects/freehost3270</A>.
<H2><A NAME="SEC5" HREF="freehost_toc.html#TOC5">Reporting bugs</A></H2><P>If you think you've found a bug in FreeHost 3270, you probably have... please don't keep it to yourself. Bug reports are an invaluable part of open-source participation. Visit our bug-tracking system at <A HREF="http://sourceforge.net/projects/freehost3270/">http://sourceforge.net/projects/freehost3270/</A>. Of course, you're always welcome to patch against the latest sources section <A HREF="freehost.html#SEC7">Where to get FreeHost 3270</A> and send patches to <A HREF="mailto:agillesp@i-no.com">agillesp@i-no.com</A>.
<H1><A NAME="SEC6" HREF="freehost_toc.html#TOC6">Installation</A></H1><P>
<H2><A NAME="SEC7" HREF="freehost_toc.html#TOC7">Where to get FreeHost 3270</A></H2><P>You can always download the latest release of FreeHost 3270 at <A HREF="http://www.sourceforge.net/projects/freehost3270/">http://www.sourceforge.net/projects/freehost3270/</A>
For those who want/need access to the latest source updates, anonymous CVS access is available.
The following commands should do the trick.
<PRE>cvs -d:pserver:anonymous@cvs.freehost3270.sourceforge.net:/cvsroot/freehost3270 login
</PRE><P>When CVS prompts you for a password, press <KBD>ENTER</KBD>, then
<PRE>cvs -z3 -d:pserver:anonymous@cvs.freehost3270.sourceforge.net:/cvsroot/freehost3270 co freehost3270
</PRE><P>Eventually, I'll put a separate section on building from source in this here documentation. In the meantime, there's a standard ant <TT>`build.xml'</TT> file in the top-level project directory. Make sure you have ant installed <A HREF="http://jakarta.apache.org/ant/">http://jakarta.apache.org/ant/</A>, cd to <TT>`my-development-dir/freehost3270'</TT> type 'ant', and you should be all set.
<H2><A NAME="SEC8" HREF="freehost_toc.html#TOC8">Installing FreeHost 3270</A></H2><P>
Installing FreeHost 3270 is so easy, it hurts to think about it. Simply drop the <TT>`freehost-version.war'</TT> file from the distribution in your Servlet Container's <TT>`./webapps/'</TT> directory.
If your servlet container requires you to restart in order to deploy a new war, do so.
The configuration defaults in the distrubition are sensible enough that you should be able to test your FreeHost 3270 installation now. Open your favorite browser and point it at whatever url makes sense in your environment:
<A HREF="http://localhost:8080/freehost3270/freehost">http://localhost:8080/freehost3270/freehost</A>
The FreeHost TN3270 Emulator should pop up and connect to Harvard's HOLLIS information system. (Assuming your host is connected to the web and is able to get out on port 23.)
<H2><A NAME="SEC9" HREF="freehost_toc.html#TOC9">Configuring FreeHost 3270</A></H2><P>FreeHost 3270 is configured through the <TT>`WEB-INF/freehost.properties'</TT> file. What follows
is a short description of each entry<A NAME="DOCF1" HREF="freehost_foot.html#FOOT1">(1)</A>;.
<DL><DT><U>Config:</U> <B>sessionServerHost</B><DD><A NAME="IDX1"></A>The SessionServer host that tn3270 clients will connect back to. Note that in the case of the Java TN3270 emulator applet, this hostname must match the hostname that was used to deliver the applet in order to satisfy Java Applet sandbox security conditions.
</DL>
<DL><DT><U>Config:</U> <B>sessionServerPort</B><DD><A NAME="IDX2"></A>The port the SessionServer will listen on. Note that in the next release (0.2), this will no longer be necessary as all communication will take place through HTTP Tunneling. In the meantime, hosts and clients must ensure that this port is open on their networks for listening and connecting, respectively.
</DL>
<DL><DT><U>Config:</U> <B>hostList</B><DD><A NAME="IDX3"></A>A pipe-delimited list of hosts. These are the hosts that clients will see in their 'Connect' menu. If the <VAR>manualEntry</VAR> configuration variable is set to 'false', these are the <EM>only</EM> hosts the client will be able to connect to. Each host entry has the format:
<PRE><hostname>|<port>|<friendlyname>
</PRE><P>where <VAR>friendlyname</VAR> is the name that clients will see in their 'Connect' menu.
</DL>
<DL><DT><U>Config:</U> <B>manualEntry</B><DD><A NAME="IDX4"></A>If set to true, allows users to enter their own hosts as well as select from the hosts specified in <VAR>hostList</VAR>
</DL>
<DL><DT><U>Config:</U> <B>helpabout</B><DD><A NAME="IDX5"></A>String that will appear in the TN3270 Java Applet's 'help->about' dialog. Administrators may want to put support contact information here for users.
</DL>
<DL><DT><U>Filtering:</U> <B>filterList</B><DD><A NAME="IDX6"></A>Comma-separated list of ip filters. Wildcards are allowed
<PRE>127.0.* The entire class C subnet.
127.0.0.* The entire class D subnet.
</PRE><P>The semantic meaning of these filters is modified by the <VAR>filterMode</VAR> configuation directive.
</DL>
<DL><DT><U>Filtering:</U> <B>filterMode</B><DD><A NAME="IDX7"></A>Specifies behavior of filters in filterList.
<UL><LI>0 = none<LI>1 = allow from (all hosts specified in filter list)<LI>2 = disallow from (all hosts <EM>except</EM> specified in filter list)</UL></DL><P>
<DL><DT><U>Admin:</U> <B>adminEmail</B><DD><A NAME="IDX8"></A>The e-mail address of the FreeHost 3270 administrator. The FreeHost SessionServer will send e-mail to this address according to the email* options below.
</DL>
<DL><DT><U>Admin:</U> <B>smtpserver</B><DD><A NAME="IDX9"></A>The SMTP server to use for sending administrative e-mails
</DL>
<DL><DT><U>Admin:</U> <B>emailNotifyXSessionsAreActive</B><DD><A NAME="IDX10"></A>If > 0, send an email when the SessionServer has this many sessions concurrently active.
</DL>
<DL><DT><U>Admin:</U> <B>emailNotifyHostNotResponding</B><DD><A NAME="IDX11"></A>If true, send an e-mail to <VAR>adminEmail</VAR> if connections to the TN3270 gateway host should fail.
</DL>
<H2><A NAME="SEC10" HREF="freehost_toc.html#TOC10">Troubleshooting</A></H2><P>If you're having any problems getting FreeHost 3270 to work the way you expect it to, be sure to check the FreeHost 3270 home page at <A HREF="http://freehost3270.sourceforge.net">http://freehost3270.sourceforge.net</A> and the project page at SourceForge: <A HREF="http://sourceforge.net/projects/freehost3270">http://sourceforge.net/projects/freehost3270</A>. Here you'll find mailing list archives and how to subscribe to the user's mailing list, where you can have your question answered by other FreeHost 3270 users and developers.
In the meantime, here are couple of common problems and their common solutions:
<UL><LI><EM>The Java TN3270 applet never shows me the TN3270 connection I'm expecting.</EM> In order:<OL><LI>Check to see that the host that the SessionServer servlet is running on can connect to the TN3270 gateway host.<LI>Check to ensure that the sessionServerHost configuration variable in <TT>`freehost.properties'</TT> matches the host you typed in your browser... The Java Applet Security Manager will only let applets connect to the <EM>same host from which they were served</EM>, so if you have <VAR>localhost</VAR> in your <TT>`freehost.properties'</TT> and you typed in <A HREF="http://www.myserver.org/">http://www.myserver.org/</A>, the applet won't be able to connect to the SessionServer servlet.<LI>If the client is behind a firewall, be sure they can connect out on the port specified by <VAR>sessionServerPort</VAR> in <TT>`freehost.properties'</TT>. Naturally, getting a corporate network lackey to open a port is difficult at best (as it should be). I've found that you can set the SessionServer port to 443 (the HTTPS port) and succeed in most firewall environments. Good news, though; in version 0.2, FreeHost 3270 will support HTTP Tunneling (connect back to the SessionServer on port 80, using HTTP headers and HTTP keep-alive), so this won't be an issue for much longer.</OL><LI><EM>I get a burning sensation when I urinate.</EM> Go see a doctor immediately. Be prepared to make some embarrassing phone calls.</UL><P>
<H1><A NAME="SEC11" HREF="freehost_toc.html#TOC11">Licenses</A></H1><P>
<H2><A NAME="SEC12" HREF="freehost_toc.html#TOC12">GNU LESSER GENERAL PUBLIC LICENSE</A></H2><P>
<A NAME="IDX12"></A>Version 2.1, February 1999
<PRE>Copyright (C) 1991, 1999 Free Software Foundation, Inc.
59 Temple Place -- Suite 330, Boston, MA 02111-1307, USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
[This is the first released version of the Lesser GPL. It also counts
as the successor of the GNU Library Public License, version 2, hence the
version number 2.1.]
</PRE><P>
<H3><A NAME="SEC13" HREF="freehost_toc.html#TOC13">Preamble</A></H3><P>
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
Licenses are intended to guarantee your freedom to share and change
free software--to make sure the software is free for all its users.
This license, the Lesser General Public License, applies to some
specially designated software--typically libraries--of the Free
Software Foundation and other authors who decide to use it. You can use
it too, but we suggest you first think carefully about whether this
license or the ordinary General Public License is the better strategy to
use in any particular case, based on the explanations below.
When we speak of free software, we are referring to freedom of use,
not price. Our General Public Licenses are designed to make sure that
you have the freedom to distribute copies of free software (and charge
for this service if you wish); that you receive source code or can get
it if you want it; that you can change the software and use pieces of it
in new free programs; and that you are informed that you can do these
things.
To protect your rights, we need to make restrictions that forbid
distributors to deny you these rights or to ask you to surrender these
rights. These restrictions translate to certain responsibilities for
you if you distribute copies of the library or if you modify it.
For example, if you distribute copies of the library, whether gratis
or for a fee, you must give the recipients all the rights that we gave
you. You must make sure that they, too, receive or can get the source
code. If you link other code with the library, you must provide
complete object files to the recipients, so that they can relink them
with the library after making changes to the library and recompiling
it. And you must show them these terms so they know their rights.
We protect your rights with a two-step method: (1) we copyright the
library, and (2) we offer you this license, which gives you legal
permission to copy, distribute and/or modify the library.
To protect each distributor, we want to make it very clear that
there is no warranty for the free library. Also, if the library is
modified by someone else and passed on, the recipients should know
that what they have is not the original version, so that the original
author's reputation will not be affected by problems that might be
introduced by others.
Finally, software patents pose a constant threat to the existence of
any free program. We wish to make sure that a company cannot
effectively restrict the users of a free program by obtaining a
restrictive license from a patent holder. Therefore, we insist that
any patent license obtained for a version of the library must be
consistent with the full freedom of use specified in this license.
Most GNU software, including some libraries, is covered by the
ordinary GNU General Public License. This license, the GNU Lesser
General Public License, applies to certain designated libraries, and
is quite different from the ordinary General Public License. We use
this license for certain libraries in order to permit linking those
libraries into non-free programs.
When a program is linked with a library, whether statically or using
a shared library, the combination of the two is legally speaking a
combined work, a derivative of the original library. The ordinary
General Public License therefore permits such linking only if the
entire combination fits its criteria of freedom. The Lesser General
Public License permits more lax criteria for linking other code with
the library.
We call this license the <EM>Lesser</EM> General Public License because it
does <EM>Less</EM> to protect the user's freedom than the ordinary General
Public License. It also provides other free software developers Less
of an advantage over competing non-free programs. These disadvantages
are the reason we use the ordinary General Public License for many
libraries. However, the Lesser license provides advantages in certain
special circumstances.
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -