summaryrefslogtreecommitdiffstats
path: root/doc/appendix
diff options
context:
space:
mode:
authorChris St. Pierre <chris.a.st.pierre@gmail.com>2012-05-04 11:18:49 -0400
committerChris St. Pierre <chris.a.st.pierre@gmail.com>2012-05-04 11:18:49 -0400
commit07b5f654364ca236aa08b80df6d54c1b37bed4b6 (patch)
treee51466a58e06d835b50e02955d27bd10da5d7c12 /doc/appendix
parent5c581e13092bda33165845fa4df16a7e2855e000 (diff)
parent8bc23e6ed36a435cfbab927c64487115efa33bf2 (diff)
downloadbcfg2-07b5f654364ca236aa08b80df6d54c1b37bed4b6.tar.gz
bcfg2-07b5f654364ca236aa08b80df6d54c1b37bed4b6.tar.bz2
bcfg2-07b5f654364ca236aa08b80df6d54c1b37bed4b6.zip
merged maint to master
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]