← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/man/sample.rst

  • Committer: Matt Giuca
  • Date: 2010-02-04 03:08:35 UTC
  • Revision ID: matt.giuca@gmail.com-20100204030835-epwx6qs5ippwopl5
Tags: 1.0beta1
Added subversion dumps as part of sample data. ivle-loadsampledata loads these dumps, so the sample data now comes with sample files (requiring a checkout).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/sample.rst
45
45
* Creates data directories and subversion repositories for all users, backing
46
46
  up directories for any existing users.
47
47
 
48
 
The script is executed with the following command::
 
48
The script is executed with the following command from the IVLE source
 
49
directory::
49
50
 
50
51
    sudo ivle-loadsampledata examples/db/sample.sql
51
52
 
53
54
   installation. Be sure you wish to do this.
54
55
 
55
56
.. note:: The script may fail at the "dropping database" phase if Apache or
56
 
   another process are using the database. It is best to stop Apache before
57
 
   executing the script.
 
57
   another process are using the database. It is best to *restart* (not stop)
 
58
   Apache before executing the script (``sudo /etc/init.d/apache2 restart``).
58
59
 
59
60
   If the database exists, but is not properly initialised, then the script
60
61
   may fail. In this case, you should manually run ``ivle-mountallusers -u``,
63
64
   If there are any existing users (including sample users from previous runs
64
65
   of the script), their files and subversion repos will be moved out of the
65
66
   way to a backup location, ``/var/lib/ivle/jails-removed-<date>/``.
 
67
   If you run this script regularly, your ``/var/lib/ivle/`` will become full
 
68
   of these backups, so you may wish to remove them often. However, they are
 
69
   typically fairly small (a few hundred kilobytes each), because they only
 
70
   contain user content, not the full jail image.
66
71
 
67
72
What is included
68
73
================
125
130
   When studentb logs in for the first time, his SVN repository is created,
126
131
   and given a random password.
127
132
 
 
133
Files
 
134
-----
 
135
 
 
136
The repository for user "studenta" has a few sample files. All of the
 
137
directories must be checked out (using the Checkout button) before the files
 
138
can be seen from the IVLE application.
 
139
 
 
140
* In the :file:`stuff` directory is a sample file, :file:`hello.py`. This is a
 
141
  simple Python script, which can be executed with the "Serve" command.
 
142
 
128
143
Projects
129
144
--------
130
145
 
142
157
Finally, there is a single group for projects 2 and 3, which has the students
143
158
studenta and studentb enlisted.
144
159
 
 
160
Worksheets
 
161
----------
 
162
 
 
163
There are not yet any worksheets.
 
164
 
 
165
Exercises
 
166
---------
 
167
 
 
168
There is currently a single exercise, ``factorial``, which prompts the user to
 
169
write a factorial function and tests its correctness.
 
170
 
145
171
Updating the sample data
146
172
========================
147
173