Table of Contents

• solvpscli
  • Usage
    • List active VPS
    • status
    • Change password
    • Console interfaces
      • SSH console (Linux only)
      • Graphical console (Windows only)
    • Other actions
• License
• TODO

vpn-slice

This is a command-line tool for managing virtual private servers from SolVPS. It works by scraping the web-based user interface.

Usage

usage: solvpscli.py [-h] [--show-passwords] [-u USERNAME] [-p PASSWORD] [-k]
                    [vpsid]
                    [{status,browse,boot,reboot,shutdown,linux-console,windows-console,passwd}]

This is a tool to manage SolVPS virtual private servers directly from the
command line. It works by scraping the web-based user interface at
https://www.solvps.com/secure/clientarea.php

positional arguments:
  vpsid                 SolVPS numeric ID, or domain name
  {status,browse,boot,reboot,shutdown,linux-console,windows-console,passwd}
                        Action to perform on the VPS

optional arguments:
  -h, --help            show this help message and exit
  --show-passwords      Show password fields in status output
  -u USERNAME, --username USERNAME
  -p PASSWORD, --password PASSWORD
  -k, --insecure        Don't verify certificates

In order to avoid being prompted for your username and password on every invocation, add your SolVPS username and password to the file ~/.solvps_credentials:

user.name@company.com
SecretPassword321

List active VPS

If no specific system is given on the command line, solvpscli will list the numeric IDs and domain names of all the active VPS accessible by your account:

$ solvpscli
Logging in to SolVPS...
No VPS ID or domain name specified. List:
[12345]	linuxbox1.company.com
	Linux VPS - Custom VPS
[12346]	windoze2.company.com
	Windows VPS - Custom Windows VPS

status

The status action is the default if no other action is specified. It displays status and configuration information on a VPS:

$ solvpscli --show-passwords linuxbox1
Logging in to SolVPS...
Found domain linuxbox1.company.com (Linux VPS - Custom Linux VPS) with VPS ID 12345
VM status:
	Status               : online
	Type                 : xen
	Hostname             : linuxbox1.company.com
	Main IP Address      : 101.102.103.104
	IP Addresses         :
	Root Password        :
	Bandwidth            : 13.43 GB of 100 TB Used / 99.99 TB Free 0%
	HDD                  : 27.74 GB of 50 GB Used / 22.26 GB Free 55%
Remote access credentials:
	Access Protocol:     : SSH (Secure Shell) How to Connect ›
	Server Address:      : 101.102.103.104
	Username:            : root
	Password:            : deadbeef0x
	SSH Port:            : 22
Options:
	Processor - CPU      : 1 Core $1.00 USD
	Memory - RAM         : 4 GB $1.00 USD
	SSD Storage          : 25 GB $1.00 USD
	Bandwidth - Data     : Unlimited Data Transfer
	Bandwidth - Speed    : 1Gbps Port Capacity
	Operating System     : Ubuntu 17.04
	Server Location      : Europe - London

Change password

For Linux VPS systems, it's possible to change the root password via the management interface.

$ solvpscli linuxbox1 passwd
Logging in to SolVPS...
Found domain linuxbox1 (Linux VPS - Custom Linux VPS) with VPS ID 12345
Enter new password: ****
Retype new password: ****
Success.

Console interfaces

SSH console (Linux only)

For Linux VPS systems, it's possible to access the kernel console which may be useful for troubleshooting an otherwise non-responsive system. Invoking solvpscli [vpsid] linux-console provisions an SSH console and displays a shortcut to connect with no password prompt, using sshpass and OpenSSH:

$ solvpscli linuxbox1 linux-console
Logging in to SolVPS...
Found domain linuxbox1 (Linux VPS - Custom Linux VPS) with VPS ID 12345
Linux system console can now be accessed via ssh:

        sshpass -p 'F0o0BarBz1' ssh -o StrictHostKeyChecking=no console-foO0BR@12.34.56.78

(The credentials for the SSH console will expire after about one hour.)

Graphical console (Windows only)

For Windows VPS systems, it's possible to access the Windows /admin console via a browser-based Windows Remote Desktop Protocol client. Invoking solvpscli [vpsid] windows-console will open the browser-based view for the server in question, in your default web browser:

$ solvpscli windoze2 windows-console
Logging in to SolVPS...
Found domain windoze2.company.com with VPS ID 12346
Opening graphical console interface in browser: https://www.solvps.com/secure/clientarea.php?action=productdetails&id=12346&mg-action=novnc ...
Success.

Other actions

The boot, reboot, and shutdown actions should be self-explanatory. They display a short JSON response from the web service:

$ solvpscli linuxbox1 boot
Logging in to SolVPS...
Found domain linuxbox1.company.com with VPS ID 12345
Success.

The browse action opens the web view for the server in question, in your default web browser:

$ solvpscli windoze2 browse
Logging in to SolVPS...
Found domain windoze2.company.com with VPS ID 12346
Opening in browser: https://www.solvps.com/secure/clientarea.php?action=productdetails&id=12346 ...

License

GPLv3 or later.

TODO

• Scrape console interface for Windows systems as well