Difference between revisions of "Using a VNC Server/Client"
From Hall A Wiki
(→Downloading the Software) |
|||
Line 2: | Line 2: | ||
== Downloading the Software == | == Downloading the Software == | ||
You'll need two pieces of software: | You'll need two pieces of software: | ||
− | [[Image:puttyvncicons.png|left| | + | [[Image:puttyvncicons.png|left|VNC and PuTTY icons on the Desktop]] |
* VNC client (lets you view the remote screen). Either client below should work | * VNC client (lets you view the remote screen). Either client below should work | ||
Line 91: | Line 91: | ||
** Click on the '''Open''' button at the bottom of the dialog box. A black terminal will open and prompt you to login to the '''hacweb14''' machine. | ** Click on the '''Open''' button at the bottom of the dialog box. A black terminal will open and prompt you to login to the '''hacweb14''' machine. | ||
** You will use the '''hacuser''' password here. Type it in and you should get a normal shell prompt '''[hacuser@hacweb14]#''' | ** You will use the '''hacuser''' password here. Type it in and you should get a normal shell prompt '''[hacuser@hacweb14]#''' | ||
− | ** You can now ''minimize'' this window (<i>do NOT</i> quit PuTTY) and move on to running the VNC client | + | ** You can now ''minimize'' this window (<i>do NOT</i> quit PuTTY) and move on to running the VNC client |
<br clear=all> | <br clear=all> | ||
− | == Running | + | == Running VNC Client == |
+ | |||
+ | NOTE: Then snapshots below are for an older software called UltraVNC. | ||
+ | I'll update the snapshots soon, but you'll have to find the equivalents | ||
+ | in the VNC client you use. | ||
==== Run '''vncviewer.exe''' ==== | ==== Run '''vncviewer.exe''' ==== | ||
Line 112: | Line 116: | ||
==== Quitting the VNC session ==== | ==== Quitting the VNC session ==== | ||
− | * Be sure to close the | + | * Be sure to close the VNC program window, ''not'' one of the windows running |
inside the VNC session. | inside the VNC session. | ||
* Any program/stripchart that you start inside the VNC session will keep | * Any program/stripchart that you start inside the VNC session will keep | ||
Line 124: | Line 128: | ||
# Run PuTTY, select 'Step 1', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running) | # Run PuTTY, select 'Step 1', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running) | ||
# Run PuTTY, select 'Step 2', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running) | # Run PuTTY, select 'Step 2', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running) | ||
− | # Run | + | # Run your VNC Client and Connect (generally it will default to the settings you saved earlier, but you may need to ''load'' a configuration) |
= Instructions for Linux = | = Instructions for Linux = |
Revision as of 10:56, 31 October 2019
Contents
- 1 Instructions for Windows
- 2 Instructions for Linux
- 3 Setting up the VNC Server
- 4 Killing the VNC Server
Instructions for Windows
Downloading the Software
You'll need two pieces of software:
- PuTTY (lets the client talk to the remote machine through the firewall): PuTTY.
- You want to save the putty.exe to your Desktop.
Setting up PuTTY
NOTE: The PuTTY screenshots below only examples. Do not copy them blindly, be sure to read the notes in each section.
This is a 2-step process.
Step 1: Tunnel between your machine and JLab
Run PuTTY and create a Step 1 configuration.
Configure host name of remote machine
- Set Host Name to hallgw.jlab.org
- Set Saved Sessions field to Step 1
Configure user name
- Select the Data entry under Connection in the left column.
- Set Auto-login username field to your JLab username.
Configure tunnel
- Click on the + next to SSH in the list on the left, then select Tunnels.
- Set Source port to 2300 + the last 2 digits of your phone number.
- Note: the port in this step just needs to be unique for each person connecting. The 'phone number' thing is just a way to make a number likely to be unique to you. For example, if your phone number ends with 4321 then set the port to 2321
- Set Destination to hacweb14:22
- Then click on the Add button.
Save configuration
- Select the Session entry in the left column (scroll up if you have to), and click on the Save button. This will save your settings for Step 1.
Step 2: Tunnel between your machine and hacuser@hacweb14
We will now repeat the above steps to create a Step 2 configuration.
Configure host name of remote machine
- Set Host Name to localhost
- Set Port to the Source port you chose in Step 1 above (ie. 2321 in the above example)
- Set Saved Sessions field to Step 2
Configure user name
- Select the Data entry under Connection in the left column.
- Set Auto-login username field to hacuser
Configure tunnel
- Click on the + next to SSH in the list on the left, then select Tunnels.
- Set Source port to 5901
- Set Destination to localhost:5901
- Then click on the Add button.
NOTE: After clicking Add you should only see a single line that looks like this in the Forwarded ports: field. 5901 localhost:5901 If you see a second line, click on it, then click the Remove button to delete it.
Save configuration
- Select the Session entry in the left column (scroll up if you have to), and click on the Save button. This will save your settings for Step 2.
Setting up the Tunnel using your settings
- Run PuTTY and select Step 1 from the Saved Sessions list and click Load.
- Click on the Open button at the bottom of the dialog box. A black terminal will open and prompt you to login to the hallgw machine.
- You will use your CUE 2-factor login here. Type it in and you should get a normal shell prompt like this: [<username>@hallgw1]~%
- You can now minimize this window (do NOT quit PuTTY).
- Run PuTTY a 2nd time and select Step 2 from the Saved Sessions list and click Load.
- Click on the Open button at the bottom of the dialog box. A black terminal will open and prompt you to login to the hacweb14 machine.
- You will use the hacuser password here. Type it in and you should get a normal shell prompt [hacuser@hacweb14]#
- You can now minimize this window (do NOT quit PuTTY) and move on to running the VNC client
Running VNC Client
NOTE: Then snapshots below are for an older software called UltraVNC. I'll update the snapshots soon, but you'll have to find the equivalents in the VNC client you use.
Run vncviewer.exe
- Enter localhost:5901 in the "VNC Server:" field at the top.
- Enable the Save connection settings as default at the bottom.
Connect to the VNC session
- Click on the Connect button and you should see a couple of windows pop up:
- Enter the hacuser password in the appropriate box and hit return.
- You should be rewarded with the hacuser window session.
- NOTE: If you get a black screen with yet another password prompt, it means the screen saver software has kicked in. Just type in the 'hacuser' password again and you'll be good to go.
Quitting the VNC session
- Be sure to close the VNC program window, not one of the windows running
inside the VNC session.
- Any program/stripchart that you start inside the VNC session will keep
running and updating in the background. You can reconnect to the VNC session anytime from (nearly) any machine.
To Summarize
After setting up the PuTTY configurations, you can do the following:
- Run PuTTY, select 'Step 1', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running)
- Run PuTTY, select 'Step 2', and click 'Load', then 'Open', login, then minimize that PuTTY window (leave it running)
- Run your VNC Client and Connect (generally it will default to the settings you saved earlier, but you may need to load a configuration)
Instructions for Linux
- Type the following at a shell prompt (ie. in an xterm)
vncviewer -Shared -via hacuser@hacweb14 :1
- When prompted, enter the hacuser password (twice)
- NOTE: If you get a black screen with yet another password prompt, it means the screen saver software has kicked in. Just type in the 'hacuser' password again and you'll be good to go.
Setting up the VNC Server
NOTE: This rarely needs to be done. Once it is started it will stay running even after you disconnect. In general, the vncserver will only need to be restarted if the hacweb14 machine is rebooted.
- Log in to hacuser@hacweb14
- Start the vncserver by running:
[hacuser@hacweb14]# vncserver -geometry 1900x1100 :1
Killing the VNC Server
This will quit the server and all applications that were running under that server.
[hacuser@hacweb14]# vncserver -kill :1