Mailing-List: contact bloodhound-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: bloodhound-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of gary.martin@wandisco.com
 designates 74.125.83.47 as permitted sender)
Message-ID: <4FFAC641.2050408@wandisco.com>
Date: Mon, 09 Jul 2012 12:53:37 +0100
From: Gary Martin <gary.martin@wandisco.com>
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
 rv:13.0) Gecko/20120615 Thunderbird/13.0.1
MIME-Version: 1.0
To: bloodhound-dev@incubator.apache.org
Subject: Re: [Apache Bloodhound] BloodhoundInstall modified
References: <20120709114841.EFA88810FB@bloodhound-vm>
In-Reply-To: <20120709114841.EFA88810FB@bloodhound-vm>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

Hi,

I just updated the 
https://issues.apache.org/bloodhound/wiki/BloodhoundInstall page to 
document using bloodhound_setup.py instead of installer.py

If anyone can check it through, that would be great.

Cheers,
     Gary


On 07/09/2012 12:48 PM, Apache Bloodhound wrote:
> Page "BloodhoundInstall" was changed by gjm
> Diff URL: <https://issues.apache.org/bloodhound/wiki/BloodhoundInstall?action=diff&version=6>
> Revision 6
> Changes:
> -------8<------8<------8<------8<------8<------8<------8<------8<--------
> Index: BloodhoundInstall
> =========================================================================
> --- BloodhoundInstall (version: 5)
> +++ BloodhoundInstall (version: 6)
> @@ -10,7 +10,6 @@
>    {{{
>      sudo apt-get install python python-setuptools python-pip
>    }}}
> -
>   
>   At the moment it is also recommended that you install virtualenv with either
>    {{{
> @@ -79,36 +78,45 @@
>   
>   To continue the installation, refer to BloodhoundDetailedInstallation before continuing to the Testing the Server section below.
>   
> -== Installation Script ==
> +== Installation ==
>   
> -Bloodhound provides a simple installation script that is capable installing a basic Bloodhound setup based on the answers to a few questions. If you have Subversion installed, this is how you can try it out:
> +To install Bloodhound, the following steps represent the current recommended method:
> +
>    {{{
> -   svn co https://svn.apache.org/repos/asf/incubator/bloodhound/trunk/installer/
> -   cd installer
> -   python installer.py
> +   svn co https://svn.apache.org/repos/asf/incubator/bloodhound/trunk bloodhound
> +   cd bloodhound/installer
> +   virtualenv bloodhound
> +   source ./bloodhound/bin/activate
> +   pip install -r requirements-dev.txt
> +   python bloodhound_setup.py
>    }}}
>   
>   and answer the questions based on whether you chose to use SQLite or PostgreSQL. If you choose an SQLite installation, you should only have to specify a username and password to login to Bloodhound with once it is running. For PostgreSQL, the only extra questions will be to specify the database name, database user and the associated password.
>   
>   In fact it is possible to specify all these details on the command line which also allows you to set additional options like the host for the PostgreSQL database and provide a different location for the installation. For more information on these options, run
>    {{{
> -   python installer.py --help
> +   python bloodhound_setup.py --help
>    }}}
>   
> +Note that for windows, amongst the other differences you should use
> + {{{
> +   bloodhound\bin\activate.bat
> + }}}
> +to activate the bloodhound environment.
> +
>   == Testing the Server ==
> -On linux and other unix-like systems you can then run bloodhound using::
> +
> +If the bloodhound_setup.py script completed successfully, you will be informed of the appropriate command to run the test server and the appropriate url to check. If you did not set any advanced options, you should find that you can start bloodhound using:
>    {{{
> -   source ./bloodhound/bin/activate
>      tracd ./bloodhound/environments/main --port=8000
>    }}}
>   
> -On windows you should instead use:
> +and you will be able to access Bloodhound on
>    {{{
> -   bloodhound\bin\activate.bat
> -   tracd bloodhound\environments\main --port-8000
> +   http://localhost:8000/main/
>    }}}
>   
> -At this point you should be able to access Bloodhound on http://localhost:8000/main/ and you can login with the admin user and password details you supplied earlier.
> +Remember that if you run tracd from a fresh shell, you will need to activate the virtual environment first and you should ensure that the path to the directory containing the environment is correct. An incorrect path to the environment will result in an "Environment not found" message, as will specifying the wrong environment name in the url.
>   
>   == Web Server ==
>   
> @@ -147,7 +155,7 @@
>         AuthType Digest
>         AuthName "Bloodhound"
>         AuthDigestDomain /bloodhound
> -      AuthUserFile /path/to/bloodhound/environments/bloodhound.htdigest
> +      AuthUserFile /path/to/bloodhound/environments/main/bloodhound.htdigest
>         Require valid-user
>       </LocationMatch>
>     </VirtualHost>
> -------8<------8<------8<------8<------8<------8<------8<------8<--------
>
> --
> Page URL: <https://issues.apache.org/bloodhound/wiki/BloodhoundInstall>
> Apache Bloodhound <https://issues.apache.org/bloodhound/>
> The Apache Bloodhound (incubating) issue tracker
>
> This is an automated message. Someone added your email address to be
> notified of changes on 'BloodhoundInstall' page.
> If it was not you, please report to .