DCI Manager v2 Dedicated servers

Owned by HostBill (Unlicensed)
Last updated: Sept 23, 2020 by HostBill

Overview

DCImanager is a DCIM and dedicated server provisioning software aimed at managing hundreds of dedicated servers and taking control of the entire data center infrastructure. With DCImanager module for HostBill you can sell dedicated servers and bill for bandwidth or IP usage.

Note

This module supports DCImanager server up to version 5. For DCImanager v6 please see DCImanager v6 Dedicated servers

What happens during account provisioning using this module?

When you accept the order or click on create in account our module will:
- create an user in DCImanager
- find a server with no owner
- create new IPMI user on that server if that option is enabled
- update server owner and name
- update sever IP pool if vlan option is selected in product
- enable sever ports and update their speed
- update server IPs to product limit, this may remove current IP and re-add another.
- start os installation

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 DCImanager v2 module.

Connecting HostBill with DCImanager

  1. Proceed to Settings → Apps → Add new App
  2. From the Applications list select DCImanager v2
  3. Enter:
    • Name - Name of this connection
    • IP -Your DCImanager server ip address
    • Host - Your DCImanager server hostname
    • Username - Your DCImanager Username
    • Password - Your DCImanager Password
    • Port - Port number used by your DCImanager server
    • SSL - Check if you want to use secure connection

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

Adding DCI Manager Dedicated servers Product

  1. In HostBill go to Settings → Products & Services, and Add new order page
  2. From Order Types select Dedicated Servers
  3. Enter your order page name, select the template and Save Changes
  4. Add a new product to your order page. Provide product name, setup price, Save Changes.
  5. In the product configuration section proceed to "Connect with App", select "DCI Manager v2" and App server created in previous steps.
  6. Proceed to configuration wizard and set your package limit. 
  7. Submit changes.

Connect with App configuration

Server Type

  • Select which server configuration you want to provision with this product. It is possible to select multiple options.

  • Automated provisioning will pick servers that meet the following conditions:

    • server configuration is one of the selected values for this option
    • server has no owner,  does not have any hardware issues and is not locked

Os Template

  • Select an OS template to use during provisioning. 
  • It is possible to allow clients to select the OS template during order.

IP Limit

  • The number of IPs a client can use for his server. IP will be assigned to the server during provisioning and can be later managed from the client area.
  • It is possible to allow clients to select the IP limit during order.

Bandwidth

  • Select the bandwidth limit for client service. Leave empty or set to 0 to set unlimited bandwidth.
  • Bandwidth usage will reset every month relative to the service due date.
  • It is possible to allow clients to select the Bandwidth limit during order.

Bandwidth Notify

  • Send email notification when bandwidth usage reaches the selected percent of bandwidth limit.
  • Notification uses Bandwidth: Near Limit email template set in Emails tab, it won't send if no template is set.

Port Speed (Normal)

  • Select speed for server ports. This speed is applied when bandwidth usage is below selected limit.

Port Speed (Low)

  • Select speed for server ports when bandwidth usage exceeds selected limit.

  • Do not alter port speed for private ports - with this option enabled automation will skip all ports with  enabled in DCIManager.

Available VLAN

  • Selected values will be used to set IP pool/type option for server in DCIManager

  • Fetch from DCI during provisioning - when enabled instead of updating server IP Pool provisioning will import it to show in account details.

Configure software RAID

  • Select what raid option to use when starting OS installation operation.
    • Default - will use the default value selected by DCIManager 
    • None - Do not use raid
    • Raid 1-10 - Apply selected raid option. In case the selected template does not support raid this option will be ignored.

Setup IPMI access

  • Adds a new user with operator access to IPMI and provides client with access details to IPMI console/panel.

Bandwidth Integration

  • Use external bandwidth monitoring tools to get bandwidth usage data and graphs for client service
  • Assign graphs for related switch ports - provisioning will assign graphs from selected bandwidth app (ie. LibreNMS) to service allowing admin and client to view them
    • It will try to find the correct Switch by IP and ports by name.
    • You can view what names are expected by using Show Logs button under Graph App option.
  • Use Bandwidth data from selected app instead of DCImanager - switch bandwidth usage calculation to use data from the selected bandwidth app.
    • Ports are mapped the same way as for Assign graphs option
  • Exclude VLAN from bandwidth calculation - provide VLAN range to exclude from bandwidth usage

    • You can specify single VLAN IDs or VLAN range, eg: 100-200. Entries should be separated by a comma (,).

Assign to user on termination

  • Select the username to assign a server to when it is terminated. Use this if you want to run some checks before making the server available for provisioning.
  • This option can be defined in App, to select different user per product you need to enable Override app settings checkbox.

Run diagnostics on termination

  • Select a diagnostic template to run on service termination.
    • Clear disks - enable to clear disk while running diagnostics.
    • Full hard drive erase - enable to fully remove data from disk without chance of recovery.
  • When diag is enabled automation will perform server termination in the background, server IPs will be removed and server owner changed after the diagnostics operation is complete.
    • If owner is changed manually during this time server termination will abort.


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

Configuring Email Notifications   

In Products & Services → Your Order Page → Your Product → Emails you can control which notifications to send to staff and clients.

For DCImanager v2 you can enable the following notification:

  • Initial Order - Sent right after a new order, before provisioning

  • Account created email - Sent after successful service provisioning

  • Account suspended email - Sent after service suspension

  • Account unsuspended email - Sent after service unsuspension

  • Account terminated email - Sent after service termination

  • Server: Provisioning - Sent when the first OS install operation is started

  • Server: Ready to use  - Sent when the OS install operation is completed without errors

  • Server: Provisioning failed - Sent when the OS install ends with errors

    • Can be enabled for client and administrators

  • Server: Reinstall started - Sent when the OS install operation is started from the client area

  • Server: Reinstall success - Sent when the OS install operation started by user is completed without errors

  • Server: Reinstall failed  - Sent when the OS install operation started by user ends with errors

    • Can be enabled for client and administrators

  • Bandwidth: Near Limit - Sent when usage reaches the threshold set in Connect WIth App → Bandwidth Notify

  • Bandwidth: Over Limit - Sent when usage exceeds the bandwidth limit


Additional Email variables 

In email configured in Products & Services → (Your DCI Product) → Emails module exposes following useful variables:

  • {$service.rootpassword} - Root/Adminstrator password
  • {$service.ip} - Main IP address for created server
  • {$service.additional_ip} - String with Additional IP addresses
  • {$service.os} - OS Name
  • {$service.bw_limit} - Bandwidth limit
  • {$service.extra_details.ipmi.ipmiweburl} - IPMI console Url 
  • {$service.extra_details.ipmi.ipmiip} - IPMI IP
  • {$service.extra_details.ipmiuser} - IPMI username


You can also refer to Forms: Accessing Forms elements in email templates for variables defined for your Components:Forms 

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 DCImanager you can enable the following client functions dedicated to this module:

  1. IP Management
  2. Reinstall Server
  3. Server Diagnostics
  4. Server Info
  5. Server Power Control
  6. Server Recovery
  7. ISO Upload

As well as number of standard client functions