--- title: 'Logging In with FastX' media_order: 'fastx_login_200.png,fastx_login_1022.png,fastx_login_101.png,fastx_login_102.png,fastx_login_103.png,fastx_login_104.png,fastx_login_105.png,fastx_login_106.png,fastx_login_107.png,fastx_login_108.png,fastx_login_109.png,fastx_login_110.png,fastx_login_201.png,fastx_login_202.png,fastx_login_203.png,fastx_login_204.png,fastx_login_205.png,fastx_login_301.png' taxonomy: category: - docs visible: true published: true --- [toc] ## What is FastX?{#fastx} FastX is a X Window System that can connect to supercomputer systems using HTTPS (443/TCP). Communication traffic is suppressed by data compression technology and you can use the system comfortably such as GUI-based application operations even in remote areas. A web browser such as Google Chrome or Firefox is required to use remote access service of FastX. It is not necessary to install dedicated client software or plug-in for the web browser. <!-- 専用のクライアントソフト(Windows版)からの利用のほか、ブラウザから利用することも可能です。この場合はクライアントソフトのインストール不要でご利用できます。 --> ## Prerequisites{#before} * Generate a key pair by the procedure of [Generating Key Pair and Registering Public Key](/login/pubkey), and then register a public key from [User Portal](https://web.kudpc.kyoto-u.ac.jp/portal/) . Also, **the private key must be saved in OpenSSH format (PEM format prior to 7.7).** * Compatible browsers:Edge, Firefox, Chrome * Bidirectional copy-pasting is only supported by Chrome. With other browsers, you can only copy and paste from the server side to the client side. ### Format of the Private Key{#format} FastX is not available in ECDSA and ED25519 format keys, so please use RSA format keys. The private key in OpenSSH 7.8 or later formats cannot be loaded. In OpenSSH 7.8 or later formats, the private key has the following contents. ```nohighlight -----BEGIN OPENSSH PRIVATE KEY----- ************************************* ************************************* ************************************* -----END OPENSSH PRIVATE KEY----- ``` To create a private key in OpenSSH 7.8 or earlier format with the ssh-keygen command, use the `-m pem` option as follows. ```nohighlight $ ssh-keygen -t rsa -b 3072 -m pem ``` The private key in OpenSSH 7.8 or earlier format (PEM format) has the following contents. ```nohighlight -----BEGIN RSA PRIVATE KEY----- Proc-Type: 4,ENCRYPTED DEK-Info: AES-128-CBC,7A30F993641D4093A373703A3F644D2D ************************************* ************************************* ************************************* -----END RSA PRIVATE KEY----- ``` ## How to Log in{#procedure} <!-- ### For Browser{#procedure_browser} --> 1. Start your browser and go to one of the following addresses. Connection Destination | Address ---------- | ------------ System A | [https://camphor31.kudpc.kyoto-u.ac.jp/](https://camphor31.kudpc.kyoto-u.ac.jp/) System B/C | [https://laurel31.kudpc.kyoto-u.ac.jp/](https://laurel31.kudpc.kyoto-u.ac.jp/) System G | [https://gardenia31.kudpc.kyoto-u.ac.jp/](https://gardenia11.kudpc.kyoto-u.ac.jp/) Application Server | [https://app.kudpc.kyoto-u.ac.jp/](https://app.kudpc.kyoto-u.ac.jp/) <!-- camphor31 | [https://camphor31.kudpc.kyoto-u.ac.jp/](https://camphor31.kudpc.kyoto-u.ac.jp/) camphor32 | [https://camphor32.kudpc.kyoto-u.ac.jp/](https://camphor32.kudpc.kyoto-u.ac.jp/) lauerl31 | [https://laurel31.kudpc.kyoto-u.ac.jp/](https://laurel31.kudpc.kyoto-u.ac.jp/) lauerl32 | [https://laurel32.kudpc.kyoto-u.ac.jp/](https://laurel32.kudpc.kyoto-u.ac.jp/) lauerl33 | [https://laurel33.kudpc.kyoto-u.ac.jp/](https://laurel33.kudpc.kyoto-u.ac.jp/) gardenia11 | [https://gardenia11.kudpc.kyoto-u.ac.jp/](https://gardenia11.kudpc.kyoto-u.ac.jp/) gardenia12 | [https://gardenia12.kudpc.kyoto-u.ac.jp/](https://gardenia12.kudpc.kyoto-u.ac.jp/) gardenia13 | [https://gardenia13.kudpc.kyoto-u.ac.jp/](https://gardenia13.kudpc.kyoto-u.ac.jp/) gardenia14 | [https://gardenia14.kudpc.kyoto-u.ac.jp/](https://gardenia14.kudpc.kyoto-u.ac.jp/) なお、https://laurel.kudpc.kyoto-u.ac.jp/ や https://camphor.kudpc.kyoto-u.ac.jp/ 、https://gardenia.kudpc.kyoto-u.ac.jp/ (DNSラウンドロビンアドレス)にアクセスしても接続できますが、ブラウザのDNSキャッシュの更新タイミングで接続が切れる可能性があります。 --> 2. **(First time only)** Click "Manage Private Keys". A small window prompting you to upload the private key opens. Click "+" and select the private key of the OpenSSH format. ![](01_pubkey_management.png?lightbox=100%&resize=600) ![](02_add_pubkey.png?lightbox=100%&resize=600) 3. **(First time only)**Check that the name of the uploaded private key is displayed in the blue frame and click 'Done'. ![](03_select_pubkey.png?lightbox=100%&resize=600) 4. Enter the user ID in the blue frame and click 'SSH Login'. ![](04_login.png?lightbox=100%&resize=600) 5. Enter the passphrase in the blue frame and click 'Submit'. ![](05_login_input_password.png?lightbox=100%&resize=600) 6. Select the application to start.<br> 6-1. To use the terminal, double-click "GNOME Terminal" in the green frame.<br> 6-2. To use the desktop screen, double-click "GNOME" in the blue frame. ![](06_new_session_2.png?lightbox=100%&resize=600) 7. Click Browser Client. ![](07_client_select.png?lightbox=100%&resize=600) 8. If the screen appears, you have successfully logged in.<br> If you selected 6-1. terminal "GNOME Terminal" in step 6. ![](09_gnome_terminal.png?lightbox=100%&resize=600) If you selected 6-2. desktop screen "GNOME" in step 6.<br> **Please note that the password used to lock the GNOME Desktop screen is the password of the user portal (not the passphrase for the private key). ** ![](08_gnome_desktop.png?lightbox=100%&resize=600) 9. By default, the keyboard layout is set to 'Japanese'. To set it to another language, pull down the tabs on the screen and click on the keyboard symbol. ![](10_select_keyboard.png?lightbox=100%&resize=600) 10. Change Layout to the desired language. ![](11_change_keyboard.png?lightbox=100%&resize=600) <!-- ### クライアントソフトの場合(Windows){#procedure_clientsoft} 1. Windowsの場合は[Pageant](/install/pageant)を起動し、秘密鍵を登録しておきます。 2. FastX アイコンをクリックして、FastX を起動します。 3. FastX の起動ウィンドウが開いたら、左上の「+」アイコンをクリックします。 ![](fastx_login_206.png) 4. Edit Connection ウインドウで、`ssh`を選択し、「Host」に `laurel.kudpc.kyoto-u.ac.jp` , 「User」に利用者番号、「Name」に`laurel` を入力し、「OK」をクリックします。 ![](fastx_login_207.png) 5. 登録された`laurel`をダブルクリックします。 ![](fastx_login_208.png) 6. laurelに接続成功すると、以下の画面が現れますので、左上の「+」アイコンをクリックします。 ![](fastx_login_209.png) 7. デスクトップを使う場合は「GNOME Desktop」をダブルクリック、ターミナルを使う場合は「GNOME terminal」をダブルクリックします。 ![](fastx_login_210.png) 8. desktopまたはターミナルが表示されればログイン成功です。 ### クライアントソフトの場合(Mac){#procedure_clientsoft_mac} ログインの操作はWindows版と同様です。 なお、起動時に下記の表示が出た場合は、FastXアイコンをFinderで表示し、Controlキーを押しながらアイコンをクリックして、ショートカットメニューから「開く」を選択してください。 ![](fastx_login_200.png?lightbox=100%&resize=600) 参考情報:[https://support.apple.com/ja-jp/guide/mac-help/mh40616/mac](https://support.apple.com/ja-jp/guide/mac-help/mh40616/mac) --> ## Notes{#notice} ### The number of Simultaneous Sessions{#max_num_session} When one user uses multiple sessions at the same time (opens desktop or terminal), only one license is consumed on the same login node, but when sessions are opened from different login nodes, the corresponding licenses are consumed. The number of licenses that can be used by one user is set to 3. If you try to open more sessions, a notice indicating lack of license is displayed. ### Session Timeout{#timeout} With FastX, the session is maintained even after disconnecting, and the user can reconnect. However, please note that the session will be automatically deleted after 2 days without reconnecting after disconnecting. <!-- ### GNOME Desktopからのログアウトについて{#desktop} GNOME Desktopからのログアウトは、画面右上の電源マークを押し、出てきたメニューの中からユーザ名を押して、「Log Out」からログアウトしてください。セッションが不要になった場合は、なるべくログアウトをお願いします。なお、電源オプションからのログアウトはできません。 ![](fastx_login_301.png?lightbox=100%&resize=600) --> ## References{#fyi} ### Client Software{#client} Client software is distributed on [the developer's official website](https://www.starnet.com/download/fastx-client). Please use it if necessary. The communication protocol used by the user should be SSH. Also, password authentication is not available, so an SSH agent (such as [Pageant](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) that is included in Putty for Windows or ssh-agent for macOS and Linux) is required.