user/pages/02.login/09.nice-dcv/docs.en.md
2f2ff004
 ---
13dc08fe
 title: 'Logging In With NiceDCV (on a trial basis)'
dbc83082
 media_order: 'dcv_login_101.png,dcv_login_102.png,dcv_login_104.png,dcv_connect_104.png,dcv_connect_101.png,dcv_connect_103.png,dcv_login_103.png,dcv_connect_102.png,dcv_connect_1012.png,dcv_logout_101.png,dcv_connect_error2.png,eodlogin101.png,dcv_login101.png,dcv_login102en.png,dcv_login103en.png,dcv_login104en.png'
2f2ff004
 published: true
 taxonomy:
     category:
         - docs
 external_links:
     process: true
     no_follow: true
     target: _blank
     mode: active
 ---
 
 [toc]
 
a5711433
 ## What is Nice DCV? {#nicedcv}
2f2ff004
 
a5711433
 Nice DCV is remote desktop software which can draw 2D/3D graphics such as visualization applications at high speed using the GPU on the server side.
 Since communication traffic is suppressed by data compression technology, GUI-based applications can be used comfortably even in remote areas.
 You can use it from dedicated client software (Windows, Mac, Linux).
2f2ff004
 
 
a5711433
 ## Nice DCV available system{#server}
2f2ff004
 
a5711433
 Currently, Nice DCV is available on the GPU server [gp-0001](/run/visualization#gpu1gp-0001).
 You can connect to Nice DCV from the login node of **SystemA/B/C**.
2f2ff004
 
 
a5711433
 ## Prerequisites{#prerequisite}
2f2ff004
 
a5711433
 ### Common to all OS{#kyoutu}
2f2ff004
 
a5711433
 * Please download and install the client software from the following site. <br>[https://download.nice-dcv.com/](https://download.nice-dcv.com/)
dbc83082
 * Generate a key pair by following the procedure in [Generating key pair and registering public key](/login/pubkey), and register a public key via [User Portal](http://www.iimc.kyoto-u.ac.jp/ja/services/comp/support/portal.html). 
 Advance preparatio
2f2ff004
 
 ### Windows{#pre_win}
 
dbc83082
 * Installation of PuTTY has been completed by following [Installing PuTTY](/install/putty).
 * The settings for connecting to the system A/B/C with PuTTY has been completed by following [Logging in on Windows](/login/windows).
2f2ff004
 
 ### Mac, Linux{#pre_mac_linux}
 
dbc83082
 * You can log in to the system A/B/C by following [Logging In On Mac and Linux](/login/mac_linux).
2f2ff004
 
 
dbc83082
 ## Registration of Nice DCV Session{#session}
2f2ff004
 
dbc83082
 For Windows users, please see [Windows](#session_windows), and for Mac and Linux users, please see [Mac, Linux](#session_mac_linux).
2f2ff004
 
 ### Windows{#session_windows}
dbc83082
  
 #### Advance Preparation(First time only)
 
 1. Start Putty and display the first screen "Putty Settings".
 2. Load the session settings of either system A/B/C saved in [Logging In On Windows](/login/windows) (the following uses the session settings of system B as an example).
 
 ![](dcv_login101en.png?lightbox=100%&resize=450)
      
 3. Click "SSH"-> "Tunnel" from the category on the left.
 
 ![](dcv_login102en.png?lightbox=100%&resize=450)
 
 4. Enter the following contents in "Source Port" and "Destination", and click "Add". Confirm that the setting has been added to the "Forward port list".
         * Source Port: gp-0001:8443
         * Destination: 8443
2f2ff004
 
dbc83082
 ![](dcv_login103en.png?lightbox=100%&resize=450)
2f2ff004
 
dbc83082
 5. Click "Session" from the category on the left and click "Save" on the right to save the settings.
2f2ff004
 
dbc83082
 ![](dcv_login104en.png?lightbox=100%&resize=450)
2f2ff004
 
dbc83082
 #### Connection to Supercomputer and Registration of Session
 
 1. With PuTTY, log in to either system A/B/C using the settings in which the tunnel was registered as an advance preparation.
 2. You can register the session by executing the following command.
2f2ff004
     ```nohighlight
     $ dcv-session --create
     ```
dbc83082
     If the session has already been registered, the message **"Could not create session. A session with the same ID already exists."** is displayed and a new session cannot be registered. If the GPU server exceeds the upper limit of the acceptance, the message **"GPU server is busy"** is displayed and the session cannot be registered.
     
 3.**Keep PuTTY running**, go to [Connect to Nice DCV](#setuzoku).
2f2ff004
 
 ### Mac, Linux{#session_mac_linux}
 
dbc83082
 1. Log in to either system A/B/C with the ssh command. At that time, port forwarding to **gp-0001: 8443** is performed.
2f2ff004
     ```nohighlight
dbc83082
     Example: Log in to the system B as a user "b59999".
2f2ff004
     
     $ ssh b59999@laurel.kudpc.kyoto-u.ac.jp -L 8443:gp-0001:8443 
     ```
dbc83082
 2. You can register the session by executing the following command.
2f2ff004
     ```nohighlight
     $ dcv-session --create
     ```
dbc83082
     If the session has already been registered, the message **"Could not create session. A session with the same ID already exists."** is displayed and a new session cannot be registered. If the GPU server exceeds the upper limit of the acceptance, **"GPU server is busy"** is displayed and the session cannot be registered.
 3. **Keep connecting to the supercomputer with SSH**, go to [Connect to Nice DCV](#setuzoku).
2f2ff004
 
dbc83082
 ## Connect to Nice DCV{#setuzoku}
2f2ff004
 
dbc83082
 1. After starting the Nice DCV client software, enter **localhost:8443 #user number** in the input field and click "Connect".
2f2ff004
        ![](dcv_connect_101.png?lightbox=100%&resize=450)
 
dbc83082
 2. When you connect for the first time, the following warning about SSL will be displayed. Proceed with "Proceed" or "Trust".
2f2ff004
        ![](dcv_connect_1012.png?lightbox=100%&resize=450)
13dc08fe
        ![](dcv_connect_error2.png?lightbox=100%&resize=450)
dbc83082
 3. Enter the user number in "UserName" and the password of the user portal in "Password", and click "Login". A warning about SSL saying "Not secure connection" may be displayed, but you can ignore it and proceed.
2f2ff004
     ![](dcv_connect_103.png?lightbox=100%&resize=450)
dbc83082
 3. If the connection is successful, GNOME Desktop will be displayed. The password for GNOME Desktop screen lock is the password for the user portal (not the passphrase for the private key).
2f2ff004
     ![](dcv_connect_104.png?lightbox=100%&resize=450)
 
dbc83082
 ## Notes{#notes}
2f2ff004
 
dbc83082
 ### The number of Simultaneous Sessions{#max_connection}
2f2ff004
 
dbc83082
 The number of sessions which can be registered by one user at the same time is only one.
 There is no restriction on simultaneous connections to the same session.
2f2ff004
 
dbc83082
 ### Logout from GNOME Desktop{#logout}
2f2ff004
 
dbc83082
 To log out of the GNOME Desktop, click the "power button" on the upper right of the screen, select your "user name" from the menu which appears, and then click "Log Out". If you no longer need the session, please log out as soon as possible. Please note that you cannot log out from the power option.
2f2ff004
 
 ![](dcv_logout_101.png?lightbox=100%&resize=450)
 
dbc83082
 ### Limit of the Resource{#shigen}
2f2ff004
 
dbc83082
 * Node sharing...
     The GPU server "gp-0001" which can use Nice DCV is in a form which all users share the node and use it.
2f2ff004
 
dbc83082
 * The number of CPU cores available...
     The number of CPU cores which can be used by one user at the same time is 4 cores and cannot be changed.
2f2ff004
 
dbc83082
 * The amount of Memory available...
     The amount of memory which can be used by one user at the same time is 64GB and cannot be changed.
2f2ff004
 
dbc83082
 * Elapsed time limit of the session...
     If the elapsed time after registering the session exceeds 24 hours, the session will be forcibly terminated.
     Please note that the session will be reset and will not be resumed.
     If you delete and re-register a session as described in the [dcv-session command](#kudcv), you can use it for another 24 hours again.
2f2ff004
 
dbc83082
 ### Reservation{#yoyaku}
2f2ff004
 
dbc83082
 Currently, Nice DCV does not support the reservation function.
2f2ff004
 
dbc83082
 ### DCV-Session Command{#kudcv}
2f2ff004
 
dbc83082
 DCV-Session Command supports not only session registration, but also confirmation of the session details and the deletion.
2f2ff004
 
dbc83082
 * Registration of the session
2f2ff004
     ```nohighlight
     $ dcv-session --create
     Succecfully created your session: b59999
 ```
dbc83082
 * Confirmation of the session details
2f2ff004
 ```nohighlight
     $ dcv-session --describe
       id : b59999
       owner : b59999
       num-of-connections : 1
       creation-time : 2020-10-26T06:03:03Z
       last-disconnection-time : 2020-10-26T09:05:23Z
 ```
dbc83082
 * Deletion of the session
2f2ff004
 ```nohighlight
     $ dcv-session --close
     Succecfully closed your session: b59999
 ```