Debian Apache needs its own docs

Here you can discuss every aspect of Debian. Note: not for support requests!

Debian Apache needs its own docs

Postby Lady Aleena » 2016-09-29 12:29

Hello everyone. This is a bit of a rant.

For a little over a day, I have been working on setting up Apache off and on. It is frustrating because there are no docs for Debian's Apache to be found anywhere on the web. Also, Apache's docs are useless for Debian's Apache since Debian burst httpd.conf into several configuration files in various directories. So reading Apache's site is not going to help when one is trying to figure out where to put things since Apache states httpd.conf all over their docs.

My last hurdle to getting Apache set up is finding which file to edit to put my local perl libs into @INC in Apache so I can run my scripts in the browser without having to install modules into root's perl libs. I also need to know what to put into that file. There are no clear instructions for that.

Also, why did liblocal-lib-perl not update Apache to set my local libs in Apache along with setting up the local lib in my home directory? Could the program be configured to see if Apache is installed and ask if the user wants to include local libs in Apache? That would make things so much easier.

So, when it comes to needing docs, Debian Apache is in desperate need. Also the docs need to be simplified to include step by step instructions on what files need to be configured and how they need to be configured.

The first thing, in my opinion, to configure would be /etc/apache2/apache2.conf. The next file to be configured would be /etc/apache2/sites-available/000-default.conf. Then anything else like configuring Apache to look for local libs in users' home directories.

I am editing the configuration files nearly blind because there are no docs written specifically for Debian Apache configuration and having to get a lot of help from people here and on IRC. I am half guessing.

Sure modularization is good, but it is bad when there are no docs written to explain what goes where.

Right now I can not get my index.pl to load in my browser because my local libs are not recognized by Apache, and there are no Debian Apache configuration docs to tell me into which configuration file I need to put the list. It is extremely frustrating. I am sliding more towards just throwing caution to the wind and cpaning modules right into root's libs because my local libs are worthless without Apache being able to see them too.

Write docs please?!?!
Lady Aleena
 
Posts: 19
Joined: 2013-12-06 07:48

Re: Debian Apache needs its own docs

Postby wizard10000 » 2016-09-29 13:02

This might help a little - good luck!

https://wiki.debian.org/LaMp
we see things not as they are, but as we are.
-- anais nin
User avatar
wizard10000
 
Posts: 1295
Joined: 2011-05-09 20:02
Location: everywhere i go, there i am!

Re: Debian Apache needs its own docs

Postby dasein » 2016-09-29 17:07

Lady Aleena wrote:So, when it comes to needing docs, Debian Apache is in desperate need.

Sounds like you've developed a lot of expertise through recent firsthand experience.

Since you feel so passionately about the need for docs, maybe it's time to share that expertise by writing a HOWTO or two. There's even a handy HOWTO section in these forums where you can post the finished product(s).
User avatar
dasein
 
Posts: 7775
Joined: 2011-03-04 01:06
Location: Terra Incantationum

Re: Debian Apache needs its own docs

Postby Lady Aleena » 2016-09-29 21:44

dasein, funny. I still can't get my site to load because Apache won't see my local perl libs at /home/me/perl5. I will probably have to install modules with cpan to root's libs to make it work.
Lady Aleena
 
Posts: 19
Joined: 2013-12-06 07:48

Re: Debian Apache needs its own docs

Postby dasein » 2016-09-30 03:25

Lady Aleena wrote:dasein, funny.

Quite serious.
User avatar
dasein
 
Posts: 7775
Joined: 2011-03-04 01:06
Location: Terra Incantationum

Re: Debian Apache needs its own docs

Postby Danielsan » 2016-10-06 01:07

User avatar
Danielsan
 
Posts: 496
Joined: 2010-10-10 22:36

Re: Debian Apache needs its own docs

Postby millpond » 2016-11-21 22:08

Lady Aleena wrote:dasein, funny. I still can't get my site to load because Apache won't see my local perl libs at /home/me/perl5. I will probably have to install modules with cpan to root's libs to make it work.


Do youself a BIG favor and install XAMPP FOR LINUX, from Apachefiends. Put it in /opt.
It wont mess with system apps, and will/should have its own Perl.
Its docs and setup will be much easier to read and deal with.
millpond
 
Posts: 582
Joined: 2014-06-25 04:56


Return to General Discussion

Who is online

Users browsing this forum: No registered users and 4 guests

fashionable