Go Back   HowtoForge Forums | HowtoForge - Linux Howtos and Tutorials > ISPConfig 3 > General

Do you like HowtoForge? Please consider supporting us by becoming a subscriber.
Reply
 
Thread Tools Display Modes
  #1  
Old 23rd July 2010, 16:06
fatbear fatbear is offline
Member
 
Join Date: Jul 2010
Location: Raleigh, NC US
Posts: 42
Thanks: 4
Thanked 9 Times in 4 Posts
Default User's Guide - Administrator's Guide - Needed

I'm looking to switch from Virtualmin Pro to using ISPConfig because it purports to be able to do clustering and other features that I need.

The problem is that I haven't found any comprehensive, single-source documentation for users and administrators. That is, I'm looking for a single document (pdf, word, or html tree) that describes all of the features of the software.

I have found scattered how-to articles here, but what I've found is not even close to comprehensive documentation sufficient for setting up and doing provisioning of services using ISPConfig. Good documentation surely has to be something that every newcomer needs. I'd like something that describes every item of the UI so that I can do all of the provisioning post-install needs of a hosting business.

So, is there any comprehensive documentation out there? If not, is there at least documentation beyond the "Perfect Server" series? I've done that, but I still need to figure out how to configure DNS, EMail (including greylisting and other spam-fighting options), FTP, etc.

If there isn't any comprehensive documentation, I volunteer to help get us there in "payment" for help along the way.
__________________
Steve Amerige, Fat Bear Incorporated
Server Leasing | Web Software Development | User Experience & Graphic Design
Managed Services, Website, Java, and Source-Code Hosting
Did my post help you? Click the Thanks button!
Reply With Quote
Sponsored Links
  #2  
Old 24th July 2010, 03:18
MrCompTech MrCompTech is offline
Member
 
Join Date: Jul 2010
Posts: 92
Thanks: 1
Thanked 20 Times in 9 Posts
Default

You, me and others have been searching for the same also.

But there isn't one yet, to the best of my knowledge.
Reply With Quote
  #3  
Old 24th July 2010, 04:00
Toucan Toucan is offline
Senior Member
 
Join Date: Dec 2009
Posts: 479
Thanks: 78
Thanked 41 Times in 34 Posts
Default

There's a few articles here

Feel free to learn a function of ISPConfig3, register and submit an article
Reply With Quote
  #4  
Old 25th July 2010, 13:39
fatbear fatbear is offline
Member
 
Join Date: Jul 2010
Location: Raleigh, NC US
Posts: 42
Thanks: 4
Thanked 9 Times in 4 Posts
Default Evaluating the Risks

It is disappointing that the documentation for ISPConfig is so weak. While any documentation at this point is welcome, the documentation that Toucan references is within a commercial website and looks to be barely started. And, the format (articles) is no different than on howtoforge.com.

So, given that there is only poor documentation for ISPConfig, I need to identify additional risks in choosing ISPConfig as a hosting control panel.
  • Strength? How many developers are working on ISPConfig?
    • How many core developers?
    • How many other developers contribute code?
  • Growth? How are new developers added to ISPConfig?
    • If I'm going to choose ISPConfig, I suspect that I'll want to be improving the code and feel that it might as well benefit everybody.
  • Why no Manuals? Why isn't there a wiki on ispconfig.org aimed at achieving comprehensive documentation?
    • If the developers could start a wiki (like MediaWiki/Wikipedia.org) that people could add content to without initial moderation, that would help.
    • Can howtoforge.com host a wiki? Disjoint articles are a poor choice for manuals. While I commend the effort Toucan referenced, it is article-based, just like howtoforge.com. What is really needed is a wiki or a traditional pdf document.
    • If the developers can create a wiki and construct some initial outline, then this would be a good start at comprehensive documentation.
    • I note that howtoforge.com moderates submission. If they provide a wiki, I would strongly encourage wikipedia's approach: allow for unmoderated submission with community policing.
    • If ispconfig.org/howtoforge.com can't/won't put up a wiki (not part of a commercial website), then maybe others could do this.
  • Support? When problems come up, what support options are there?
    • ISPConfig.org doesn't have any forums of its own, but instead uses howtoforge.com forums. I do note that howtoforge.com and ispconfig.org whois information is essentially the same, so maybe it is "all in the family."
If I and others are going to choose ISPConfig, it seems that adopting ISPConfig is going to require more time and effort than buying a solution from a commercial vendor because of the lack of comprehensive documentation. So, I invite any comments that help evaluate the risks in choosing ISPConfig.
__________________
Steve Amerige, Fat Bear Incorporated
Server Leasing | Web Software Development | User Experience & Graphic Design
Managed Services, Website, Java, and Source-Code Hosting
Did my post help you? Click the Thanks button!

Last edited by fatbear; 25th July 2010 at 13:49. Reason: fix attribution; fix grammar
Reply With Quote
  #5  
Old 25th July 2010, 18:38
studiox studiox is offline
Junior Member
 
Join Date: Jul 2010
Posts: 5
Thanks: 0
Thanked 0 Times in 0 Posts
Default

I have to agree with you. An administration guide would be good.

Every time one ask a stupid question (from a developers point of view) here one is ignored or gets stupid replies like "yes everything works".

Instead of the developers or the community around ISP Config writes replies here 1000 times a wiki would make better use. Even we ISP Config users could contribute in a nice open source family to the software and help others.
Reply With Quote
  #6  
Old 26th July 2010, 11:02
Horfic Horfic is offline
Senior Member
 
Join Date: Mar 2009
Location: Austria
Posts: 325
Thanks: 55
Thanked 95 Times in 60 Posts
Send a message via Skype™ to Horfic
Default

Well the core developer is Till, but he isn't the only one contributing to the system. There are people around the globe who are translating it, others are helping Till to add/update features which are wished by the community. I for example contribute with the Mailuser interface based on Roundcube, which is now also available in Squirrelmail. And will continue to develop extensions, which might and up than in the system as default.

Everybody can contribute to it, you just have to contact Till.

Well there was a wiki, but nobody added to it, so it went to heaven.
What about you, why don't you start a wiki or write a manuel, ISPConfig isn't a complicated system. It is nicely structured and good understandable.

The support is great in this community, if you got any problems, somebody will most definetly have a solution.

PS: If you don't like ISPConfig, don't use it.
__________________
web wack creations - We create your custom web application
Mailuser interface for ISPConfig 3
Reply With Quote
  #7  
Old 26th July 2010, 11:19
till till is online now
Super Moderator
 
Join Date: Apr 2005
Location: Lüneburg, Germany
Posts: 37,015
Thanks: 840
Thanked 5,651 Times in 4,461 Posts
Default

Quote:
Strength? How many developers are working on ISPConfig?
More then 80 external developers. But the main development is done by projektfarm GmbH, a german IT company.

Quote:
# Growth? How are new developers added to ISPConfig?
http://www.howtoforge.com/forums/showthread.php?t=135

Quote:
Why no Manuals?
See Horfic's post.

Quote:
Support? When problems come up, what support options are there?
http://www.ispconfig.org/ispconfig-3/support/

Quote:
ISPConfig.org doesn't have any forums of its own, but instead uses howtoforge.com forums. I do note that howtoforge.com and ispconfig.org whois information is essentially the same, so maybe it is "all in the family."
As you see on ispconfig.org, the howtoforge forums are the ispconfig forums.

As a side note, ISPConfig has about 15 - 20 thousand new installs per month and is used by many professionsal ISP's. These ISP's have mostly written own documentation for their clients buty they do not publish it as they dont want to help other ISP's.
__________________
Till Brehm
--
Get ISPConfig support and the ISPConfig 3 manual from ispconfig.org.

Last edited by till; 26th July 2010 at 11:32.
Reply With Quote
  #8  
Old 26th July 2010, 14:55
fatbear fatbear is offline
Member
 
Join Date: Jul 2010
Location: Raleigh, NC US
Posts: 42
Thanks: 4
Thanked 9 Times in 4 Posts
Default Documentation Website Challenge Accepted

Thanks Horfic and Till for your replies.

Quote:
PS: If you don't like ISPConfig, don't use it.
Thanks for this comment because it raises an important point: from what I see, I do like ISPConfig. When people see something they like, people want to know more. Also, in most endeavors, people want to mitigate risk. Documentation goes a long way to satisfy both of these wants.

Quote:
What about you, why don't you start a wiki or write a manual, ISPConfig isn't a complicated system. It is nicely structured and good understandable.
I am encouraged by both of your responses, especially Till's up-front answers to my questions. I have decided to move forward with ISPConfig and will do a couple of things:
  1. Documentation Domain - In consideration of Horfic's encouragement, I've acquired a domain onto which I'll write documentation. The domain will not be affiliated with my hosting business. I'm thinking that I'll do this as a Joomla website with a wiki, forum, etc. and will be developed to render well on both desktops as well as iPhone devices. The wiki will be open to all registered members to make initial unmoderated submissions. The main Joomla website will be open to anyone who wishes author status, again without initial moderation. I've also created a Twitter account to be used to notify subscribers of documentation releases.
  2. Sign up as a Developer - I'm quite sure that I'll want to be extending ISPConfig. As I'm leaving a commercial solution behind, I'll hope to add those things that are missing and are most important to me and my customers.
Quote:
As a side note, ISPConfig has about 15 - 20 thousand new installs per month and is used by many professionsal ISP's. These ISP's have mostly written own documentation for their clients but they do not publish it as they don't want to help other ISP's.
Since I'm very new to ISPConfig, I'm sure I've got a lot to learn... and I will need community support when I have questions. First, I'd like to solicit any ISPs that have documentation to send it to me for use in constructing the documentation website.

Bottom Line: I will post the ISPConfig documentation website URL within a week. It will start pretty empty, but that will change over time. Thanks in advance for your support.
__________________
Steve Amerige, Fat Bear Incorporated
Server Leasing | Web Software Development | User Experience & Graphic Design
Managed Services, Website, Java, and Source-Code Hosting
Did my post help you? Click the Thanks button!
Reply With Quote
The Following User Says Thank You to fatbear For This Useful Post:
Horfic (26th July 2010)
  #9  
Old 6th August 2010, 20:22
Horfic Horfic is offline
Senior Member
 
Join Date: Mar 2009
Location: Austria
Posts: 325
Thanks: 55
Thanked 95 Times in 60 Posts
Send a message via Skype™ to Horfic
Default

I just found in the ovh forums a kind of a user documentation for ispconfig 3.

http://ispc-wiki.org/ispconfig3-anleitung

PS: Its in german^^
__________________
web wack creations - We create your custom web application
Mailuser interface for ISPConfig 3
Reply With Quote
  #10  
Old 6th August 2010, 21:22
fatbear fatbear is offline
Member
 
Join Date: Jul 2010
Location: Raleigh, NC US
Posts: 42
Thanks: 4
Thanked 9 Times in 4 Posts
 
Default Documentation Input is Very Welcomed!

Wonderful, or should I say, "Wunderbar!" With the many translators out there, this is a valuable resource.

While we're talking about documentation, I thought I'd share with the community that the documentation website will be published over this upcoming weekend. I will be adding documentation to it as I learn ISPConfig, so it will, of course, not have a lot of initial content. Even so, any and all feedback will be welcome.

I'll send out an e-mail with the URL when the website is published.
__________________
Steve Amerige, Fat Bear Incorporated
Server Leasing | Web Software Development | User Experience & Graphic Design
Managed Services, Website, Java, and Source-Code Hosting
Did my post help you? Click the Thanks button!
Reply With Quote
Reply

Bookmarks

Tags
administrator guide, documentation, manuals, user guide

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Problem with Clamav + samba configuration wammy28 HOWTO-Related Questions 8 31st January 2009 20:12
Upgrade to php 5.2 in suse 10.1 gimhan90 Installation/Configuration 3 1st January 2009 21:32
Cacti and ISPConfig: Monitoring Tool VMartins Tips/Tricks/Mods 11 9th August 2008 19:37
odbc Chad Installation/Configuration 0 10th April 2008 02:43
Junk mail and spamassassin... sthompson Installation/Configuration 4 27th December 2006 17:11


All times are GMT +2. The time now is 20:25.


Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2014, vBulletin Solutions, Inc.