--- title: 'Logging In with NiceDCV' 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' published: true taxonomy: category: - docs external_links: process: true no_follow: true target: _blank mode: active --- [toc] ## What is Nice DCV?{#nicedcv} 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). ## Prerequisite{#prerequisite} * Please download and install the client software from the following site. <br>[https://download.nice-dcv.com/](https://download.nice-dcv.com/) * 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](https://web.kudpc.kyoto-u.ac.jp/portal/). * Log in to the application server by following the procedure in [logging in with SSH](/login/login). * On Windows, you can also connect with [MobaXterm](/login/mobaxterm). MobaXterm is a handy toolbox that can be used as an x11 server, SSH client, file transfer etc. ## How to Log in{#procedure} NiceDCV can be used with the following application servers. Connection Destination | Address ---------- | ------------ Application Server| app.kudpc.kyoto-u.ac.jp As NiceDCV cannot be used directly from the outside, it is necessary to connect to the application server using the SSH port forwarding function. Please refer to one of the following procedures to connect. ### Setting of the Port forwarding{#forward} #### When using a command prompt or terminal{#cui} 1. Log in to the application server using the ssh command. At that time, port forwarding to **localhost:5901** is performed. ```nohighlight $ ssh {Use ID}@app.kudpc.kyoto-u.ac.jp -L 5901:localhost:5901 Example:When logging in as a b59999 user $ ssh b59999@app.kudpc.kyoto-u.ac.jp -L 5901:localhost:5901 ``` 2. **Do not close the command prompt or terminal** and proceed to [Setting of the Nice DCV client](#connect_nicedcv). #### When using MobaXterm (Windows only){#guiconnection} 1. Start MobaXterm by referring to [How to use MobaXterm](/login/mobaxterm). 2. Click on 'Tunneling' from the toolbar. ![](01_top_toolbar.png?lightbox=100%&resize=450) 3. Click on 'New SSH tunnnel'. ![](02_createtunnel.png?lightbox=100%&resize=450) 4. Check 'Local port forwarding' and enter the following values. * <Forwarded port\>:5901 * <SSH server\>:app.kudpc.kyoto-u.ac.jp * <SSH login\>:Supercomputer system user number (ID) * <SSH port\>:22 * <Remote server\>:localhost * <Remote port\>:5901 5. Click on 'Save'. ![](03_tunnel_settings.png?lightbox=100%&resize=450) 6. Click on the key symbol and select the private key registered in 'Generating Key Pair and Registering Public Key'. 7. Click on the Start button. ![](04_tunnel_start.png?lightbox=100%&resize=450) 8. Log in to the application server. 9. **Do not close the **MobaXterm page** * and proceed to [Setting of the Nice DCV client](#connect_nicedcv). ### Setting of the Nice DCV client{#connect_nicedcv} 1. Execute the following commands on the console connected by [Setting of the Port forwarding](#forward) to register the session. ```nohighlight $ dcv create-session {user ID} (例) $ dcv create-session b59999 ``` 2. After starting the Nice DCV client software, enter **localhost:5901#User ID** in the input field and click Connect. ![](01_dcv_connect_ja.png?lightbox=100%&resize=450) 3. When connecting for the first time, the following warning screen will be displayed because there is a difference between the domain name in the approval notice and the domain name (localhost) when connecting. If the [fingerprint](#fingerprint) displayed matches any of the following, click on 'Trust&Connect' to proceed. ![](02_dcv_checksha1.png?lightbox=100%&resize=450) #### Fingerprint used by app.kudpc.kyoto-u.ac.jp {#fingerprint} | fingerprint | | ----------- | | 8E-EA-71-67-C7-99-0B-C1-BF-34-3A-F8-23-B0-6D-0E-62-B1-4B-2B |    3. Enter the user number in "UserName" and the password used to log in to the "User Portal" in "Password" and click on Login. ![](03_dcv_login_ja.png?lightbox=100%&resize=450) 3. If the connection is successful, GNOME Desktop will be displayed. Please note that the password used to lock the GNOME Desktop screen is the password used to log in to the 'User Portal' (not the passphrase for the private key). ![](04_dcv_desktop.png?lightbox=100%&resize=450) 4. Start Terminal by clicking on 'Applications', then 'System Tools', then 'Terminal'. ![05_dcv_desktop](05_dcv_desktop.png?lightbox=100%&resize=450) ## How to End 1. Execute the following commands on the console connected by [Setting of the Port forwarding](#forward) to end the session. ```nohighlight $ dcv close-session {User ID} (例) $ dcv close-session b59999 ``` ## Notes{#notes} ### The number of Simultaneous Sessions{#max_connection} A user can only register for one session at a time. There is no limit to the number of simultaneous connections to the same session. ### Limit of the Resource{#shigen} * The application server is in the form of a node shared by all users. * The number of CPU cores a user can use simultaneously is **8 cores** and cannot be changed. * The amount of memory a user can use simultaneously is **64 GB** and cannot be changed. * If the elapsed time since the session was registered exceeds 24 hours, the session is forced to terminate. Please note that the session will be reset at the end of the session and will not be resumed. ### DCV Command{#kudcv} The dcv command supports registration, confirmation and termination of the sessions. Please replace the "b59999" with **your use ID of the large-scale computer system**. * Registration of the session ```nohighlight $ dcv create-session b59999 ``` * Confirmation of the session details ```nohighlight $ dcv describe-session b59999 Session: id: b59999 owner: b59999 X display: :1 X authority: /run/user/59999/dcv/b59999.xauth display layout: 800x600+0+0 ``` * Termination of the sessions ```nohighlight $ dcv close-session b59999 ```