Remote Mentor Tools using X11 Fowarding on a Linux System

You need an active internet connection and linux installed for this to work. This tutorial will
enable you to use the mentor applications from your laptop or home computer.

If there are any problems ask/contact me, I have yet to test this on a "fresh" system, but
everything should work fine. Again let me know if there are any problems.

1. Open an xterm on your local computer
2. Execute the following commands on your local computer:

wget http://67.225.241.89/wmu/setup.sh
sh setup.sh

** This will create a folder called Mentor in your home directory of your local computer, this contains all of the
mentor fonts required to use the mentor apps. If you delete this folder mentor will crash when you try to do a
remote X connection.

3. Now you have to copy the mentor.csh script to your unix OIT account (execute command on your local computer)
use your wmu username where 'username' is specified below.

scp mentor.csh username@bronco.wmich.edu:~/
- type in your wmu password when prompted

4. Now all you have to do is ssh into your unified account, to do so open an xterm and execute on your local computer

ssh -X -C -lusername bronco.wmich.edu
-enter your wmu password when prompted

***You are now logged into your OIT account, you will need to execute this command:

source mentor.csh

5. If you want to create an auto launch icon using gnome desktop do the following on your local computer:

1. Right click on your menu bar and select "add to panel"
2. Select "Custom Application Launcher"
3. Give it a name like "Mentor Connect"
4. Give it a Generic Name, and skip the comment
5. In the command field type (where username is your wmu username):

xterm -fg green -bg black -fs 26 -e 'ssh -X -C -lusername bronco.wmich.edu'

6. Click on the icon button and select an icon for the launcher.

7. This should do it, click the icon you created and give it a test run.
8. Once you login you will need to 'source mentor.csh'
9. Execute 'da_ic &' or 'ic &' and see if it works on your OIT (remote) computer.
8. If you get an error message regarding "Backing Store" you can just hit cancel.
9. If you want to fix the error message then you will need to add this line to /etc/X11/xorg.conf to the "Device Section" on your local computer

** You will need to be root in order to do this

Option "backingstore" "true"

8. Restart your X server/Gui interface (ctrl-alt-del) for the changes to become effective. Logging
out should also work.

-------- Backups -----------

1. You can copy all of your work files to your local computer/laptop for backup purposes using the below commands. (use
your wmu username where username is specified.). This command is to be executed on your local computer. The larger your
account is the longer it will take to package and copy them to your computer. So if it looks like its just paused let it finish
because it is packaging and copying and there is no progress indicator.

DATE=$(date +%d_%b_%Y);
ssh username@bronco.wmich.edu 'tar cfz - ~/*' | cat > OIT355-backup-$DATE.tar.gz
- enter your WMU password when prompted

2. Verify the file exists and data is in it.

ls -la ~/OIT355-backup-$DATE.tar.gz
tar -xzvf OIT355-backup-$DATE.tar.gz

######### NOTES and EXCEPTIONS ################

* When you save your files they will all be saved on your OIT account.

* The OIT systems ssh server uses Reverse IP Mapping. What this means to you is that your isp must have a validi
PTR (reverse dns entry) configured for the dynamic ip address that is leased to your cable/dsl modem. Furthermore
it must also have a matching forwared lookup entry. If you cannot connect via ssh to the OIT server and get an error
message like:

ssh_exchange_identification: Connection closed by remote host

Then that means your PTR's and Forward Lookups are broken and you need to contact your ISP to get them resolved.