Issue 2741 in reviewboard: Getting Started documentation not geared toward non-development install.

2012-09-19 Thread reviewboard

Status: New
Owner: 
Labels: Type-Defect Component-Docs

New issue 2741 by distingu...@gmail.com: Getting Started documentation not  
geared toward non-development install.

http://code.google.com/p/reviewboard/issues/detail?id=2741

What's the URL of the page containing the problem?
http://www.reviewboard.org/docs/codebase/dev/getting-started/

Describe the problem and any recommendations below.
I am quite confused by this introduction. According to this page, it is  
necessary to install all manner of third party packages, with the develop  
mode specified, to get the install up and running. I have done this on one  
machine, and it was both time consuming and not portable.


What about just plain old sudo pip install reviewboard? If I have no  
intention whatsoever of developing review board (not yet, at least), but  
doing this simple pip install seems to get me some of the way there.


It may be because I am on a Mac, but it seems as if this requires further  
steps to get started. I installed mod_wsgi, which seems to be the most  
basic requirement (otherwise I simply see a file hierarchy when I navigate  
to the appointed URL), but after this I am at a loss as to how to start the  
server. I have tried adding a WSGIScriptAlias to my httpd.conf file. I have  
modified the vhosts.conf file and added a virtual host for this server.  
Again here I'm not entirely clear on how to do all of this, as I am new to  
both wsgi and django (this seems to be implied knowledge) but it seems like  
steps like this are necessary to get the server up and running.


By setting debug = True in the settings_local.py file, and then running  
`rb-site manage . runserver`, I can get the page to load (with CSS,  
which was another issue  I saw), but it does not accept my admin  
credentials that I just established.


I would like the install page to contain straightforward, step by step  
instructions as to how to set up review board (preferably on a mac but any  
platform will do) as someone who has no intention of developing this  
software, geared toward the above necessary modifications of virtual host  
and httpd files, and then tells me how to run the server, because it seems  
the runserver command is for testing only. I want to install, set it, and  
forget it, and get to using the web interface, without having all these  
dangling development mode modules and having to manually specify  
dependencies.


Is this truly not possible? I get the feeling I am making this more  
complicated than is necessary, and any guidance would be welcome. But  
either way I would definitely like to see an install page that actually  
told me how to install this piece of software as merely a client user.


Please provide any additional information below.

--
You received this message because you are subscribed to the Google Groups 
reviewboard-issues group.
To post to this group, send email to reviewboard-issues@googlegroups.com.
To unsubscribe from this group, send email to 
reviewboard-issues+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/reviewboard-issues?hl=en.



Re: Issue 2741 in reviewboard: Getting Started documentation not geared toward non-development install.

2012-09-19 Thread reviewboard

Updates:
Status: NotABug

Comment #1 on issue 2741 by trowb...@gmail.com: Getting Started  
documentation not geared toward non-development install.

http://code.google.com/p/reviewboard/issues/detail?id=2741

That's because you're looking at the code-base documentation. Try the admin  
manual instead:


http://www.reviewboard.org/docs/manual/1.6/admin/

--
You received this message because you are subscribed to the Google Groups 
reviewboard-issues group.
To post to this group, send email to reviewboard-issues@googlegroups.com.
To unsubscribe from this group, send email to 
reviewboard-issues+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/reviewboard-issues?hl=en.



Re: Issue 2741 in reviewboard: Getting Started documentation not geared toward non-development install.

2012-09-19 Thread reviewboard


Comment #2 on issue 2741 by distingu...@gmail.com: Getting Started  
documentation not geared toward non-development install.

http://code.google.com/p/reviewboard/issues/detail?id=2741

Well now I feel dumb.

Yes, getting it working on a mac was a matter of:
1) installing mod_wsgi
2) chowning the specified directories to _www
3) copying the contents of apache-wsgi.conf into https-vhosts.conf
4) going to the specified URL

Sorry to bother--it appears I have been banging my head against the wall  
for nothing :[.


--
You received this message because you are subscribed to the Google Groups 
reviewboard-issues group.
To post to this group, send email to reviewboard-issues@googlegroups.com.
To unsubscribe from this group, send email to 
reviewboard-issues+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/reviewboard-issues?hl=en.