# OpenStack Services

Documentation for INCD Services available for users

# INDICO - events management tool

[INDICO](https://getindico.io) is a open-source tool for events management. It was developed at [CERN (European Organization for Nuclear Research)](https://home.cern/) and is developed in python with postgres database.

For more information about INDICO see the reference links:
- [INDICO web page](https://getindico.io/)
- [Installation Guides](https://docs.getindico.io/en/stable/installation)


INCD provides INDICO as a service through the INCD Openstack cloud service.


## Available Images
To instantiate an instance of Indico, users just need to create a new instance using one of the available images with the name __INCD_Base-INDICO-x.x.x__, where x.x.x is the version of INDICO available in that image.

## Setup INDICO
After instantiating a machine with INDICO, the following configuration steps nust be performed:

1. Access the instance and grant root access:

````

[user@local: ~]$ ssh centos@INSTANCE_IP

[centos@local: ~]$ sudo -i

[root@local: ~]$
````


2.  Update HTTPD (Apache), replace "YOURHOSTNAME" to your domain in the config files:
````

[root@local: ~]$ vi /etc/httpd/conf.d/indico.conf 

[root@local: ~]$ vi /etc/httpd/conf.d/indico-sslredir.conf 
````

3. Install the certificate and private key in PKCS12 format at the path and keep the permissions as listed
````

[root@local: ~]$ cd /etc/ssl/indico

[root@local indico]# ls -la
total 8
drwx------  2 root root   42 Oct 29 13:21 .
drwxr-xr-x. 3 root root   33 Oct 29 13:21 ..
-rw-r--r--  1 root root 1830 Oct 29 13:21 indico.crt
-rw-------  1 root root 3268 Oct 29 13:21 indico.key

````


4. Update INDICO with your settings, replace "YOURHOSTNAME" with your domain, and setup the mail support in the config file
````

[root@local: ~]$ vi /opt/indico/etc/indico.conf 

# General settings
BASE_URL = 'https://YOURHOSTNAME'

# Email settings
SMTP_SERVER = ('smtp.xpto.pt', 25)
SMTP_USE_TLS = False
SMTP_LOGIN = ''
SMTP_PASSWORD = ''
SUPPORT_EMAIL = 'support@xpto.pt'
PUBLIC_SUPPORT_EMAIL = 'public.support@xpto.pt'
NO_REPLY_EMAIL = 'noreply@xpto.pt'
````
5. Restart service
````
[root@local: ~]$ systemctl restart uwsgi.service httpd.service indico-celery.service
````

6. Setup the ADMIN account by logging in via web
````
https://YOURHOSTNAME
````
[![indico_startup.png](https://wiki.incd.pt/uploads/images/gallery/2019-10/scaled-1680-/indico_startup.png)](https://wiki.incd.pt/uploads/images/gallery/2019-10/indico_startup.png)