Logged-In As
ACCOUNT
Not Logged In
Convert the AppserverJailsHOWTO wiki page into a separate article (Tomcat) FreeBSD
Status: Closed Time to complete: 120 hrs Mentors: Glen Barber, Gavin Atkinson Tags: tomcat, documentation, FreeBSD, DocBook, SGML

Description of task

There is a howto in the FreeBSD wiki on creating a tomcat server with a focus on security:

http://wiki.freebsd.org/AppserverJailsHOWTO

We want to have this in a separate FreeBSD article within the FreeBSD documentation tree to instruct our users on how to create such a system. The version information of the software might be outdated, so the howto needs to be checked whether it still works as described. 

Task Requirements

Students should use a FreeBSD system like our VirtualBox image to test the procedure, and should be prepared to research information available online.

Please read http://wiki.FreeBSD.org/GoogleCodeIn/GettingStarted before accepting this task, as it contains further details on what this task consists of, as well as providing useful information on how to obtain the page source and how to proceed with the task.

Uploaded Work
File name/URL File size Date submitted
textonly.sgml 22.8 KB January 02 2012 08:42 UTC
textonly.sgml 22.8 KB January 02 2012 08:49 UTC
textonly.sgml 24.8 KB January 04 2012 07:19 UTC
textonly.sgml 24.7 KB January 04 2012 07:20 UTC
Comments
mpaloski on November 26 2011 12:40 UTC Task Claimed

I would like to work on this task.

mpaloski on November 26 2011 12:50 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

kendhia on November 30 2011 06:21 UTC Help

I want to work on this task , but i have a problem with freebsd .


after i finished installation of freebsd i can't acces to the desktop ( i think i didn't find how to acces to it).


could you help me please ?

Glen Barber on December 1 2011 02:35 UTC Can't access the desktop...

Hi there,


 


Could you give me a bit more information on what problems you are having?


 


It isn't clear to me from your message what exactly isn't working for you, though I'm happy to help. :-)


 


Glen

Alex R on December 1 2011 13:05 UTC Task Claimed

I would like to work on this task.

Glen Barber on December 1 2011 16:22 UTC Task Assigned

This task has been assigned to Alex R. You have 120 hours to complete this task, good luck!

Alex R on December 4 2011 17:34 UTC Claim Removed

The claim on this task has been removed, someone else can claim it now.

kendhia on December 5 2011 19:58 UTC I'm sorry

I'm sorry because i didn't reply . thank you very much , i found the solution .


After i finish my task i'll try to claim freebsd tasks because i really love this project.

kendhia on December 22 2011 23:13 UTC Expected form

Hello mentors,


what to the expected form of the solution of this task ?


Greeting!


Kendhia :S

Glen Barber on December 23 2011 00:08 UTC Expected form

Hello Kendhia,


Can you please explain a bit more on what you mean?


Thanks,


Glen

kendhia on December 23 2011 10:43 UTC ....

Hello Glen,


I mean to close this task what should you upload  (.txt or .html, .php....)


I hope you understand me .


Greeting!


Kendhia :S

Glen Barber on December 23 2011 17:39 UTC Expected form

Hello Kendhia,


The format should be SGML, but can be uploaded as a .txt file.


Here is a link to the FreeBSD Documentation Project Primer, which covers SGML formatting:


 http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/


I hope that helps.


Let us know if you have further questions.


Glen

kendhia on December 23 2011 17:45 UTC Ok

Hello, tnak you for helping .


Greeting!


Kendhia :-)

Bharath Mohan on December 27 2011 16:50 UTC Unable to use the provided image?

Hello,


As explained in the getting started page, I downloaded the ova file that was given, and imported into Virtualbox. However, when I try to start it, I get this error output:


Failed to open a session for the virtual machine FreeBSD9.0_GCIN.


Nonexistent host networking interface, name 'vboxnet0' (VERR_INTERNAL_ERROR).

















Result Code:E_FAIL (0x80004005)
Component:Console
Interface:IConsole {1968b7d3-e3bf-4ceb-99e0-cb7c913317bb}

Could you possible help me understand what is wrong? Were there any special setup steps that I missed? I was under the impression it was just download file, import into Virtualbox, then run, but I might have missed something...

Bharath Mohan on December 27 2011 16:55 UTC Fixed it, sorry for the trouble!

After I commented, I went ahead and played around with the network interfaces options for a while. For those who may be having the same problem, just cycle Adapter 1 to not connected, then put it back to NAT again. Virtualbox automatically corrects the advanced to settings to the necessary ones. Or, at least it did in my case.

Bharath Mohan on December 27 2011 17:41 UTC Task Claimed

I would like to work on this task.

Gavin Atkinson on December 27 2011 18:09 UTC Strange

Hi,


I'm not sure what went wrong with VirtualBox - this is the first report of issues that I've heard and it's worked fine for several people - but it's good to hear that you have got it working now.


Gavin 

Gavin Atkinson on December 27 2011 18:09 UTC Task Assigned

This task has been assigned to Bharath Mohan. You have 120 hours to complete this task, good luck!

Bharath Mohan on December 30 2011 21:13 UTC So just reformat the existing wiki page?

I tested the instruction given under a new FreeBSD install, and it worked fine. So I am assuming that all that is left to do is reformat the existing wiki into SGML format and upload that file? Or have I missed something?

Gavin Atkinson on December 31 2011 19:39 UTC Basically, yes

Hi,


Essentially, yes.  Now that you have tested the instructions, all that really needs to be done is reformatting the page into SGML.  Am I right in thinking that you've already done one of these tasks for us?  If not, and you need further instructions as to how to go about this, let me know.


As you've been waiting 24 hours for a response, I'll add an extra day onto the allowed time.


Thanks,


Gavin 

Gavin Atkinson on December 31 2011 19:39 UTC Deadline extended

The deadline of the task has been extended with 1 days and 0 hours.

Bharath Mohan on December 31 2011 20:01 UTC SGML formatting

Just following the instructions on the FDP Primer to reformat it should work right? I've actually done no tasks before for FreeBSD, so any help would be appreciated. But, from what I've seen, all that I need to do is copy the source of the wiki page and edit the tags of the elements to conform with SGML parser standards. Am I right in thinking this?

Bharath Mohan on December 31 2011 20:02 UTC Also, Thanks!

I forgot to add this in the last comment, but thank you for the extension! I may or may not need it, but thanks anyway for the thought!

Gavin Atkinson on January 2 2012 00:15 UTC Sort of

Hi,


That's sort of what needs doing, yes - although you may well find it easier to just copy the text and add SGML tags around it, rather than starting with the wiki source and working from there.


Whichever works best for you really :)


Gavin 

Bharath Mohan on January 2 2012 08:41 UTC That sounds smart :D

That's exactly what my dad suggested when he asked what I was doing. He even helped me out with the SGML writing, so I didn't have to trawl through the entire writing. Though, admittedly, he was only familiar or Oasis Docbook, and he used DOCTYPE article instead of html. He insisted that since I was only transliterating the text, article worked better, and I guess I can see why, as no real html tags were ever included. I hope none of this is a problem? I've uploaded the full file for you to see, so you can double check my work and get back on if its OK or not.

Bharath Mohan on January 2 2012 08:43 UTC Ready for review

The work on this task is ready to be reviewed.

Bharath Mohan on January 2 2012 08:52 UTC Forgot to add saved changes

Sorry about the 2 files up there. I forgot to save my changes before I uploaded, so I had to save then re-upload. I'll see if there's a way I can take the original down, but if I haven't when you check, could you please use the later file? Thanks.

Melange on January 2 2012 20:27 UTC No more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Gavin Atkinson on January 4 2012 00:07 UTC More work required

Hi,


Thanks for your work on this so far.  Unfortunately, I'm afraid that I'll have to ask you to do a bit more work on this task before it is ready - I hope you don't mind.  I should also apologise that you've been waiting for two days for feedback - it's been hard to find sufficient time over the new year to review all of the tasks that were submitted.  Accordingly, I'll extend the deadline by three days, but I really don't think there's much more than a couple of hours work needs to be done on this.


Firstly, there seem to be quite a few bits of unnecessary code in what you have produced.  I'm not sure what all of the "&#0;" are there for, for example - they should all be removed.  Also, there are a few empty paragraphs, i.e. "<para></para>" that can also be removed.


Secondly, I think the "Improvement" section and the "last edited" section after it only really make sense on the wiki, and can probably just be removed from the SGML version.


Third, if you take a look at the source of one of the existing FreeBSD articles, for example http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/articles/hubs/article.sgml?rev=1.73;content-type=text%2Fplain , you'll see a couple of things which would be beneficial if you can attempt to replicate in your work.  Firstly, note how it is indented - opening tags like "<itemizedlist>" line up with the corresponding closing tag "</itemizedlist>", and indenting is two spaces.  This makes it quite a bit easier to review, as well as being easier for you to get a better feel for how the page looks and whether any opening or closing tags are missing.  Secondly, note how the author has been included towards the start - it would be good if you could rework the daniel@quanza.net sentence into something like how the hubs article handles those authors.


After all that though, I this should be in a good position to accept.


Again, thanks for your work so far!  I am sorry that I've had to send this back for more work but please don't be disheartened - you have done a lot of good work here and especially testing all the instructions carefully is very much appreciated.


Thanks again,


Gavin 

Gavin Atkinson on January 4 2012 00:08 UTC Task Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Gavin Atkinson on January 4 2012 00:08 UTC Deadline extended

The deadline of the task has been extended with 3 days and 0 hours.

Bharath Mohan on January 4 2012 05:33 UTC On it!

Sorry about thsoe random puctuation marks. I'm not sure where they came from; I remember seeing them when making it, but that happened when I just copied the text. I assumed it had something to do with punctuation and whatnot. I'll get rid of those and those empty paragraphs.


I guess the improvements section could be taken out... but for the "last edited" section, maybe that should be included as a note? Maybe not as last edited, but last checked or something? I'll leave that one alone for now and wait for some feedback.


I'll lok through that source and see what needs to be done. And don't worry, its not at all disheartening. I take it as a challenge! Though I'll admit, I got plenty frustrated testing it out on a VM; some things just don't seem to want to work right there. I'm not even sure how I managed it in the end. I probably couldn't reproduce it if I tried...

Bharath Mohan on January 4 2012 07:20 UTC Ready for review

The work on this task is ready to be reviewed.

Bharath Mohan on January 4 2012 07:24 UTC This it?

I went through and made all the code more organized and used 2 spaces as the default indentation, and indented each "section" tag by one more indent (2 more spaces). After some consideration, I decided you were probably right about the "last edited" section, and went ahead and took that out. And those annoying empty paragraphs and the random punctuation's out, too. I wasn't entirely sure if the indentation I put in is exactly what you want, but it seemed like the right thing. I hope this is good!

Gavin Atkinson on January 4 2012 18:18 UTC Task Closed

Congratulations, this task has been completed successfully.

Gavin Atkinson on January 4 2012 18:21 UTC Excellent!

Hi,


Just to say that this work is now looking great.  Thank you for your work on this, it is much appreciated :)  The indentation is actually almost perfect.


Thanks again, 


Gavin