README.md 2.02 KB
Newer Older
1
2
3
FTS3-REST
=========
This is the FTS3 RESTful API.
Alejandro Álvarez Ayllón's avatar
Alejandro Álvarez Ayllón committed
4
For more detailed information about installation, usage, etc... please, check the [docs](docs/README.md) subdirectory.
Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
5

Maria Arsuaga Rios's avatar
Maria Arsuaga Rios committed
6
7
## Firewalld: How to set up a firewall using firewalld on centos7

Andrea Manzi's avatar
Andrea Manzi committed
8
In order to setup the firewalld support for FTS REST you need to install the fts-rest-firewalld package.
9

Maria Arsuaga Rios's avatar
Maria Arsuaga Rios committed
10
When running fts-rest, we can allow this traffic for interfaces in our "public" zone for this session by typing:
11

Maria Arsuaga Rios's avatar
Maria Arsuaga Rios committed
12
    sudo firewall-cmd --zone=public --add-service=fts3rest
13
14
15
16
17
18

You can leave out the --zone= if you wish to modify the default zone. We can verify the operation was successful by using the --list-all or --list-services operations:

    sudo firewall-cmd --zone=public --list-services


Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
19
20
21
22
## Vagrant
This repository contains a [Vagrantfile](https://www.vagrantup.com/) to make easier to develop.
Please, check [Vagran't install documentation](https://www.vagrantup.com/docs/installation/) to see how to get it
for your platform.
23

Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
24
25
26
27
28
Once you have Vagrant on your machine, just type `vagrant up` and you will have a running fts-rest instance on
your machine. The server's port 8446 will be forwarded to the host, so you will be able to access using
`https://localhost:8446`. Mind that it will use at first a self-signed certificate. If you want a real certificate,
you will have to override the files `hostcert.pem` and `hostkey.pem` inside `/etc/grid-security` on the Vagrant
virtual machine.
29

Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
30
31
To get the server to talk to the rest of an FTS3 system, you will need to copy the file `/etc/fts3/fts3config`
from the FTS3 node, to your Vagrant VM, and restart `httpd`.
32

Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
33
## Contacts
34
35
36
37
38
39
40
41
42
43
44
45
46
If you want to be informed about the FTS3 service in general, including documentation, guies,
new releases, bugfixes, etc.

<http://fts3-service.web.cern.ch/>

If you want to check the roadmap, pending issues, incoming features:

<https://its.cern.ch/jira/browse/FTS/component/12303>

If you want to report a bug, request new functionality, or ask for support:

<mailto:fts-devel@cern.ch>

Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
47
## Licensing
48
Please see the file called LICENSE.
Alejandro Alvarez Ayllon's avatar
Alejandro Alvarez Ayllon committed
49