← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/man/install.rst

  • Committer: William Grant
  • Date: 2010-02-26 07:31:28 UTC
  • Revision ID: grantw@unimelb.edu.au-20100226073128-2cvhekpt3eq81by7
Document slave setup from a package.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/install.rst
465
465
   sudo ivle-buildjail -r
466
466
 
467
467
You should now have a functional master.
 
468
 
 
469
 
 
470
Slave setup
 
471
-----------
 
472
 
 
473
Installing and configuring IVLE
 
474
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
475
 
 
476
We need to tell the database configuration assistant that we want to connect
 
477
to a remote database. The second command will also ask you whether you want to
 
478
store administrative passwords: say no here. ::
 
479
 
 
480
   sudo apt-get install dbconfig-common
 
481
   sudo dpkg-reconfigure dbconfig-common
 
482
 
 
483
We are going to need some details from the master for authentication purposes.
 
484
Grab the ``password`` value from the ``database`` section, and the ``magic``
 
485
value from the ``usrmgt`` section of the master's ``/etc/ivle/ivle.conf``.
 
486
 
 
487
Now we can install IVLE. Advise the installer that this machine is not a
 
488
master, and use the details retrieved from the master to answer the rest of
 
489
the questions. ::
 
490
 
 
491
   sudo apt-get install ivle
 
492
 
 
493
Once the installation has completed, make the same configuration changes as on
 
494
the master: set the domain names in ``ivle.conf`` to real values.
 
495
 
 
496
For maximum performance, you should also set the ``version`` value in the
 
497
``media`` section. The exact string is not important, as long as the value is
 
498
identical on every slave, and changed on each upgrade. It is used to make
 
499
static file URLs unique, so clients can cache them indefinitely. The IVLE
 
500
version is conventionally used as this string.
 
501
 
 
502
 
 
503
Getting access to the shared data
 
504
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
505
 
 
506
We need to mount the shared components of the IVLE data hierarchy from the
 
507
master. If you've used the suggested method, follow these instructions.
 
508
Otherwise you'll have to work it out for yourself.
 
509
 
 
510
First install the NFS common utilities, required for NFS mounts. ::
 
511
 
 
512
   sudo apt-get install nfs-common
 
513
 
 
514
Now we can add the mount to ``/etc/fstab``. Something like this should do: ::
 
515
 
 
516
  themaster:/export/ivle /export/ivle nfs defaults 0 0
 
517
 
 
518
Then mount the filesystem, and link the shared directories into the
 
519
hierarchy. ::
 
520
 
 
521
   mount -a
 
522
   ivle-createdatadirs
 
523
   rmdir /var/lib/ivle/{sessions,jails}
 
524
   ln -s /export/ivle/{sessions,jails} /var/lib/ivle
 
525
 
 
526
 
 
527
Configuring Apache
 
528
~~~~~~~~~~~~~~~~~~
 
529
 
 
530
The slaves use Apache to serve the main IVLE web UI and public user files.
 
531
Let's activate the configuration now. ::
 
532
 
 
533
   sudo cp /usr/share/doc/ivle/apache.conf /etc/apache2/sites-available/ivle
 
534
   sudo a2ensite ivle
 
535
 
 
536
Now edit ``/etc/apache2/sites-available/ivle``, and ensure that the
 
537
``ServerName`` matches your chosen IVLE web UI domain name, and
 
538
``ServerAlias`` your public name. Then reload Apache's configuration. ::
 
539
 
 
540
   sudo /etc/init.d/apache2 reload