An awesome tool to make your access to your machines on NCL easily!
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
- About the Project
- Getting Started
- Usage
- Issues
- Contributing
- License
- Contact
- Acknowledgements
- Contributors
Configurating SSH tunnel and rdesktop to the remote machine(on NCL) is a kind of boring and tedious process. That's what this tool 'Client' aims to solve. It provides a clean GUI to automate the procedure of SSH tunneling, port binding & unbinding and rdesktop to make your life easier :)
-
(option1)
git:$ git clone https://github.com/nus-ncl/Client.git
-
(option2)
Download from the url below:
- python3.9
# check in the terminal if python3.9 installed successfully $ python3.9 -V Python 3.9.9
# Enter main folder
$ cd Client # or 'cd Client-master'
$ python3.9 -m venv venv
$ source venv/bin/activate
(venv)$ pip install -r requirements.txt
(venv)$ python client.py
using Command Prompt
or known as CMD.exe
-
(option1)
git:$ git clone https://github.com/nus-ncl/Client.git
-
(option2)
Download from the url below:
- python3.9
# check in the terminal if python3.9 installed successfully $ python3.9 -V Python 3.9.9
- vncviewer
- in my case, 'Target' is 'C:\Program Files\RealVNC\VNC Viewer\vncviewer.exe', so add 'C:\Program Files\RealVNC\VNC Viewer\vncviewer.exe' to Path
- now can invoke it by 'vncviewer' in Command Prompt
$ vncviewer
# Enter main folder
$ cd Client # or 'cd Client-master'
$ python3.9 -m venv venv
$ venv\Scripts\activate
(venv)$ pip install -r requirements.txt
(venv)$ python client.py
-
(option1)
git:$ git clone https://github.com/nus-ncl/Client.git
-
(option2)
Download from the url below:
- python3.9
# check in the terminal if python3.9 installed successfully $ python3.9 -V Python 3.9.9
- vncviewer
# Enter main folder
$ cd Client # or 'cd Client-master'
$ python3.9 -m venv venv
$ source venv/bin/activate
(venv)$ pip install -r requirements.txt
(venv)$ python client.py
-
Input your NCL Testbed Username into
Username
blank.caution
- If you use Username
nologin
that we provide, no more further operations - If you use your own NCL Testbed Username(e.g.
joedoe
)- put your private key to the
private_key
folder and name it as<Username>.pem
(e.g.joedoe.pem
) - (not applicable for Windows) change the file mode of the private key to
400
bychmod 400 <Username>.pem
- put your private key to the
- If you use Username
-
Click the
Choose XML ...
button and choose your client xml file. -
Click 'Confirm' button to show your remote machines on NCL Testbed
-
Select your local platform
-
Select your method to access to the machine
- 'Console': access with GUI
- 'SSH': access without GUI via web browser(try again if failed)
-
Double-click the machine entry to access it
-
Click 'Tutorial' button to show a window of the relavant documentation
-
Click 'Reset' button if 'Console' accessing method ALWAYS failed
caution
- single-click to select the machine you want to reset before clicking 'Reset'
-
'Nothing' Button is a future function button, to be continued...
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
Huang Kang - [huangk@nus.edu.sg]
Project Link: https://github.com/nus-ncl/Client
- Huang Kang