ISPConfig 3 Server Module for WHMCS

[Germanius]

Hi there,

the ISPConfig 3 (www.ispconfig.org) server module (v1.0.1) is now available with the following features:

- Automatic client creation
o Clients are created with ISPC3 client templates. You can set different options for every hosting package
o All client features/options are supported
o Client details, which are transferred to ISPC3: Company name, First name, Last name, E-Mail Address, Postal code, City, State, Username, Password, Country, Language, Theme
o Instant activation in WHMCS possible
o Usernamehandling: Creates automatically a unique username (off/on)
o Server-/Servergroupfunctions in WHMCS are supported
- Automatic website creation (off/on)
o Readonly (client can’t change website settings) (off/on)
o ISPC3 domaintool: Automatic domain creation (off/on)
o All website features/options are supported and can be set for every hosting package (such as Ruby, SSI, SSL, … everything)
o DNS entries are created with the ISPC3 DNS templates (off/on)
- Termination of accounts
o Delete the client and all services (such as websites, FTP accounts, mail features, … everything)
o Delete ISPC3 domaintool domains (off/on)
- Suspend accounts
o All websites are turned to inactive
- Unsuspend accounts
o All websites are turned to active
- Password changing
o Client and admin can change ISPC3 passwords
- Displaying login link
o ISPC3 login link in the admin area
Off/on means that you can choose if you want to turn it off or on.

System requirements:
- WHMCS
- ISPConfig 3, version 3.0.3 or newer
- IonCube

Screens:
http://www.swaydo.de/misc/screen1.jpg
http://www.swaydo.de/misc/screen2.jpg

This module comes with a documentation/manual (english), which has 5 pages. There you will find installation instructions, explanatory notes, general information about all features and the perspective of the module concerning ISPConfig 3.
Additionally you will find some code for your registrant module.

All further updates, bugfixes, new features and changes in ISPConfig 3 are included.
The price is only 30,00 EUR (one-time). Paymentmethod: PayPal

You can order it here: click (https://www.swaydo.de/kundencenter/cart.php?language=English&gid=3)

If you have questions, please contact me (PM - personal message).

[Germanius]

v1.0.1 released (1st Feb 2011)
Changelog
o Instant activation in WHMCS possible
o Usernamehandling: Creates automatically a unique username (off/on)
o Server-/Servergroupfunctions in WHMCS are supported
o DNS entries are created with the ISPC3 DNS templates (off/on)
o Bug: Domaintool does not work, if Autowebsitecreation isn't enabled
__________________________________________________ _________________

v1.0.2 released (9th Sep 2011):
- Add Loginlink in Clientarea
- Support for plan upgrading
- Support languages which are not in ISPC by default
- Bug: Problems with usernamehandling if it is a name like Johnny De Silva
- Bug: DNS not working
__________________________________________________ _________________

Roadmap for v1.0.3:
- Support for using ISPC Addon Templates (?)
- Support for disc-, traffic-, .. usage in WHMCS (?)
- ...

[skoena]

Roadmap for v1.0.1:

- Add support for creating DNS entrys (done)
- Display messages while action (error/success) (done)
- Username handling when account created automatically (done)
- Connection between Servergroups/Servers and this module (done)
- Possibility to connect via SSL
- ...

What about future updates, are they included in the 30 euro price?

[Germanius]

All further updates, bugfixes, new features and changes in ISPConfig 3 are included.

Yes, they are included.

[skoena]

Sorry my glasses were dirty :)

[skoena]

Just ordered the module!

[Germanius]

Just sent it to you! :)

[outeredge]

Just to warn people, this module comes with a custom version of the remoting API (php files) for ISPConfig, which could pose issues with upgrades.

Germanius, can you confirm that features requests have been raised for each of the changes you've made to the remoting.inc.php and remote_user.tform.php files? If so, can you post the links on here so we can all vote?

Thanks

David

[Germanius]

As described in the documentation, the changes in the remotingfiles get overwritten, if you update ISPC. But you simply have to replace them again, then it is working again.

The changes I did in the remotingframework are already trasmitted to Till. He said, that he will include them in the stable SVN, so probably in the next ISPC version you dont have to change any remoting files.

[Horfic]

I can confirm Germanius sayings about the remote framework. Till and I updated the remote framework on the svn. The missing functions will be in the next ISPConfig version.

So don't worry!

[outeredge]

I can confirm Germanius sayings about the remote framework. Till and I updated the remote framework on the svn. The missing functions will be in the next ISPConfig version.

So don't worry!

Great news!

[skoena]

Just sent it to you! :)

Got it.
The only thing I have as a question is what to do with this. It's unclear what to change and where?

Add the code from function_RegisterDomain.txt to your registrar function RegisterDomain
at the end.
Add the code from function_TransferDomain.txt to your registrar function TransferDomain
at the end.
Add the code from function_RequestDelete.txt to your registrar function RequestDelete at
the end (if you have such a function).

Rudolf.

[Germanius]

That is optional. If you have the possibility to add custom code to your registrar module (if you already use one!!), then you can add the code to the existing function of your registrar module. But then you have to deactivate the domaintool function in the module, because these tasks are then done by the registrar module.

As an example:

function yourregistrar_RegisterDomain($params) {
...registrar code, which already exists...
Add code from function_RegisterDomain.txt here and edit URL, user and password
}

In this case EVERY registered domain is added in ISPC, not only the one they got with the hostingpackage! :)

Edit: Okay, I see. I will improve the manual in the next version concerning this.

[outeredge]

I think we should raise a Feature Request in the bug tracker to show Client Template ID & Server ID in the lists. If not, the only way to be sure you've got the right ID's would be to look in the database.

Also, can you clarify what this section does:

ISPConfig Server Settings (Syntax:WebserverID,DBserverID,MailserverID,DNSser verID)

and how does that relate to ISPConfig Server ID?

I assume Server ID is the field that specifies which Web Server to setup the site on, or is this the one with the Control Panel on?

[Germanius]

We are currently testing the new version 1.0.1, where those settings (serverid and defaultid's) are a little bit clearer, because of Servermanagement in WHMCS.
I will describe that in detail in the new manual, which will be released with the 1.0.1 in a few days.

[skoena]

When I create a new website Apache stops and can't be restarted I get this error.

Syntax error on line 7 of /etc/apache2/sites-enabled/ghghghghghghgh.nl.vhost:
The address or port is invalid

I deleted the /etc/apache2/sites-enabled/ghghghghghghgh.nl.vhost file and thand Apache restarts without problems.

[Germanius]

Did you set up the right IP in the module settings and is this IP already set uped in ISPconfig, so that you can crwate websites with that IP?

[skoena]

I added the correct IP address now.
I re-created the website again via whmcs but now all my sites give a 403 Forbidden error.
--------------------------

Edit:
I restarted Apache, and the 403 error is gone.

[skoena]

I started with enabling the domain-module enabled in ISPC3.
(via System>Interface config>Domains>Use the domain-module to add new domains)

Via System, Edit user, choose admin, and enable the module "domain".
You have to logout and login again. You will have an extra navigation icon (domains).

I also did not have an IP address added in ISPC3.
(via System>Server IP addresses>Add new IP address)

Changed all website from * to the IP address.
If you changed the first website to a IP, all others will not work anymore. But don't worry, go on changing every site. All sites you changed will work.

Thanks to Germanius for his help (via DM).

[mmidgett]

I am thinking about buying WHMCS to use this module. Can someone thats using it tell me that it does indeed work.

[Germanius]

Yes, it works. I can send you a testversion, if you want to try it.
Please write me a PM.

[Germanius]

Version 1.0.1 is out now!

[otacon]

so I bought it.... where do I download it? I cant find it.

[skoena]

so I bought it.... where do I download it? I cant find it.

You will get it via email from Germanius.

[mmidgett]

I see that the requirement are that I need IonCube. Is this something that I have to purchase?

[Germanius]

No, you dont have to purchase that - it is free.
But you already have that installed on your webserver if you use WHMCS, because WHMCS needs this also.

[serverstage]

I can't seem to find a place to automatically set the IP Address instead of the default '*'

Is this a setting in WHMCS or in ISPConfig? Or should I look at modifying ISPConfig files?

[Germanius]

All of your existing websites have '*' selected in ISPC? Then you should add an IP-Address and switch the sites from * to the correct IP.

rudolfpietersma described it here:
I also did not have an IP address added in ISPC3.
(via System>Server IP addresses>Add new IP address)

Changed all website from * to the IP address.
If you changed the first website to a IP, all others will not work anymore. But don't worry, go on changing every site. All sites you changed will work.

[serverstage]

Yes, I've switched them over to IPs instead but new sites are added by default with '*'. It should be the IP of the Server instead for new sites.

[Germanius]

If you add them via WHMCS than have a look at your serversettings "Setup - Servers - Edit a server". There you have to set up the correct IP Address, the same as you use in ISPC for all existing sites.

[serverstage]

You are right! I must have overlooked it somehow, but now it works perfect.

Thanks :)

[serverstage]

One more question please-

When I add an order to an existing customer in whmcs, a new user account is generated in ispconfig. Is it supposed to work this way? How do I get the domains consolidated?

Regards, Brandon

[Germanius]

Yes, thats the normal bahaviour, because ISPC needs for every hosting package an own user.
If you have only a domain order you have to add it manually or you add some code to your registrar module in WHMCS if you use one. Because thats a registrar thing.

[till]

Yes, thats the normal bahaviour, because ISPC needs for every hosting package an own user.

Thats not the case if you use ispconfig without whmcs. There are master templates and additional templates. You can assign as many additional templates to a user as you like and also a user can as have as many websites as nescessary.

[Germanius]

I know that, but I thought he mainly meant the domain thing?
If he meant the addon templates than it is not supported yet. I am not sure, if WHMCS directly supports a behaviour like this. I will check it, so I make a remark on the roadmap.

[till]

If WHMCS does not support cumulative limits like ispconfig, then you can e.g. use a master template where all limits are set to 0 and then add only a addon template for every new webhosting package that a customer orders. So you dont have to add new users.

[serverstage]

It looks like we're going to need the ability for customers to add their own domains in domainmanager-

Can we configure this in ISPConfig already?

[Germanius]

Yes, I think you can enable the domain tool for the customers, too.
But I dont think that that is the sense of this. The domain tool prevents customers from adding eg. external domains. So if you want that customers can add any domain you dont need the domain tool, then you can deactivate it.

[serverstage]

Hi Germanius and any other helpful tippers,

I'm having troubles with the DNS creation, it seems that the template isn't completely applied.

The DNS Zone is created but "disabled" and none of the Zone records are created.

The module settings in WHMCS are correct, and I've tried two different DNS templates.

My Module version is 1.0.1.

Any ideas?

Thanks, Brandon

[Germanius]

Hi there,

are you the one who already sent me an email concerning the dns problem?
If not, I am already working on that issue, because someone else has similar problems.

[serverstage]

No Sir, that wasn't me. I'd be happy to help out with input if you have any questions though.

Kind Regards, Brandon

[onastvar]

Do you have a demo online?

[Germanius]

There is no demo online, because if we want to make a demo online we have to purchase an extra license from WHMCS only for the demo system. That would not make so much sense.
If you already have a working WHMCS installation I can send you a test version of this module. Please contact me via email or send me a PM.

[Germanius]

New version 1.0.2 finished with the following changes:

- Add Loginlink in Clientarea (IMPLEMENTED)
- Support for plan upgrading (IMPLEMENTED)
- Support languages which are not in ISPC by default (IMPLEMENTED)
- Bug: Problems with usernamehandling if it is a name like Johnny De Silva (FIXED)
- Bug: DNS not working (FIXED)

I am searching for some people who would like to test those changes. After that I will release it. Please contact me for the test version.

[Germanius]

v1.0.2 released today!

[skoena]

I upgraded to 1.0.2 but now my Verify Image (captcha) is missing and has a red cross.

[Germanius]

This module doesnt do anything with verify images (captcha).
So I think your problem is related to WHMCS itself.

[skoena]

Don't know why this happend on the sametime I upgrated to 1.0.2. But for now I disabled captcha.

[skoena]

I just tested some things after the upgrade.
The first thing I noticed when I order more domains it creates ispconfig accounts per domain? Can I set it it will just create 1 account + all the domains?

One other thing.
Can I use a fixed email adres on the DNS settings? (instead off admin@newordereddomain1.tld/admin@newdomain2.tld etc)

[svdmon]

When trying to create a domain through WH we get the following output:

SOAP Error: documentroot_error_empty
php_open_basedir_error_empty

It creates the client fine but no domain.
I've fiddled around with the PHP settings under the Module but that doesn't seem to be at fault.

Any ideas would be greatly appreciated.

[Amorphous]

so, i have just purchased a version of whmcs ispconfig module, and i see that this version is still in testing, because of some issues ...... should not this testing versions be for free until a final working version ?????

i am very dissapointed ....

And the most interresting thing is that not even one admin saying that this is or not supported by howtoforge......


shame on you !!!

selling products still in testing mode .....

shame shame shame !!!!

[Germanius]

@svdmon: You have got a mail, which should solve your problem. You did something wrong in IP management.

@Amorphous: Calm down. Nothing is in testing mode. This module is working since one year.
There are only some problems with the new ISPC 3.0.4 release, because of some new features in ISPC. So there have to be some changes in this module which I will do in in the next days.

[svdmon]

Thanks Germanius it's working now.

[Germanius]

Just a little note for everybody who wants to use this module with ISPC 3.0.4:
Please dont replace those two files in ISPC, which is described in the manual. Just use the original ones and everything is working fine.

[Amorphous]

just a small question about the ISP Config Template ID:

i have created in ISPConfig 3 templates, Neo Lite, Neo Pro and Neo Demo.
after i have finished updating those 3 templates, they did not remained in the exact order i have created them ....my order is now like this:
MAin Template ----------- Neo Pro
Main Template ----------- Neo Demo
Main Template ----------- Neo Lite

is the whmcs module not recognising automatically the templates because i was supposed to make one template as a master template and the other 2 as additional templates ???
i have tryed to make in this configuration the 3 plans in whmcs module
Neo lite -------- ID 3
Neo Pro -------- ID 1
Neo Demo ------- ID 2

but when the account is being activated, the template is not automatically updated, i have to go every time to ISP and activate the desired template manually .....

please advise

L.E.
I have alot of IP s set on the web-hosting server. how do i add the IP s in ispconfig ?? under wich user ??? whmcs module creates users automatically .... how can i set the ispconfig to add automatically one or more ips for each client ?? if the user doens t have an ip set in ISP for his account, and it s only set in whmcs module, how will isp module know what ip he will use ?? i want to give individual IP`s for each client ... the install manual found in the module is not enough to know exactly how to make theese settings ..

[Germanius]

You have to set the specific master template ID in the product settings in WHMCS for every product. Every product has its own template id. If you are not sure which template has which ID, have a look in the ISPC database to find it out (because ISPC isnt showing it in the controlpanel).

At the moment it is like this (maybe I will change something in the behaviour in the next releases):
You have to add servers in WHMCS. There you will set a IP for the server. This IP is the one wherewith the websites will be created. Furthermore WHMCS takes this IP and asks ISPC for the correct serverid, where all files will be stored. DNS, MAIL and DATABASE are configured via the product settings in WHMCS.
So at the moment it is not possible to add a different IP for every new client. This functionality is not supported by default by WHMCS.

[Amorphous]

thank you very much i think is now working, haven t tested yet but you were right i have found what i needed in the database ...

nevermind about the ip`s, i will do this manually ......


in the meantime can you please tell me exactlly what i have to change so the users cannot see anymore the option * in the ipv4 menu ?? so they will be able to see directly their own IP, set by me manually ?

[Germanius]

in the meantime can you please tell me exactlly what i have to change so the users cannot see anymore the option * in the ipv4 menu ?? so they will be able to see directly their own IP, set by me manually ?

This is not supported by ISPC. As far as I know ISPC always shows the * and the IPs which you added to the client.

[nokia80]

I have everything geinstaleerd!

The module runs on NS4, and the master server is ns2

if I accept the payment, and then I get this error.

SOAP Error: pm_max_children_error_regex
pm_start_servers_error_regex
pm_min_spare_servers_error_regex
pm_max_spare_servers_error_regex


the user does get created, but the website does not

thanks

[nokia80]

I have everything geinstaleerd!

The module runs on NS4, and the master server is ns2

if I accept the payment, and then I get this error.

SOAP Error: pm_max_children_error_regex
pm_start_servers_error_regex
pm_min_spare_servers_error_regex
pm_max_spare_servers_error_regex


the user does get created, but the website does not

thanks


its solved thanks pffffff

[skoena]

its solved thanks pffffff

Maybe you can write how you got it solved, could be handy for other forum users that have the same issue.

[Germanius]

The next release is nearly finished. I only have to modify the documentation.

Furthermore I am thinking about expanding the functionality for multiserver environments. In this point I need some help from users who have well knowledge about WHMCS and ISPC multiserver environments. Please contact me via email.

[Germanius]

v1.0.3 released (5th Apr 2012):
- Support for DNS templates
- Support for Maildomain creation
- Support for FTP Account creation
- Bug: Website owner was missing
- Bug: Suspend/Unsuspend didn’t work
- Bug: Change Package didn’t work
- Some code improvements

[nokia80]

Create Maildomain doit work. have i change remote user in cp?

[Germanius]

Yes, you are right. Forgot to mention in the documentation that you have to select in remote user settings Mail Domain functions.

[itanium]

Hi,

I have always this error:

SOAP Error: You do not have the permissions to access this function.

I have checked all in Remote Users.

ISPconfig 3.0.4.4 + whmcs ispc3 1.0.3 + no change for remote.conf.php & remoting.inc.php (already in ispconfig 3.0.4.4)

But i can see in ispconfig the account created but no dns , site, mail...

:confused:

[till]

Go to System > Remote users > edit user, then edit the user that you use to connect with whmcs and ensure that all checkboxes are checked and then click on save.

[itanium]

Hi till,

Already done. It's strange because it's a fresh install of ispconfig 3.0.4.4.

http://imageshack.us/photo/my-images/85/whmcsispc3.png/

[till]

I'am talking about the remote user settings in ispconfig, not the settings in whmcs.

[itanium]

yes in ispconfig -> Remote Users -> whmcsfree -> all checkboxes are checked

Password is correct in whmcs & ispconfig

[itanium]

It's seems to be "ISPConfig Domain Tool" who give me the soap error. I have already check this module in ispconfig.

[till]

And the "Domain tool functions" checkbox in the remote user settings is visible and enabled?

[itanium]

you have beat me :)

Even if the module is checked, logout, login (as admin)... I can't find the "Domain tool functions" checkbox :confused:

ps: i have clear the cache of firefox, restart apache

[till]

Are you really sure that you enabled the domain module under System > CP users for the admin user? When I enable it here on my ISPConfig 3.0.4.4 test server, then the domain tool functions checkbox shows up in the remote user settings after a relogin of the admin user.

[itanium]

Thank you till !

I have found why :

I have apc on the server and when i have activated the module under the cp user, i think something goes wrong. I have just uncheck / check this option and now all work fine.

;)

[till]

I recommend to replace apc with xcache, it makes less problems.

[itanium]

xcache? strange because apc will be a part of php6.

I will give it a try on a test server. Thank for your help :)

[falko]

I also have better experiences with Xcache than with APC.

[itanium]

Hello,

xcache seems to be more stable with more scripts and the perf is really good. I keep xcache for now.

I have a multi-server setup (for test) with :

1 server for ispconfig panel only (1)
2 webserver / Mysql / mail (2 / 3)
2 dns server (4 / 5)

How to setup whmcs?

Do i need create each web server (2 /3) in Whmcs Servers.

And on the module section product set :

ISPConfig Server Setting (Syntax: DBserverID,MailserverID,DNSserverID) : 0,0,4

:confused:

[Germanius]

You have to add as many servers in WHMCS as you have servers for websites/files. Each server must have setuped one IP in ISPC for those websites.
Than you can configure for each product the DBserverID, MailserverID and DNSserverID, for example: 2,2,4

[itanium]

hi germanius,

i have read that in the manual. but i have only one panel for 2 servers. this servers is for web mail and mysql.

how can i create web, dns, mails and mysql into server 1 or 2? if i setup the dbid mail id... all this are going into only on 1 of this server. (always the same)

[itanium]

an example :

i create a product : pack web

i have 4 servers for web mail mysql for pack web
i have 2 dns servers for dns (master/slave)
i manage all this on just one server (panel)

how to setup whmcs?

[Germanius]

Have a look at the ISPC database: dbispconfig > server_ip There you can see the IPs connected with the serverid.
You create servers in WHMCS with those IPs. The module takes this IP in WHMCS and asks ISPC about the serverid.
Example:
s1.server.de 123.123.123.123
s2.server.de 321.312.321.321
Create two servers with those IPS. If you select s1, than all websites/files are on server1. If you select s2, than all websites/files are on server2.

[nokia80]

hi

can someone post a list whit exactly functions Thad need to enable in remote user ispconfig fore this module?


thanks

[Germanius]

Client functions, Server functions, Mail Domain functions, Domaintool functions, Sites domain functions, DNS functions (Zone) and Sites FTP user functions

[nokia80]

hi from the last update there was a error on make ftp user
is this error solved??