diff --git a/docs/site/vobox_container.md b/docs/site/vobox_container.md index 32a7c4e7f8b03b1fb5de01a5b8de13f0579bb7bd..052abce8bab66df02bd34a0d3ca0c8b2533978be 100644 --- a/docs/site/vobox_container.md +++ b/docs/site/vobox_container.md @@ -16,7 +16,7 @@ For the previous guide refer to the [this](../vobox_legacy) page. Create a new MACVLAN bridge with both IPv4 and IPv6 support, named __docknet__, using the following command: ```console -~# docker network create -d macvlan \ +# docker network create -d macvlan \ --subnet=137.138.47.192/26 \ --gateway=137.138.47.193 \ --ipv6 \ @@ -38,14 +38,14 @@ Create a new MACVLAN bridge with both IPv4 and IPv6 support, named __docknet__, | Scheduler | Command | |:----------|:--------| - | __HTCondor__ | ```~$ git clone https://gitlab.cern.ch/mstoretv/dockervobox.git``` | - | __ARC/Generic__ | ```~$ git clone https://gitlab.cern.ch/mstoretv/dockervobox_arc.git``` | + | __HTCondor__ | ```# git clone https://gitlab.cern.ch/mstoretv/dockervobox.git``` | + | __ARC/Generic__ | ```# git clone https://gitlab.cern.ch/mstoretv/dockervobox_arc.git``` | 2. Build container image using the following command: ```console - ~$ cd dockervobox - ~$ docker build -t voboximg . + # cd dockervobox + # docker build -t voboximg . ``` !!! warning @@ -54,7 +54,7 @@ Create a new MACVLAN bridge with both IPv4 and IPv6 support, named __docknet__, 3. Create and launch a new CentOS container connected to the MACVLAN bridge: ```console - ~$ docker run -d -v /cvmfs:/cvmfs \ + # docker run -d -v /cvmfs:/cvmfs \ -h myalienvo.cern.ch \ --name=myvocontainer \ --net=docknet \ @@ -79,17 +79,12 @@ Create a new MACVLAN bridge with both IPv4 and IPv6 support, named __docknet__, ## Service Management -All services are started automatically alongside the container. -If needed, you can also manage these manually by using the following syntax: +Almost all services are started automatically alongside the container. +If needed, you can manage most of them manually by standard Linux ```systemctl``` commands. +The exception is the proxy renewal daemon, which is managed as follows: ```console -~$ service yourservice {start|stop|restart|condrestart|try-restart|reload|force-reload|status} -``` - -As an example, the following command may be used to restart rsyslog: - -```console -~$ service rsyslog restart +# /services/alice-box-proxyrenewal {start|stop|restart|status|proxy} ``` !!! example "Example Deployment" @@ -99,7 +94,7 @@ As an example, the following command may be used to restart rsyslog: # /services/alice-box-proxyrenewal start < /dev/null # /usr/sbin/edg-mkgridmap --output=/etc/grid-security/grid-mapfile --safe ``` - 3. Adjust ```~/.alien/Environment``` as needed. + 3. Adjust ```~/.alien/Environment``` as needed (not for JAliEn). ## Useful Commands @@ -109,14 +104,14 @@ Refer to [command line Docker documentation](https://docs.docker.com/engine/refe | Command | Description | |:--------|:------------| -| ```~$ docker start myvocontainer``` | Start the container<br>Note: This way, the container will remain active until you type<br> ```~$ docker stop myvocontainer``` | -| ```~$ docker exec -it myvocontainer /bin/bash``` | Start a bash session within the container | -| ```~$ ssh root@your.ip.vobox.here``` | Login into the container | -| ```~$ docker ps``` | List active containers | -| ```~$ docker ps -a``` | List all containers | -| ```~$ docker images``` | List all images cached locally | -| ```~$ docker commit myvocontainer myvoimagename``` | Save container state as an image.<br> With __myimagename__ being the desired image name | -| ```~$ docker export mycontainer > /home/myexportcontainer.tar``` | Save the container as a tar file.<br>With __/home/myexportedcontainer.tar__ being the directory and name for the exported container | +| ```# docker start myvocontainer``` | Start the container<br>Note: This way, the container will remain active until you type<br> ```# docker stop myvocontainer``` | +| ```# docker exec -it myvocontainer /bin/bash``` | Start a bash session within the container | +| ```$ ssh root@your.ip.vobox.here``` | Login into the container | +| ```# docker ps``` | List active containers | +| ```# docker ps -a``` | List all containers | +| ```# docker images``` | List all images cached locally | +| ```# docker commit myvocontainer myvoimagename``` | Save container state as an image.<br> With __myimagename__ being the desired image name | +| ```# docker export mycontainer > /home/myexportcontainer.tar``` | Save the container as a tar file.<br>With __/home/myexportedcontainer.tar__ being the directory and name for the exported container | ??? help "Docker commit vs export" The ```commit``` command will save the container as an image in Docker's internal format.