Re: [Ispman-docs] ISPMan Handbook - First Draft

[Tony W. <wa...@az...>]

> On Wed, 2004-01-28 at 08:25, Tony Wasson wrote:
>> Pheew! It's been almost a month since starting on the ISPMan Handbook,
>> so
>> I'm giving an update. I've posted a First Draft of the ISPMan Handbook
>> in
>> PDF, HTML and OpenOffice format. It is about 30 pages long.
>>
>> http://www.azxws.com/ispman/
>>
>> Please let me know if you have suggestions or can expand one of the
>> chapters.
>
> Did you use OOo to generate the HTML and PDF?  Could OOo generate links
> from the TOC to the contents?

Yes, I just did "Export to PDF" and "Save as > HTML". If I knew a little
more about OO I could probably make the links work.

> The images seem to be artificially scaled down, which makes the text on
> them illegible.

OK, I will see what I can do.

> Under "Filesystem Layout", /ispman/domains, there are example user
> directories of
>
> example.com/users/atif_domain_com
>
> example.com/users/arno_domain_com
>
> Which should be
>
> example.com/users/atif_example_com
>
> example.com/users/arno_example_com

Ooops.  I was debating switching ALL the examples to "domain.tld"

> Exactly what "processes" are and why they're necessary does not seem to
> be explained (at least, not in the "Processes" section).

You're right, I need to fill this out more.

> The ldapvirtual stuff works for Postfix 1.1 also, if compiled for it.  I
> also set up Postfix to use an LDAP map for 'relay_domains' (the only big
> difference is the query_filter and result_attribute):
>
> http://nakedape.cc/wiki/index.cgi/IspManPostfixRelay
>
> I think you've got the headings for the "PureFTPd" and "ProFTPd"
> sections backwards.
>
> The first two images in chapter 5 are missing in the on-line version:
> missing "1. Click on Add Domain, filling out these pieces of info:" and
> "2. The next screen looks like this".
>
>> Chapter 1 is wrapping up, and the rest of it beginning to take shape.
>> I've
>> also added a section about Migration, with some general tips. This needs
>> to be expanded, since I've only done 2 migrations.
>
> One thing I've recently done for migration (the only one I've done so
> far) is to modify the migration tool from PADL to generate the entries I
> wanted.  'uid' seems to work okay as a multi-valued attribute, and to
> avoid the trouble of figuring out all the right filters, I just created
> entries with both 'username' and 'username_example_com'.

Interesting! I wanted to include several filter examples because I feel
like everyone is "re-inventing" the wheel.

Thanks for all the suggestions Wil. I will try to get these all done when
I come back from vacation next week. In the mean time, feel free to hack
on the documentation wherever you see fit and if you have time. I'd like
this to be a community document.

Tony Wasson