summaryrefslogtreecommitdiffstats
path: root/doc/appendix
diff options
context:
space:
mode:
authorSol Jerome <sol.jerome@gmail.com>2012-05-02 08:28:02 -0500
committerSol Jerome <sol.jerome@gmail.com>2012-05-02 08:28:02 -0500
commita24165b9b7dd05a104cc10176e54fa9b5bb91812 (patch)
treee1546dc49cfcc94fef758c022a64d434af0aa72e /doc/appendix
parent3824f10c6edaa7ee1cfff65d1eb17343a5b20b9c (diff)
downloadbcfg2-a24165b9b7dd05a104cc10176e54fa9b5bb91812.tar.gz
bcfg2-a24165b9b7dd05a104cc10176e54fa9b5bb91812.tar.bz2
bcfg2-a24165b9b7dd05a104cc10176e54fa9b5bb91812.zip
doc: Fix reports installation docs (reported by calvinx on IRC)
Signed-off-by: Sol Jerome <sol.jerome@gmail.com>
Diffstat (limited to 'doc/appendix')
-rw-r--r--doc/appendix/guides/web-reports-install.txt144
1 files changed, 16 insertions, 128 deletions
diff --git a/doc/appendix/guides/web-reports-install.txt b/doc/appendix/guides/web-reports-install.txt
index f6a588692..c03682974 100644
--- a/doc/appendix/guides/web-reports-install.txt
+++ b/doc/appendix/guides/web-reports-install.txt
@@ -11,125 +11,17 @@
Dynamic (web) Reports installation
==================================
-The first step is to install the needed software components like the
-Django framework and the database (SQlite2). All packages for Fedora
-are in the Fedora Package Collection or in EPEL_ for CentOS/RHEL::
-
- [root@system01 ~]# yum -y install Django python-simplejson python-sqlite2
-
-Of course is a web server needed as well::
-
- [root@system01 ~]# yum -y install httpd mod_python
-
-The same packages are needed for Ubuntu systems::
-
- [root@system01 ~]# aptitude install python-django apache2 libapache2-mod-python
-
-Now we need to create the sqlite database. Use the following command on
-Fedora, CentOS, or RHEL.::
-
- [root@system01 ~]# python /usr/lib/python2.4/site-packages/Bcfg2/Server/Reports/manage.py syncdb
- Creating table auth_permission
- Creating table auth_group
- Creating table auth_user
- Creating table auth_message
- Creating table django_content_type
- Creating table django_session
- Creating table django_site
- Creating table django_admin_log
- Creating table reports_client
- Creating table reports_ping
- Creating table reports_interaction
- Creating table reports_reason
- Creating table reports_entries
- Creating table reports_entries_interactions
- Creating table reports_performance
- Creating table reports_internaldatabaseversion
-
- You just installed Django's auth system, which means you don't have any superusers defined.
- Would you like to create one now? (yes/no): no
- Installing index for auth.Permission model
- Installing index for auth.Message model
- Installing index for admin.LogEntry model
- Installing index for reports.Client model
- Installing index for reports.Ping model
- Installing index for reports.Interaction model
- Installing index for reports.Entries model
- Installing index for reports.Entries_interactions model
-
-.. note:: There are different versions of Python available. If you are
- unsure about your installed version use the following line instead of
- the line above.::
-
- [root@system01 ~]# PYVER=`python -c 'import sys;print(sys.version[0:3])'`; python /usr/lib/python$PYVER/site-packages/Bcfg2/site-packages/Bcfg2/Server/Reports/manage.py syncdb
-
-The path on Ubuntu systems is different. Please use the same path as shown
-in the following command to execute the script on an Ubuntu machine in
-the next steps::
-
- [root@system01 ~]# python /usr/share/pyshared/Bcfg2/Server/Reports/manage.py syncdb
- Creating table auth_permission
- Creating table auth_group
- Creating table auth_user
- Creating table auth_message
- Creating table django_content_type
- Creating table django_session
- Creating table django_site
- Creating table django_admin_log
- Creating table reports_client
- Creating table reports_ping
- Creating table reports_interaction
- Creating table reports_reason
- Creating table reports_entries
- Creating table reports_entries_interactions
- Creating table reports_performance
- Creating table reports_internaldatabaseversion
-
- You just installed Django's auth system, which means you don't have any superusers defined.
- Would you like to create one now? (yes/no): no
- Installing index for auth.Permission model
- Installing index for auth.Message model
- Installing index for admin.LogEntry model
- Installing index for reports.Client model
- Installing index for reports.Ping model
- Installing index for reports.Interaction model
- Installing index for reports.Entries model
- Installing index for reports.Entries_interactions model
-
-The server should be tested to make sure that there are no mistakes::
-
- [root@system01 ~]# python /usr/lib/python2.6/site-packages/Bcfg2/Server/Reports/manage.py testserver
- Creating test database...
- Creating table auth_permission
- Creating table auth_group
- Creating table auth_user
- Creating table auth_message
- Creating table django_content_type
- Creating table django_session
- Creating table django_site
- Creating table django_admin_log
- Creating table reports_client
- Creating table reports_ping
- Creating table reports_interaction
- Creating table reports_reason
- Creating table reports_entries
- Creating table reports_entries_interactions
- Creating table reports_performance
- Creating table reports_internaldatabaseversion
- Installing index for auth.Permission model
- Installing index for auth.Message model
- Installing index for admin.LogEntry model
- Installing index for reports.Client model
- Installing index for reports.Ping model
- Installing index for reports.Interaction model
- Installing index for reports.Entries model
- Installing index for reports.Entries_interactions model
- Validating models...
- 0 errors found
-
- Django version 1.1.1, using settings 'Reports.settings'
- Development server is running at http://127.0.0.1:8000/
- Quit the server with CONTROL-C.
+You need to install the bcfg2-web package that is available for your
+particular distribution. All packages for Fedora are in the Fedora
+Package Collection.
+
+You can find packages for CentOS and RHEL in EPEL_::
+
+ [root@system01 ~]# yum -y install bcfg2-web
+
+The same packages are needed for Debian/Ubuntu systems::
+
+ [root@system01 ~]# aptitude install bcfg2-web
Add DBStats to the plugins line of ``bcfg2.conf``. The resulting
**[server]** section should look something like this::
@@ -138,6 +30,10 @@ Add DBStats to the plugins line of ``bcfg2.conf``. The resulting
repository = /var/lib/bcfg2
plugins = Base,Bundler,Cfg,...,DBStats
+You then need to initialize the DBStats reporting database::
+
+ [root@system01 ~]# bcfg2-admin reports init
+
Start/restart the Bcfg2 server::
[root@system01 ~]# /etc/init.d/bcfg2-server restart
@@ -146,16 +42,8 @@ Run the Bcfg2 client in order to populate the statistics database
(this run should take a bit longer since you are uploading the client
statistics to the database).
-Download the static reports content::
-
- [root@system01 ~]# git clone git://git.mcs.anl.gov/bcfg2
- [root@system01 ~]# cd /var/www/
- [root@system01 ~]# mv /path/to/bcfg2/checkout/reports ./
-
-Configure Apache using :ref:`dynamic-http-install` as a guide
-
Copy server/statistics sections of ``bcfg2.conf`` to
-``/etc/bcfg2-web.conf`` (make sure it is world-readable). You should
+``/etc/bcfg2-web.conf`` (make sure it is world-readable). You should
then have something like this::
[server]