Collaborative LaTeX Procedures
Test Service
Procedure to install a test service on another machine.
- Add
<dice/options/coltex-server.h>
header to new test server
- Set the correct directory path. Since the server is currently a desktop this is
/disk/home/HOST/svn
(which is symlinked from /svn
). For a proper server its more likely to be /disk/data/svn
. To change the path to this add (before including <dice/options/coltex-server.h>
)
-
#define _SUBVERSION_REPOSDIR /disk/data/svn
- With CosignV3 need to set the VALIDREF. To do this add (before including
<dice/options/coltex-server.h>
) where NEWHOST
is the hostname of the new test server
-
#define DICE_OPTIONS_COSIGN_VALIDREF ^https://NEWHOST\.inf\.ed\.ac\.uk(/.*)?
- Modify the servername so it doesn't try to be
coltex.inf
, you could do this by adding the following to the new test server profile so it just uses its own name for example
-
!apacheconf.servername mSET(<%profile.node%>.<%profile.domain%>)
- After profile updated may need to do
om x509 run
to get new certs
- On existing
coltex.inf.ed.ac.uk
server make a tar archive of /svn
and /coltex
and transfer to new test server, for example
-
nsu
-
tar zcvfC /tmp/svn.tgz /svn .
-
tar zcvfC /tmp/coltex.tgz /coltex .
-
scp /tmp/svn.tgz NEWHOST:/tmp
-
scp /tmp/coltex.tgz NEWHOST:/tmp
- On new test server,
rm /svn/*
then extract /svn
archive, for example
-
ssh NEWHOST
-
nsu
-
cd /svn
-
tar zxvf /tmp/svn.tgz
- On new test server extract
/coltex
archive, for example
-
ssh NEWHOST
-
nsu
-
cd /coltex
-
tar zxvf /tmp/coltex.tgz
- Start service on new test server,
om apacheconf start
- Connect to test service at
https://NEWHOST/
.
- Client scripts are currently dumb and hard wired to talk to
coltex.inf
. To test client functionality (by following example in Introduction in online documentation) first hand modify /usr/bin/coltex
on your client machine and replace coltex.inf.ed.ac.uk
with NEWHOST.inf.ed.ac.uk
.
- The repository cgi script may break,
https://NEWHOST/repos.html
might just shown an error about not being able to process a directive. If so nsu coltex
, cd /coltex/httpd/cgi-bin
and do ./docreplist.cgi
. If this gives an error then try doing rm -fr /var/coltex/.coltex
and then try again.
Moving Service
Moving the service from one machine to another involves a number of steps.
- Stop the existing service,
om apacheconf stop
- Shift the DNS alias - wait for propogation
- Add
<dice/options/coltex-server.h>
header to new machine
- After profile updated may need to do
om x509 run
to get new certs
- On old machine tar
/svn
and /coltex
and transfer to new machine
- On new machine
rm /svn/*
then extract /svn
archive
- On new machine extract
/coltex
archive
- Start service on new machine,
om apacheconf start
--
TimColles - 19 Feb 2008
Topic revision: r4 - 09 Oct 2009 - 12:01:37 -
TimColles