SSHT v1.3 Documentation Section 1) Installing SSHT. Installation is very easy. Simple run the installer. Ex: ./install.sh or sh install.sh This will copy the ssht file into /usr/bin this way it should be able to run as ANY user. If you do not wish to install for every user place the ssht file into your home directory. Although I would recommend just running the install.sh file. If you are installing over version 1.2.x simply run the install.sh script. Section 2) Usage. After installation simply type 'ssht'. If this is the first time you have run the program it will create a directory in your users home directory called '.ssht'. This will keep it a hidden directory so it won't get in your way. After that it will make a files in the .ssht directory called ssht.list, ssht.conf and expert.list Everything is stored in there. Subsection A) Running the script. Type 'ssht' into the shell. That's all. Be sure to check out Subsection E for more options. Subsection B) Adding a new connection. The first time you run it there will not be any listed connections. Type 'a' to add a new connection. You will be asked the following questions: 'Enter in a name for the connection'. Here you can type any name you want to refer to the connection as. 'Enter in a IP or hostname'. Here you can either type in the IP address for the connection or a fully qualified hostname. 'Enter the SSH port'. By default SSH uses port 22. If you use anything else type it in, otherwise simple hit enter. 'Enter in a username to connect as'. The program will check and see who you are currently logged in as. If that is the name you want to use hit enter. Other wise type in the username you wish to use. 'If desired enter in a password hint'. If you sometimes have a hard time remembering all the different passwords you may use you can put a hint here. Here is an example of what you will see: Enter in a Name for the connection > sf Enter an IP or hostname > ssh.sourceforge.net Enter the SSH port used If using default port 22 press enter > Enter in a username to connect with You are currently logged in as tango If you wish to use the same name press enter > DaijoubuKun If desired enter in a password hint > geo+1 Everything after the '>' is what I entered. At this point you will be sent back to the main area. Your new connection will appear as. sf - @ ssh.sourceforge.net Port # 22 As User: DaijoubuKun Subsection C) Editing an entry. The instruction are all pretty much there. This shouldn't be to hard to figure out. Subsection D) Deleting an entry. Once again, pretty easy. WARNING: Once you have typed in the name of the connection you wish to delete and hit enter you CAN NOT bring it back. You much add it as a new connection. Subsection E) Shell options. This is the cool part. As per my example above I have a connection that goes to SourceForge called 'sf'. So if I don't want to see the little interface I can just type 'ssht sf'. This will skip the interface and connect to SourceForge. I highly recommend you do NOT have spaces in connection names, if you do you will NOT be able to start the connections from the command line. Subsection F) Expert connections. If you need more expert style connections use option 'o' in SSHT to turn on expert mode. This is for those who need features like port forwarding since these options are not built into SSHT by default. Section 3) Trouble Shooting. If this is the first time you have connected to the remote SSH you should see a message like: The authenticity of host 'ssh-server.example.com (12.18.429.21)' can't be established. RSA key fingerprint is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx. Are you sure you want to continue connecting (yes/no)? I would usually just say type 'yes'. Just be sure that is the REAL server. 99.99999% of the time it is the one. Every once in a while servers change their RSA keys. This can be a good thing, unfortunately it will stop SSHT from connecting. You will be met with an error message such as: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY! Someone could be eavesdropping on you right now (man-in-the-middle attack)! It is also possible that the RSA host key has just been changed. The fingerprint for the RSA key sent by the remote host is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx. Please contact your system administrator. Add correct host key in /home/user/.ssh/known_hosts to get rid of this message. Offending key in /home/user/.ssh/known_hosts:8 RSA host key for localhost has changed and you have requested strict checking. Host key verification failed. This is not always a bad thing. Although you will want to first make sure something hasn't happened to the server. Most corporate servers will change their RSA keys every year. To fix this problem you will have to open up the file /home//.ssh/known_hosts and remove the offending line. By the example above it's line 8. After that, attempt the connection again and you will be asked if the host is good, type 'yes' and your good to go. The script does not work: Oh no, something is wrong. Well for starters you MUST have SSH (aka OpenSSH) installed. Check your Linux installation. You must have access to run the program, it's located in /usr/bin. If your 'regular user' (ie not root) can't run it you will have to see where you can run it from... but like I said before, I haven't run into that issue. If you do please let me know. You need to have 'awk' installed. Not every Linux distro comes with this, you may need to install it manually. Check with your distro. Lastly, are you running Bash? You better be, or something is very wrong. Section 4) Colorizing Due to limitations in Bash you can not bold and color text at the same time, at least without the color being wrong. When you are editing the color options and you select 'y' on bold you will NOT be asked for a color. Section 5) FAQ Q: I keep getting errors on my screen saying command not found. A: SSHT relies on several other programs to work. Every Linux distro I have tried has these built in. Check the following list to make sure you have these programs and your user has access to them: cat grep awk whoami touch rm mkdir echo read sleep (needed for installation) ln cp chmod chown To the best of my knowledge you should have all these on your machine. If not you may want to consider another Distro. Q: I do not know what SSH is, what do I do? A: Then why are you looking at this? Q: I don't fully understand. This is hard. A: I'm sorry. I must admit I'm not skilled at writing instructions. I do plan on a complete rewrite of the README file and adding built in help options. If you need help check out our forum at forum.tangorangers.com. Q: Why are there only 3 questions in your FAQ? A: Because I can't think of any other reason there would be problems. Maybe if people would e-mail me with problems I could fix them.