How to set up UCA LINK server

HOW TO SET UP YOU OWN UCA LINK SERVER

This thread is about how to set up a UCA link server. UCA link servers can be considered as nodes that help spreading transaction knowledge by automating the sync process.

STEP 1 : UNPACK THE SOURCES

The whole solution is build on D. J. Bernstein’s ucspi-tcpserver (see http://cr.yp.to/ucspi-tcp.html). There are several ways to get it run. While you can make your own Build we have simply installed the ucspi-tcp-ipv6 debian package using the install_server.sh script.

Extract the server components using tar:

tar -xvf server.tar

The following files will be extracted:

control/server.conf
control/server_install.dep
controller.sh
filewatch.sh
install_server.sh
logwatch.sh
receiver.sh
sender.sh
start_server.sh
stop_server.sh
uca.service

Also the folders /log/ and /server/ have been extracted. The folder /log/ is where the server will write the logfiles to. In the folder /server/ the tempfiles of the server are being stored.

STEP 2 : INSTALL THE SERVER COMPONENTS

Run the script install_server.sh (you may use sudo in front):

./install_server.sh

STEP 3 : CUSTOMIZE THE SERVER

Modfiy the file control/server.conf . At least you have to enter your IP-Adress and the logon credentials (username, PIN, password) of the user that should be used by the server.

STEP 4 : PUBLISH YOUR UCA LINK SERVER DETAILS

Add a line to uca.conf file in the /control/ folder. The file is a comma separated file (csv) .
The format of the file should be:

IP_OR_URL,SEND_PORT,RECEIVE_PORT,DESCRIPTION,

like e.g.:

127.0.0.1,15000,15001,CUSTOM SERVER,

Send this to your friends and the people that you want to use your server. You could also publish the details in this Forum or somewhere else on the web.

STEP 5 : START THE SERVER

You start the server by running the start_server.sh script:

./start_server.sh

The script will start controller.sh that acts as daemon running and monitoring the scriptssender.sh, receiver.sh, filewatch.sh and logwatch.sh in the background. People can now automatically sync with you by using the UCA link functionality.

STEP 6 : STOP THE SERVER

You stop the server by running the stop_server.sh script:

./stop_server.sh