https://github.com/kvaps/one-connect
Simple and secure access to your own OpenNebula VMs via SPICE protocol.
https://github.com/kvaps/one-connect
Last synced: 5 months ago
JSON representation
Simple and secure access to your own OpenNebula VMs via SPICE protocol.
- Host: GitHub
- URL: https://github.com/kvaps/one-connect
- Owner: kvaps
- License: mit
- Created: 2016-03-14T09:18:26.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-03-23T09:17:29.000Z (over 9 years ago)
- Last Synced: 2025-04-12T05:54:31.089Z (about 1 year ago)
- Language: Shell
- Homepage:
- Size: 25.4 KB
- Stars: 3
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OpenNebula VM Connector
Simple and secure bash-script that provides your users access to own OpenNebula VMs via SPICE. VNC is also supported.
No Sunstone needed, connecting carried directly from user's desktop.
Script automatically suspend VM after disconnect and resume VM when user connect.
It allows you to organize simplest VDI structure.
## Usage
```bash
Usage: vm-connect.sh --host HOST [--username USERNAME]
Arguments:
-H, --host OpenNebula hostname or IP
-u, --user Username for SSH-connection
-l, --log-file Path to log file
-d, --debug Enable debug output
-h, --help This message
```
## Installation
* Install [dependings](#dependings)
* Configure passwordless SSH authentication to your OpenNebula host.
* Authorise user on OpenNebula host via `oneuser login` command.
* Also you may to configure [SSH Auth](https://docs.opennebula.org/5.2/deployment/authentication_setup/ssh_auth.html)
## Dependings
### Linux
Just install `virt-viewer` and `zenity` packages.
If you intend to use Cyrillic and other character encodings in virtual machines names, please install `recode`, it will be convert html characters in virtual machines names.
### Windows
Install:
* **Virt-viewer**
[[windows binary](https://virt-manager.org/download/)]
Also, don't forget to add virt-viewer bin folder to your windows PATH [[howto](http://superuser.com/a/317638)]
#### Git Bash
The simple way. Just install:
* **Git Bash** (or cygwin with openssh)
[[windows binary](https://git-for-windows.github.io/)]
* **Zenity**
[[windows binary](https://github.com/kvaps/zenity-windows)]
*My zenity build for windows already contains `recode` package.*
Create shortcut for start vm-connect script:
"C:\Program Files\Git\usr\bin\mintty.exe" -w hide -e bash -c "C:/Soft/one-connect/vm-connect.sh -H hostname -u user"
Or for enable debug output:
"C:\Program Files\Git\usr\bin\mintty.exe" -e bash -c "C:/Soft/one-connect/vm-connect.sh -d -H hostname -u user"