Skip to content
README.md 1.86 KiB
Newer Older
Cédric's avatar
Cédric committed
# ISPConfig Module
Cédric's avatar
Cédric committed

Cédric's avatar
Cédric committed
## Application informations 
Cédric's avatar
Cédric committed
This application is an Add-ons for ISPConfig used for VPS Management (Proxmox)
Cédric's avatar
Cédric committed

Cédric's avatar
Cédric committed
## Requirements
- ISPConfig 3.1
Cédric's avatar
Cédric committed
- Mysql database (same as ISPconfig)
Cédric's avatar
Cédric committed
- Proxmox Virtual Environement
root's avatar
root committed
- Firewall permission
Cédric's avatar
Cédric committed

Cédric's avatar
Cédric committed
## Features 
Cédric's avatar
Cédric committed
- Manage your VPS :
 - Start
 - Shutdown
Cédric's avatar
Cédric committed
 - Reset
 - Hard Stop (unplug the power)
Cédric's avatar
Cédric committed
 - Change network states (enable / disable)
 
Cédric's avatar
Cédric committed
- Display :
 - Power status
Cédric's avatar
Cédric committed
 - Uptime
Cédric's avatar
Cédric committed
 - Load average
 - Installed Memory
 - Commsumed Memory
 - Installed CPU
 - Disk Space (total)
 - Graphics (Memory, CPU, Networks, DIsk IO)
Cédric's avatar
Cédric committed
 - Network interfaces (Mac address and state)
Cédric's avatar
Cédric committed

Cédric's avatar
Cédric committed
- Admin display :
 - Per client assignation
Cédric's avatar
Cédric committed
 - Task history (need to implement link to ispconfig user and pve user for non admin version)
Cédric's avatar
Cédric committed
 - Network Interfaces (Vlan, Rate)
LEVEILLE's avatar
LEVEILLE committed

## Screenshots
Cédric's avatar
Cédric committed
See misc folder For some screenshot
Cédric's avatar
Cédric committed

root's avatar
root committed
## How To implement this module
- Create Proxmox user for ISPConfig communication with PVEVMUser right
 - Assign VMs to this user
- Deploy the module into your ISPConfig setup -> /usr/local/ispconfig/interface/web
- Configure the module with your Proxmox user -> /usr/local/ispconfig/interface/lib/config.inc.local.php
 - $conf["pve_username"] 	= 'username';
 - $conf["pve_password"] 	= 'password';
 - $conf["pve_link"] 		= 'hostname / ip of your cluster head';
 - $conf["pve_realm"] 		= 'realm';
Cédric's avatar
Cédric committed
 - Please do not use your Proxmox root user !
Cédric's avatar
Cédric committed
- Enable the module -> /usr/local/ispconfig/interface/lib/config.inc.local.php
 - Add "proxmox" to the variable $conf['modules_available'] 
 - Dont forget to activate it for your Ispconfig user 
root's avatar
root committed
- Create MySQL table for this module -> misc/vm_proxmox.sql
Cédric's avatar
Cédric committed
 - If you are on multi-servers setup you have to do this on each server
root's avatar
root committed


Cédric's avatar
Cédric committed
## ToDo
- Admin function : 
 - Snapshot (add / remove)

- Display: 
Cédric's avatar
Cédric committed
 - Top menu icon.
 - NoVNC console integration (stuck for the moment ... :( )
root's avatar
root committed

Cédric's avatar
Cédric committed
# License
Cédric's avatar
Cédric committed
Copyright (c) 2017, Oricom Internet