Developers' side bar
<< | Page list | >>
Notes on administrating the server and setting up new developers. Links to other pages with e.g. release procedure.
Note that this does not include a shell account on the server, that's at the moment only for administrators.
To give Subversion write permission:
sudo su - lyx # Need permission as if the user 'lyx' # Give Subversion write permission by doing the following: emacs ~lyx/etc/passwd # Add line per format: USER = PLAIN-PASSWORD emacs ~lyx/etc/authz # Add developer to the group 'developers'. # Create Trac account by doing the following: htpasswd -sb ~lyx/www/trac/.htpasswd USER PLAIN-PASSWORD
Note: The original text said something about the same password, I don't think this is necessary.
After the user has been added for Trac, someone needs to give that user the correct permissions in Trac, which is done through Trac's web interface.
The e-mail address email@example.com is non-public address for LyX developers.
The LyX project uses "gitolite" for Git repositories on the LyXserver.
To get e.g. write permission to these repositories, contact one of the administrators of gitolite (currently):
Precondition for adding e.g. write permission for a LyX developer:
With SSH access setup, you should be able to do e.g:
ssh firstname.lastname@example.org help
where 'help' is a command to gitolite that will show you other possible commands.
The following command is useful to see e.g. write access:
$ ssh email@example.com info hello chr, this is gitolite 2.3.1-1.el6 running on git 1.7.1 the gitolite config gives you the following access: @C R W developers/chr/..* @R W features @R_ gsoc @R W lyx @R_ @W_ testing
where the second to last row indicates write access to the 'lyx' repository.
To restore someone's account, add their username and a temporary password to trac.htpasswd. You can generate the password using the command:
htpasswd -nbd UserName Password
This will write an appropriate line, such as:
to the terminal. You do not need to be root to do this.
Copy the line that was generated, then open trac.htpasswd and append it to the end. You will need to sudo to do that.
The trac password file is located here
sudo /usr/sbin/adduser -c "<Name>" -G svnusers <loginname>
sudo vi /home/lyx/svnstore/lyx/conf/authz [add a line "<loginname> = rw"]
sudo passwd <loginname>
sudo bash -c 'echo "<real e-mail>" > /home/<loginname>/.forward' sudo chown <loginname>:<loginname> /home/<loginname>/.forward
sudo mkdir -m 700 /home/<loginname>/.ssh
sudo su cd /usr/lib/mailman/bin echo <loginname>@lyx.org |./add_members -r - cvslog
You need to have root access to give an account sudo permissions, so the first step to become root with the following command:
chr@debian:~$ su Password: debian:/home/chr# visudo
Now you can add a username to the list. For example:
Save the file to complete the process.
Then, as root, set a random password (e.g. from pwgen), because without a password he will not be able to use sudo.
(related to the move to the new server)
I think the reason for this could be that the user has logged out in between?
ps: yes, but why wiki.lyx.org is able to remember it?
This should be moved elsewhere...
When for instance you need to send a file that needs to be placed on the LyX ftp site, the following tools/methods could be useful:
We should move this to a separate page.
# Packages installed by Christian, roughly in chronological order # Packages for convenience and CLI power sudo apt-get install screen emacs # Packages for running the web and wiki services sudo apt-get install libapache2-mod-php5 php5-cli php5-common php5-cgi # Packages to be able to build LyX sudo apt-get install automake sudo apt-get install libqt4-dev # Packages to be able to run doxygen, i.e. generate the source docs sudo apt-get install doxygen sudo apt-get install graphviz
A diagram illustrating the ticket workflow (ticket life cycle) can be linked to from wiki pages using
The diagram looks as follows:
Generating the diagram
Here's instructions for generating a diagram with the ticket workflow in Trac.
BINDIR=~larsbj/Development/Trac-0.11.3/contrib/workflow SRCDIR=~lyx/www/trac/conf DSTDIR=~lyx/www/wiki.lyx.org/uploads/Site/Trac cp $SRCDIR/trac.ini $DSTDIR $BINDIR/showworkflow $DSTDIR/trac.ini rm $DSTDIR/trac.ini