MindTerm FAQ
------------
Q1) I can't get the tunnels to work in the applet, what's wrong?
A1) Only if you are running a signed applet, or otherwise have disabled the
security restrictions the browser/appletviewer puts on applets can you use
tunnels.

Q2) I can't connect to the host 'hostname1' from the applet (though I can
connect to 'hostname2' which incidentally is the same host as the web-server
serving the applet).
A2) Only if you are running a signed applet, or otherwise have disabled the
security restrictions the browser/appletviewer puts on applets can you connect
to arbirtrary hosts from it.

Q3) I can't run the applet in Netscape on my Macintosh, what's wrong?
A3) The Netscape on Macintosh does not contain a complete java 1.1.x runtime,
you will have to use the MRJ runtime (found here: http://www.apple.com/java/)
and use it as a plugin (see README).  Or you can use Internet Explorer for the
Macintosh.

Q4) I just get "Applet mindbright.application.MindTerm class
    mindbright.application.MindTerm could not be loaded", what am I doing wrong?
A4) This can depend on many things, for example:
    o You are running from an outdated browser which does not contain a complete
      java 1.1.x runtime (e.g. Netscape v4.05 or less)
    o See "A3"
    o You have installed a html-page containing an APPLET tag referring a
      jar-file that does not exist (tag: "<applet archive="mindtermfull.jar"
      ..." should thus have a file mindtermfull.jar in the doc-root of the
      web-server)
    o There is some class missing in the jar-file that have been accidentally
      removed, check the java-console in the browser to see which class it tries
      to load. If it says it can't load a class that is apparently allready in
      the jar-file, try enabling more output in the java-console of the browser
      to see if it gives more hints.

Q5) When I start the applet in Netscape under Linux the terminal-window get's
displaced off the screen so I can't see the window-title.
A5) This seems to be a bug in the Netscape java-runtime in Linux. Workaround:
don't enable "Window position" in dialog "Terminal Settings" in menu Settings,
also don't give a window-position in the 'gm' parameter either.

Q6) I would like the tunnels I define to be used when reconnecting to the same
ssh-server again.
A6) This is done automatically by default. If you disable "Auto Save Settings"
and/or "Auto Load Settings", you must save and/or load settings manually though.

Q7) When I load the signed applet it can still not connect to any host and I'm
not able to use tunnels in it.
A7) When a signed applet is loaded that was previously loaded as a non-signed
applet in the same instance of the browser, the browser seems to "remember" that
it was previously unsigned and don't give it the right permissions. Workaround:
close the browser and restart it.

Q8) I can't get the ftp-tunneling to work, what's wrong?
A8) Have you created the tunnel with an ftp-plugin? In the "Basic Tunnels
Setup", select protocol "ftp" when creating it, the tunnel should show up in the
text-area with the label "Current local tunnels" and should have the string
"(plugin: ftp)" in the end of the description-string in this text-area. Other
things to check for is of course that the given server really has a ftpd
running.

Q9) I am trying to use a ftp-client through a ftp-tunnel with "ftp PORT
commands" enabled but it does not seem to work.
A9) First of all, proxying ftp PORT-commands is not recomended, if at all
possible use a client which supports "passive mode" ftp, most do. If that is not
possible, check that the "Real sshd address" in the "SSH Settings" dialog is the
ip-address (not hostname) of the machine running the sshd, this will not
necessarily be the case if the sshd is running behind a firewall which is doing
address-translations.

Q10) After I have disconnected from the ssh-server and reconnect the last
session seems not to have closed properly, i.e. a file seems locked or some
such.
A10) The preferred way to disconnect from the ssh-server is to simply logout
from the shell or exit the application running as a single-command, otherwise
the ssh-server might keep the session open causing this behaviour. The logout
procedure can not be done automatically by MindTerm since the way to do it
varies between situations/platforms.
     
Q11) What does the "Send keep-alive" option do? Are ssh-connections timed-out?
A11) It just sends a message (which is ignored by the ssh-server) on the given
interval (in seconds).  This will keep the connection alive both if there is an
idle-timeout set on the ssh-server and if "something" inbetween the client and
the server is timing out (such as a address-translating firewall).

Q12) I'm trying to tunnel X-connections but it does not seem to work, what's
wrong?
A12) By default X-tunneling is turned off in MindTerm (unlike e.g. the
"standard" unix-ssh-client).  Enable it in the "SSH Settings" dialog, also
assure that the X-server on the MindTerm side answers on the given DISPLAY
(e.g. if "Local X11-display" is set to localhost:0 then the X-server should
listen on port 6000 on the same machine as MindTerm is running on).

Q13) Why is there a "Basic.." and an "Advanced..." tunnels dialog? And what are
remote tunnels anyway?
A13) Normally one would only want to set up simple local tunnels, such as to use
imap, smtp etc. on the ssh-server or another server behind it. An advanced user
though might need to set up tunnels going back to the machine running MindTerm,
those are referred to as remote tunnels.

Q14) I created my RSA-identity but I still can't log in to the ssh-server with
it, it says "Server refused our key", why would he want to do that?
A14) Did you read all the instructions in the text-box in the "Create RSA
Identity" dialog?  (hint: put the contents of the identity.pub file into the
file ~/.ssh/authorized_keys on the ssh-server).

Q15) I don't seem to get a menu-bar in the applet eventhough I wanted to, what's
wrong?
A15) When running inside the browser-window (i.e. as opposed to in a separate
frame), it is not possible to have a menu-bar. This is a limitation of java and
can not (easily) be fixed.

Q16) The terminal seems to have quirks, such as giving reverse video, strange
looking output or wrong settings in general, what's causing this?
A16) There could be a mismatch between the terminal setting in the shell on the
server and in MindTerm, the ssh-server should e.g. set the TERM environment
variable to the right string upon login, but sometimes it gets set to something
else by login-scripts etc. Check that the TERM environment variable is really
set to the same as the "Terminal type" in the "Terminal Settings" dialog in
MindTerm. Another possibility is of course that MindTerm has a bug, in which
case I would be glad if you gave an as detailed report as possible of
what/when/how/where this happened. A third possibility is that the
terminal-libraries on the server is either buggy or does not think the same
about the terminal mode used as MindTerm try with different terminal modes to
see what happens.

Q17) Backspace/Delete does not seem to work, what's wrong?
A17) Backspace (and Delete) can be sent using different ascii-codes, try
changing what is sent with the "Backspace sends Delete" and vice versa in the
"Terminal Misc..." dialog.  (see also Q16)

Q18) I get strange terminal behaviour with a ssh-server running Digital Unix,
what's wrong? (e.g. scrolling does not seem to work within VI)
A18) There seems to be something wrong with using terminal mode vt100 on Digital
Unix, if possible use another terminal mode. Also see Q17.

Q19) When MindTerm is started in Netscape on Linux the window resizes and then
it seems to hang?
A19) It has not hung, it just lost keyboard focus, there seems to be something
strange with the focus-handling, try minimizing the window or let another window
have focus the go back to the MindTerm window that froze and it should be ok.

Q20) When adding tunnels, what's the deal, it functions the same whether I'm
connected or not?
A20) When not connected, adding a tunnel just adds it to the current
settings. If you add it while connected it is also opened and fully operational
as soon as you have added it.

Q21) I have a tunnel configured, it shows up in Basic/Advanced tunnel-dialogs
but the current connections dialog is empty, where did it go?
A21) The current connections dialog just shows open connections through the
tunnels, not the tunnels themselves.

Q22) The clipboard does not seem to work, I can only copy/paste within
MindTerm, what's wrong?
A22) There are two explanations here:
     o When running as an unsigned applet MindTerm do not have access
       to the system-clipboard but instead uses its own "local"
       clipboard instead
     o The java runtime in netscape does not support copy/paste
       to/from the system-clipboard. This is the case in Netscape on
       Linux for example.