README.md 1.91 KB
Newer Older
Cédric's avatar
Cédric committed
1
# ISPConfig Module
Cédric's avatar
Cédric committed
2

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

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

Cédric's avatar
Cédric committed
12
## Features 
Cédric's avatar
Cédric committed
13 14 15
- Manage your VPS :
 - Start
 - Shutdown
Cédric's avatar
Cédric committed
16 17
 - Reset
 - Hard Stop (unplug the power)
Cédric's avatar
Cédric committed
18 19
 - Change network states (enable / disable)
 
Cédric's avatar
Cédric committed
20 21
- Display :
 - Power status
Cédric's avatar
Cédric committed
22
 - Uptime
Cédric's avatar
Cédric committed
23 24 25 26 27 28
 - Load average
 - Installed Memory
 - Commsumed Memory
 - Installed CPU
 - Disk Space (total)
 - Graphics (Memory, CPU, Networks, DIsk IO)
Cédric's avatar
Cédric committed
29
 - Network interfaces (Mac address and state)
Cédric's avatar
Cédric committed
30

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

## Screenshots
Cédric's avatar
Cédric committed
37
<img src="/misc/admin_vue_3.png" width="400px">   <img src="/misc/admin_vue_2.png" width="400px">
LEVEILLE's avatar
LEVEILLE committed
38

Cédric's avatar
Cédric committed
39
<img src="/misc/admin_vue_1.png" width="400px">   <img src="/misc/graph_vue_1.png" width="400px">
LEVEILLE's avatar
LEVEILLE committed
40

Cédric's avatar
Cédric committed
41 42
<img src="/misc/admin_task_history.png" width="400px"> 

root's avatar
root committed
43 44 45 46 47 48 49 50 51
## 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
52
 - Please do not use your Proxmox root user !
root's avatar
root committed
53
- Create MySQL table for this module -> misc/vm_proxmox.sql
Cédric's avatar
Cédric committed
54
 - If you are on multi-servers setup you have to do this on each server
root's avatar
root committed
55 56


Cédric's avatar
Cédric committed
57 58 59 60 61
## ToDo
- Admin function : 
 - Snapshot (add / remove)

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

Cédric's avatar
Cédric committed
65
# License
Cédric's avatar
Cédric committed
66
Copyright (c) 2016, Oricom Internet
root's avatar
root committed
67
All rights reserved.