incubator-bloodhound-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Apache Bloodhound" <bloodhound-...@incubator.apache.org>
Subject [Apache Bloodhound] BloodhoundInstall modified
Date Mon, 09 Jul 2012 11:48:41 GMT
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 .

Mime
View raw message