| 1 | - requirements |
|---|
| 2 | - CentOS 6 |
|---|
| 3 | - outgoing internet access (port 80) |
|---|
| 4 | - Forge svn repository access |
|---|
| 5 | - Broker installation procedure (as root) |
|---|
| 6 | - check if EPEL repository is configured, if not, do steps below |
|---|
| 7 | - for CENTOS 6 |
|---|
| 8 | (from http://www.tecmint.com/how-to-enable-epel-repository-for-rhel-centos-6-5/) |
|---|
| 9 | - wget http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm |
|---|
| 10 | - rpm -ivh epel-release-6-8.noarch.rpm |
|---|
| 11 | - add user in /etc/passwd |
|---|
| 12 | - adduser -m -d /home/csbroker -s /sbin/nologin csbroker |
|---|
| 13 | - note |
|---|
| 14 | - csbroker stands for "Climate Simulation broker" |
|---|
| 15 | - RabbitMQ server |
|---|
| 16 | yum install nc |
|---|
| 17 | yum install erlang.x86_64 |
|---|
| 18 | yum install libxslt-devel.x86_64 |
|---|
| 19 | yum install libxslt.x86_64 |
|---|
| 20 | yum install xmlto.x86_64 |
|---|
| 21 | cd /opt |
|---|
| 22 | mkdir -p src |
|---|
| 23 | cd src |
|---|
| 24 | # rabbitmq install |
|---|
| 25 | cd /opt/src |
|---|
| 26 | wget http://www.rabbitmq.com/releases/rabbitmq-server/v3.0.2/rabbitmq-server-3.0.2.tar.gz |
|---|
| 27 | tar xzvf rabbitmq-server-3.0.2.tar.gz |
|---|
| 28 | rm rabbitmq-server-3.0.2.tar.gz |
|---|
| 29 | cd rabbitmq-server-3.0.2/ |
|---|
| 30 | export TARGET_DIR=/opt/rabbitmq-server-3.0.2 |
|---|
| 31 | export SBIN_DIR=/opt/rabbitmq-server-3.0.2/sbin |
|---|
| 32 | export MAN_DIR=/opt/rabbitmq-server-3.0.2/man |
|---|
| 33 | make |
|---|
| 34 | make install |
|---|
| 35 | - optional console admin tools (http://www.rabbitmq.com/management-cli.html) |
|---|
| 36 | - wget http://hg.rabbitmq.com/rabbitmq-management/raw-file/rabbitmq_v3_0_2/bin/rabbitmqadmin |
|---|
| 37 | - mv -i rabbitmqadmin /usr/sbin |
|---|
| 38 | - chmod +x /usr/sbin/rabbitmqadmin |
|---|
| 39 | - change owner (to run rabbitmq as non-root) |
|---|
| 40 | - chown -R csbroker /var/log/rabbitmq |
|---|
| 41 | - chown -R csbroker /var/lib/rabbitmq |
|---|
| 42 | - install startup file in /etc/init.d |
|---|
| 43 | <--- |
|---|
| 44 | #!/bin/bash |
|---|
| 45 | # chkconfig: 2345 20 80 |
|---|
| 46 | # description: AMQP service |
|---|
| 47 | |
|---|
| 48 | RABBITMQ_SBIN=/opt/rabbitmq-server-3.0.2/sbin |
|---|
| 49 | |
|---|
| 50 | case "$1" in |
|---|
| 51 | start) |
|---|
| 52 | sudo -H -u csbroker -- $RABBITMQ_SBIN/rabbitmq-server -detached |
|---|
| 53 | ;; |
|---|
| 54 | stop) |
|---|
| 55 | sudo -H -u csbroker $RABBITMQ_SBIN/rabbitmqctl stop |
|---|
| 56 | ;; |
|---|
| 57 | status) |
|---|
| 58 | sudo -H -u csbroker $RABBITMQ_SBIN/rabbitmqctl status |
|---|
| 59 | ;; |
|---|
| 60 | *) |
|---|
| 61 | echo $"Usage: $0 {start|stop}" |
|---|
| 62 | esac |
|---|
| 63 | |
|---|
| 64 | exit 0 |
|---|
| 65 | ---> |
|---|
| 66 | - chmod +x /etc/init.d/rabbitmq |
|---|
| 67 | - create startup symlinks with command below |
|---|
| 68 | - chkconfig --add rabbitmq |
|---|
| 69 | - conf |
|---|
| 70 | - vi /opt/rabbitmq-server-3.0.2/sbin/rabbitmq-defaults |
|---|
| 71 | - as default disk size is too high for VESG4 VM, do that |
|---|
| 72 | - edit rabbit config file so result looks like this: |
|---|
| 73 | $ cat /etc/rabbitmq/rabbitmq.config |
|---|
| 74 | [ |
|---|
| 75 | {rabbit, [{disk_free_limit, {mem_relative, 0.1}}]} |
|---|
| 76 | ]. |
|---|
| 77 | - |
|---|
| 78 | - |
|---|
| 79 | - $RABBITMQ_HOME/etc/rabbitmq/rabbitmq-env.conf |
|---|
| 80 | - $RABBITMQ_HOME/etc/rabbitmq/rabbitmq.config |
|---|
| 81 | - note that neither of these files exist after installation |
|---|
| 82 | i.e. you need to create them |
|---|
| 83 | - |
|---|
| 84 | log : /var/log/rabbitmq/rabbit.log |
|---|
| 85 | sasl log : /var/log/rabbitmq/rabbit-sasl.log |
|---|
| 86 | database dir: /var/lib/rabbitmq/mnesia/rabbit |
|---|
| 87 | - usage |
|---|
| 88 | - to start the daemon, run command below (as root) |
|---|
| 89 | - /etc/init.d/rabbitmq start |
|---|
| 90 | - note |
|---|
| 91 | - the warning message below is normal |
|---|
| 92 | - Warning: PID file not written; -detached was passed. |
|---|
| 93 | - to stop the daemon, use |
|---|
| 94 | - /etc/init.d/rabbitmq stop |
|---|
| 95 | - note |
|---|
| 96 | - it's normal to have the erlang process below running after stop (it's an erlang generic registry stuff) |
|---|
| 97 | - 31691 ? S 0:00 /usr/lib64/erlang/erts-5.8.5/bin/epmd -daemon |
|---|
| 98 | - test |
|---|
| 99 | - connectivity test |
|---|
| 100 | - telnet localhost 5672 |
|---|
| 101 | - telnet cstest-broker.ipsl.jussieu.fr 5672 |
|---|
| 102 | - operation |
|---|
| 103 | - to print RabbitMQ status, use |
|---|
| 104 | - ./rabbitmqctl report |
|---|
| 105 | - to print RabbitMQ queues, use: |
|---|
| 106 | - ./rabbitmqctl list_queues |
|---|
| 107 | - optional |
|---|
| 108 | - ./rabbitmqadmin list queues |
|---|
| 109 | # vim: set ts=4: |
|---|
