This page is intended to provide technical informations hopefully useful for anybody in charge of running the yafits containers. The commands indicated below were run under SL Linux. Feel free to introduce examples of commands used on different flavours of Linux or on Mac OSX where it's relevant.
# Prerequisites
You have cloned/downloaded the `yafits` project and you can run the `docker-compose` command
# Starting docker daemon (possibly)
### Manually on demand
Before trying to launch any container, it's advised to ensure that the docker daemon is running. E.g. it may happen that the daemon has not been registered to be launched during a (re)boot sequence.
```plaintext
ps aux|grep dockerd
```
If the above command returns nothing then start a session on an account belonging to sudoers and start the daemon. Example :
```plaintext
[caillat-adm@juliette ~]$ sudo service docker start
[sudo] Mot de passe de caillat-adm :
Redirecting to /bin/systemctl start docker.service
## Having `jupyterhub` active concurrently with `docker` on `romeo`
By default `jupyterhub`'s proxy uses the port 8000 which the port used by `docker`'s. See below a way to have `jupyterhub`'s proxy using a different port ( e.g. 8500 ) :
* In `jupyterhub`'s account on `romeo` ( username : jupyterhub, password: askme) edit the file `jupyterhub_config.py` in the home directory and type `c.JupyterHub.bind_url = 'http://:8500'` at line 94
* Start `jupyterhub`. In the same account type `nohup jupyterhub &` . Be careful that a `nohup.out` file logging the activity is going to grow.
* As root or from a sudo enabled account open the port 8500 once forever :
At this point you should be able to access `jupyterhub` on `romeo` via the link <https://romeo.obspm.fr:8500>
# Link between romeo and juliette
There is a dedicated ethernet card to create the link between the two machines.
If it is not mounted on juliette after a reboot :
**as root** or **sudo** on juliette
nmcli connection up em2 # romeo
nmcli connection up em3 # benvolio
Then call automount command as root on romeo or benvolio
If romeo or benvolio is shut down while juliette stays up, the connection must be restarted
em2 is the name of the card on juliette (p7p2 on romeo)
automount is enabled, it is configured in :
- /etc/auto.master
- /etc/auto.datartemix
- /etc/auto.datartemix2
# Hardware configuration
This section describes the network, storage and computing resources dedicated to ARTEMIX and YAFITS on their development site i.e. the LERMA/Observatoire de Paris.
## juliette\[.obspm.fr\]
The host for artemix ( artemix.obspm.fr ) and yafits ( artemix.obspm.fr/fits ).
Both the artemix.obspm.fr and yafits.obspm.fr domains are accessed through the vm-weblerma.obspm.fr proxy server. More generally, all the artemix related services are proxied this way (almastaging, almaspectro, dev-artemix, dev2-artemix).
This configuration can be modified in the netmagis service provided by the DIO (netmagis.obspm.fr).
Access restrictions are applied to "restricted" and "RRL" data directories. The configuration is done directly in the vhost configuration file of the proxy server.
# House cleaning
The execution of YAFITS servers generates a lot of temporary files amongst which are the FITS files generated a
to add the port 3023 and have it available immediately.
# Monitoring activity
Yafits provides a page that summarizes the current status of the application ( loaded files, used memory ).
It is available at the address :
http://yafitshome/monitor
# yafitss documentation
It is available at $SERVER_URL:5252/apidoc/index.html
* 5252 is the port number at which yafitss is visible (can be changed)
* apidoc prefix is a reference to the tool uses to generate the documentation. Its activation can be found in yafitss's Dockerfile :
```
# Generate the bottle server documentation
WORKDIR /home/partemix/yafitss
RUN apidoc -f serverWsgi.py -o /home/partemix/dataroot/apidoc
\[\[_TOC_\]\]
This page is intended to provide technical informations hopefully useful for anybody in charge of running the yafits containers. The commands indicated below were run under SL Linux. Feel free to introduce examples of commands used on different flavours of Linux or on Mac OSX where it's relevant.
# Prerequisites
You have cloned/downloaded the `yafits` project and you can run the `docker-compose` command
# Starting docker daemon (possibly)
### Manually on demand
Before trying to launch any container, it's advised to ensure that the docker daemon is running. E.g. it may happen that the daemon has not been registered to be launched during a (re)boot sequence.
```plaintext
ps aux|grep dockerd
```
If the above command returns nothing then start a session on an account belonging to sudoers and start the daemon. Example :
```plaintext
[caillat-adm@juliette ~]$ sudo service docker start
[sudo] Mot de passe de caillat-adm :
Redirecting to /bin/systemctl start docker.service
## Having `jupyterhub` active concurrently with `docker` on `romeo`
By default `jupyterhub`'s proxy uses the port 8000 which the port used by `docker`'s. See below a way to have `jupyterhub`'s proxy using a different port ( e.g. 8500 ) :
* In `jupyterhub`'s account on `romeo` ( username : jupyterhub, password: askme) edit the file `jupyterhub_config.py` in the home directory and type `c.JupyterHub.bind_url = 'http://:8500'` at line 94
* Start `jupyterhub`. In the same account type `nohup jupyterhub &` . Be careful that a `nohup.out` file logging the activity is going to grow.
* As root or from a sudo enabled account open the port 8500 once forever :
At this point you should be able to access `jupyterhub` on `romeo` via the link <https://romeo.obspm.fr:8500>
# Link between romeo and juliette
There is a dedicated ethernet card to create the link between the two machines.
If it is not mounted on juliette after a reboot :
**as root** or **sudo** on juliette
nmcli connection up em2 # romeo
nmcli connection up em3 # benvolio
Then call automount command as root on romeo or benvolio
If romeo or benvolio is shut down while juliette stays up, the connection must be restarted
em2 is the name of the card on juliette (p7p2 on romeo)
automount is enabled, it is configured in :
- /etc/auto.master
- /etc/auto.datartemix
- /etc/auto.datartemix2
# Hardware configuration
This section describes the network, storage and computing resources dedicated to ARTEMIX and YAFITS on their development site i.e. the LERMA/Observatoire de Paris.
## juliette\[.obspm.fr\]
The host for artemix ( artemix.obspm.fr ) and yafits ( artemix.obspm.fr/fits ).
Both the artemix.obspm.fr and yafits.obspm.fr domains are accessed through the vm-weblerma.obspm.fr proxy server. More generally, all the artemix related services are proxied this way (almastaging, almaspectro, dev-artemix, dev2-artemix).
This configuration can be modified in the netmagis service provided by the DIO (netmagis.obspm.fr).
Access restrictions are applied to "restricted" and "RRL" data directories. The configuration is done directly in the vhost configuration file of the proxy server.
# House cleaning
The execution of YAFITS servers generates a lot of temporary files amongst which are the FITS files generated a
