X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=INSTALL;h=9cc36f41aca382ddcfde6dc45566cf33aa4cba92;hb=0c8556a2efd78a16d130370c351138faeae7cd33;hp=f593f7073c1ad50e8635fb7669fea14f3ad5eb0b;hpb=e5e8648e4e4bd1edb1823dc932c96a7a271b27a4;p=paraslash.git
diff --git a/INSTALL b/INSTALL
index f593f707..9cc36f41 100644
--- a/INSTALL
+++ b/INSTALL
@@ -7,14 +7,17 @@ Any knowledge of how to work with mouse and icons is not required.
---------------------------
Install all needed packages
---------------------------
-
-See README for a list of required software. You don't need everything
-listed there. In particular, mp3, ogg vorbis and aac support is
+See
+<<
+ REQUIREMENTS
+>>
+for a list of required software. You don't need everything listed
+there. In particular, mp3, ogg vorbis and aac, ortp support is
optional. Autoconf will detect what is installed on your system
and will only try to build those executables that can be built with
your setup.
-Note that no special library (not even the mp3 decodong library libmad)
+Note that no special library (not even the mp3 decoding library libmad)
is needed for para_server if you only want to stream mp3 files.
Also, it's fine to use para_server on a box without sound card as
para_server only sends the audio stream to connected clients.
@@ -53,24 +56,25 @@ as user foo, and that you want to connect from client_host as user bar.
As foo@server_host, create ~/.paraslash/server.users by typing the
following commands:
+ user=bar
target=~/.paraslash/server.users
- key=~/.paraslash/key.pub.bar
+ key=~/.paraslash/key.pub.$user
perms=AFS_READ,AFS_WRITE,VSS_READ,VSS_WRITE
mkdir -p ~/.paraslash
- echo "user bar $key $perms" >> $target
+ echo "user $user $key $perms" >> $target
This gives "bar" the full privileges.
Change to the bar account on client_host and generate the key-pair
with the commands
- key=~/.paraslash/key.bar
+ key=~/.paraslash/key.$LOGNAME
mkdir -p ~/.paraslash
(umask 077 && openssl genrsa -out $key)
Next, extract its public part:
- pubkey=~/.paraslash/key.pub.bar
+ pubkey=~/.paraslash/key.pub.$LOGNAME
openssl rsa -in $key -pubout -out $pubkey
and copy the public key just created to server_host (you may
@@ -88,6 +92,14 @@ Finally, tell para_client to connect to server_host:
Start para_server
-----------------
+Before starting the server make sure you have write permissions to
+the directory /var/paraslash.
+
+ sudo chown $user /var/paraslash
+
+Alternatively, use the --afs_socket Option to specify a different
+location for the afs command socket.
+
For this first try, we'll use a debug level of two to make the
output of para_server more verbose.
@@ -136,8 +148,8 @@ Print a list of all audio files found with
Start streaming manually
------------------------
- para play
- para stat 2
+ para_client play
+ para_client stat 2
This starts streaming and dumps some information about the current
audio file to stdout.
@@ -194,7 +206,7 @@ socket is
/var/paraslash/audiod_socket.$HOSTNAME
-so the /var/paraslash directory should be owned by the user who
+so the /var/paraslash directory should be writable for the user who
runs para_audiod.
If you want to change the location of the socket, use the -s option
@@ -237,4 +249,7 @@ arbitrary commands. There are several flavours of key-bindings:
command>" instead of "".
This concludes the installation notes. Next thing you might to have a look
-at is how to use paraslash's audio file selector. See README.afs.
+at is how to use paraslash's audio file selector. See
+<<
+ README.afs
+>>