64 | | |
65 | | The following steps are necessary to start a VNC session for remote rendering with !VisIt on JURECA. \\ |
66 | | Please notice that the VNC server is only available on vis-nodes! |
67 | | |
68 | | === 1. Start VNC server on a vis node |
69 | | Open an ssh shell on any login node of JURECA the usual way.\\ |
70 | | |
71 | | salloc is used to request an allocation. When the job is started, a shell (or other program specified on the command line) is started on the submission host (login node). From the shell srun can be used to interactively spawn parallel applications. The allocation is released when the user exits the shell. |
| 64 | ==== ok, what do I have to do? |
| 65 | Using VNC requires two general steps. |
| 66 | 1. '''Start a VNC server''' on a JURECA node. |
| 67 | 2. '''Tunnel VNC traffic''' to your workstation. |
| 68 | |
| 69 | \\ |
| 70 | === 1. Start VNC server ... |
| 71 | The following steps are necessary to start a VNC server on JURECA. \\ |
| 72 | Please notice that you have two general options: |
| 73 | |
| 74 | You can start the VNC server ... |
| 75 | * ... on an '''interactive vis login node''' |
| 76 | * + no batch system == instant access |
| 77 | * -- system is shared with other users |
| 78 | * ... on a '''dedicated vis node''' |
| 79 | * + system is not shared (exclusive use) |
| 80 | * -- access through batch system |
| 81 | |
| 82 | In case the VNC server could successfully be started (details in 1a,b), you will find a simular line in the output: |
| 83 | {{{ #!sh |
| 84 | Desktop 'TurboVNC: jrc1391.zam.kfa-juelich.de:1 (<USERID>)' started on display jrc1391.fz-juelich.de:1 |
| 85 | }}} |
| 86 | |
| 87 | Two important informations have to be taken from this output \\ |
| 88 | to setup the required SSH tunnel (with the correct network port) to the allocated node in step 2: |
| 89 | 1. The allocated node is '''jrc1391''' |
| 90 | 2. The number of the VNC display is ''':1''' |
| 91 | |
| 92 | It is very important to know that the network port of the VNC server depends on this display number. \\ |
| 93 | The actual port number is 5900+<VNC display>, therefore port '''5901''' must be tunneled in this case. |
| 94 | |
| 95 | Important notes: |
| 96 | * To ensure VNC sessions are not forgotten and keep on running forever, they will be '''killed after 24 hours ''' (WITHOUT warning). |
| 97 | * Logout from your VNC session, after you have finished your work. This will save resources and close the VNC server. \\ |
| 98 | * If you start the VNC server the first time, you will be asked for a password (which is stored in ~/.vnc/passwd). \\ |
| 99 | You will be asked for this password by the VNC viewer, when you connect to the VNC server. \\ |
| 100 | To reset the password just delete the file ~/.vnc/passwd. |
| 101 | |
| 102 | ==== a. ... on an interactive vis login node |
| 103 | Open a SSH shell on an interactive vis login node (jurecavis.fz-juelich.de): |
| 104 | {{{ #!sh |
| 105 | ssh <USERID>@jurecavis.fz-juelich.de |
| 106 | }}} |
| 107 | |
| 108 | Start your own VNC server on jurecavis. |
| 109 | Usefull vncserver parameters are: |
| 110 | * -profile -> choose a profile (eg. -profile vis) |
| 111 | * -geometry -> set the screen size (eg. -geometry 1920x1080) |
| 112 | {{{ #!sh |
| 113 | vncserver |
| 114 | }}} |
| 115 | |
| 116 | ==== b. ... on a dedicated vis node |
| 117 | Open an SSH shell on any login node of JURECA the usual way: |
| 118 | |
| 119 | {{{ #!sh |
| 120 | ssh <USERID>@jureca.fz-juelich.de |
| 121 | }}} |
| 122 | |
| 123 | salloc is used to request an allocation.\\ |
| 124 | When the job is started, a shell (or other program specified on the command line) is started on the submission host (login node). \\ |
| 125 | From the shell srun can be used to interactively spawn parallel applications. \\ |
| 126 | The allocation is released when the user exits the shell. |
88 | | vncserver options |
89 | | * -fg -> start VNC server in the foreground (ensure the end of job-script is not reached, as this will stop the job) |
90 | | * -profile -> choose a profile (eg. default, vis) |
91 | | * -geometry -> set the screen size (optional) |
92 | | |
93 | | In case the VNC server could successfully be started, you will get an output like: |
94 | | {{{ #!sh |
95 | | Desktop 'TurboVNC: jrc1384.zam.kfa-juelich.de:1 (<USERID>)' started on display jurecavis01.fz-juelich.de:1 |
96 | | }}} |
97 | | |
98 | | As you have to setup an ssh tunnel (with the correct network port) to the allocated node in step 2, \\ |
99 | | two important informations have to be taken from this output: |
100 | | 1. The allocated node is '''jrc1391''' |
101 | | 1. The number of the VNC display is ''':1''' |
102 | | |
103 | | It is very important to know that the network port of the VNC server depends on this display number. \\ |
104 | | The actual port number is 5900+<VNC display>, therefore port '''5901''' must be tunneled in this case. |