/
upCloud

upCloud

Jun 14, 2024

Overview

UpCloud is a reliable cloud platform that enables you to deploy high performance cloud servers quickly and easily. Thanks to UpCloud integration with HostBill you can sell VPS Hosting by reselling UpCloud instances. With HostBill various billing models and flexible product configuration options you can charge your customers for OS templates, locations or VM plans. The whole account lifecycle is automated by HostBill. Clients are able to control and manage their resources from the client area. The access to client area functions is controled by the admin. Client can create, restart, start and stop their virtual machines, inject SSH keys, manage virtual machine’s firewall and access noVNC console. Admin area provides access and allows to manage billing details and account lifecycle.

Activating the module

  1. If the module is included in your HostBill edition you can download it from your client portal.

  2. If the module is not included in your HostBill edition you can purchase it from our marketplace and then download it from the client area.

  3. Once you download the module extract it in the main HostBill directory.

  4. Go to Settings → Modules → Hosting Modules, find and activate UpCloud module.

Connecting HostBill with UpCloud

  1. Proceed to Settings → Apps → Add new App

  2. From Applications list select UpCloud

  3. Enter:

      4. Verify entered credentials by clicking Test Connection to check if HostBill can connect
      5. Save Changes

Console configuration

HostBill module for upCloud provide optional noVNC console for your clients. Since upCloud does not provide websocket, but novnc console through API it's important to setup a Websockify on server where HostBill resides. 

Namely: https://github.com/novnc/websockify with configured https://github.com/novnc/websockify/wiki/Token-based-target-selection

Guide below provides sample websockify installation on CentOS 7: 

  1. Start by installing fortran & git:

    yum -y install numpy python-devel gcc-gfortran git

  2. Create new system user, clone websockify and grant permissions.

    • Replace {$path} with the value set in the "Path to put websockify tokens" in HostBill connection details. In this sample we've used:  /home/websockify/target.conf.d)

      adduser websockify cd /home/websockify git clone https://github.com/novnc/websockify.git cd /home/websockify/websockify python setup.py install --force mkdir {$path} chmod 0777 {$path} chown -R websockify: /home/websockify

  3. Create cronjob as websockify user (crontab -e -u websockify), with following line replacing variables:

    */5 * * * * /home/websockify/websockify/run {$console_port} --token-plugin TokenFile --token-source {$path}

    • {$path} - Value of the "Path to put websockify tokens in" field. Ensure to make it writeable to world (chmod 777)

    • {$console_port} - Port on which the console will connect. Port used internally in the webserver (ie apache) configuration, should be different than  {$port}

  4. Finish by configuring your webserver. Replace :

    1. {$hostname} - Value of the "Websockify hostname" field set in steps above.

    2. {$port} - Value of the "Websockify local port" field

 

Note

On server running websockify ensure to open TCP out ports 20000-65535 (as its being used by actual console)

 

Webserver configuration: Nginx 

If your HostBill is installed using enterprise install script, or you're using Nginx in your setup:

Create file: /etc/nginx/conf.d/websockify.conf
with contents:

upstream websocket { server 127.0.0.1:{$console_port}; } server { listen {$port} ssl; server_name {$hostname}; server_tokens off; charset utf-8; sendfile on; tcp_nopush on; tcp_nodelay off; reset_timedout_connection on; include /etc/nginx/ssl.conf; location / { proxy_http_version 1.1; proxy_pass http://websocket; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $host; proxy_set_header X-NginX-Proxy true; proxy_buffers 8 32k; proxy_buffer_size 64k; proxy_redirect off; proxy_read_timeout 61s; } ssl_certificate /etc/letsencrypt/live/{$hostname}/fullchain.pem; # replace with path to actual certificate your installation is using ssl_certificate_key /etc/letsencrypt/live/{$hostname}/privkey.pem; # replace with path to actual certificate key your installation is using }

Ensure to restart nginx afterwards (systemctl restart nginx)

Webserver configuration: Basic Apache (using default cert):

In your apache configuration file:

<VirtualHost *:{$port}> ServerName {$hostname} ProxyPass / ws://127.0.0.1:{$console_port}/ ProxyPassReverse / ws://127.0.0.1:{$console_port}/ SSLEngine on </VirtualHost>

Restart/reload webserver

 

Webserver configuration: cPanel/WHM server:

If your HostBill is installed on cPanel server:

  1. Ensure you're apache have mod_proxy_wstunnel installed (you can check/add this module in WHM→EasyApache) 

  2. Create custom apache file (replace username and hostbill.domain with your actual username/domain) /etc/apache2/conf.d/userdata/ssl/2_4/username/hostbill.domain/custom.conf:

    ProxyPass /wss ws://127.0.0.1:{$console.port}/ ProxyPassReverse /wss ws://127.0.0.1:{$console.port}/

  3. Rebuild httpd config & restart webserver using:
    /usr/local/cpanel/scripts/rebuildhttpdconf
    /usr/local/cpanel/scripts/restartsrv_httpd

  4. Edit HostBill file: includes/modules/Hosting/upcloud/user/console.tpl
    Replace line:
    path = WebUtil.getQueryVar('path', '?token={/literal}{$console.token}{literal}');
    with:
    path = WebUtil.getQueryVar('path', 'wss?token={/literal}{$console.token}{literal}');

  5. Ensure file above would not be overwritten by autoupdate plugin

Adding UpCloud Product

  1. In HostBill go to Settings → Products & Services, and Add new order page

  2. From Order Types select "VPS Accounts"

  3. Enter your orderpage name, select orderpage template. Save Changes

  4. Add new product in new orderpage. Provide product name, setup price, Save Changes.

  5. In product configuration section proceed to "Connect with App", select "UpCloud" and App server created in previous steps.

  6. Setup Package Limits:

  • Plan- Select plan that will be used to to create vm

  • Custom Memory - When plan is set to Custom you can define custom memory (or let client decise of it)

  • Custom CPU - When plan is set to Custom you can define custom CPU amount (or let client decise of it)

  • Template- Select os template to be used for vm.

  • Location - Select region that will be used to deploy client vm.

  • Storage size - storage size in GBs

  • Storage tier - storage device tier

  • Server name source - pick from where HostBill should use server name

  • Default username - optional username that will be used when creating machine

  • Staff SSH Key 1 - additional SSH key to auto-inject to every machine using this product

  • Staff SSH Key 2 - additional SSH key to auto-inject to every machine using this product

  • SSH key - If this box is checked then you allow the client to add SSH keys.

  • Firewall - enable/disable firewall

  • Initialization script - custom initialization script to be used with machine using this product

  • Enable backups - enable/disable automated backups

  • Backup time - time for automated backups

  • Backup cycle - how often automated backups should be taken

Note:

You can optionally use "Allow to select by client during checkout" checkbox.
This will automatically add new form items under Components → Forms allowing your client to configure server location, size or os template during order.
You can apply additional charges to those items.

For more generic product configuration details including price, automation, emails settings refer to Product Configuration article.

Defining custom plans in Plan selector  

In related product configuration, if you decide to let customer decide which plan to select using  "Allow to select by client during checkout" next to Plan option, you can define your own custom plans.

To do so, edit related form element in Components → Forms section, and in Values define your own custom plan by adding / editing existing value

  • Enter your custom plan name

  • In "Value passed to App" of related value, enter:

    •  custom:{N}xCPU-{M}GB where:

      • N is amount of custom CPU

      • M is amount of custom RAM

  • If you also want to set custom storage size, In "Value passed to App" of related value, enter:

    •  custom:{N}xCPU-{M}GB-{P}GB where:

      • N is amount of custom CPU

      • M is amount of custom RAM

      • P is custom disk size

Example:

Variable passed to App set to "custom:3xCPU-8GB-100GB" will create vm with:

  • 3 CPU

  • 8 GB RAM

  • 100 GB disk size

 

Configuring Client Functions   

In Products & Services → Your Order Page → Your Product → Client Functions you can control what features customer will have access to in client portal, by clicking Enable/Disable next to the given option.
Use Edit button to adjust function appearance in the client portal.

For UpCloud you can enable a number of standard client functions:

  1. Change Billing Cycle

  2. Change Label

  3. Change Ownership

  4. Edit Forms

  5. Graphs

  6. Login Details

  7. Manual Service Renew

  8. New Direct Link

  9. Related Services

  10. Service Auto Renewal