Changes between Version 1 and Version 2 of installation_QCG_Notification

Show
Ignore:
Timestamp:
05/17/11 10:52:51 (13 years ago)
Author:
bartek
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • installation_QCG_Notification

    v1 v2  
    11= QCG Notification Installation = 
    2 Within QosCosGrid the QCG Notification service is used for brokering notification messages about the job state changes. All instances of the QCG BES/AR services acts as the information ''Producers'' while the QCG Broker as the ''Consumer''. In most cases it is enough that only one instance of the QCG Notification is deployed per Administrative Domain (i.e.: not necessary one per Cluster). 
     2Within !QosCosGrid the QCG Notification service is used for brokering notification messages about the job state changes. All instances of the QCG BES/AR services acts as the information ''Producers'' while the QCG Broker as the ''Consumer''. In most cases it is enough that only one instance of the QCG Notification is deployed per Administrative Domain (i.e.: not necessary one per Cluster). 
    33 
    4 =Installation= 
    5 Similar to the SMOA Computing the [http://fury.man.poznan.pl/smoa-downloads/smoa-ntf/smoa-ntf-latest.tar.gz  SMOA Notification] requires the [[SMOA_Computing#SMOA_Core_library| SMOA Core library]] to be installed. If this prerequisite is fulfilled the SMOA Notification installation can be done in a  few simple steps: 
     4'''Note:''' The implementation name of the QCG Notification service is '''Smoa Notification''' and this name is used as a common in this guide. 
     5 
     6= Installation = 
     7Similar to the Smoa Computing (QCG BES/AR) service the [[http://fury.man.poznan.pl/smoa-downloads/smoa-ntf/smoa-ntf-latest.tar.gz|Smoa Notification]] requires the [[installation_QCG_BES_AR#SMOACorelibrary|Smoa Core library]] to be installed. If this prerequisite is fulfilled the Smoa Notification installation can be done in a  few simple steps: 
     8{{{ 
     9#!div style="font-size: 90%" 
     10{{{#!sh 
    611  $ tar xf smoa-ntf-latest.tar 
    712  $ cd smoa-ntf-1.1.2 
    … …  
    914  $ make 
    1015  $ sudo make install 
     16}}} 
     17}}} 
     18= Configuration = 
     19Before you start you need to create a new system user (e.g. `smoa_ntf`) that will be used to start the service: 
     20{{{ 
     21#!div style="font-size: 90%" 
     22{{{#!sh 
     23 # useradd -d  /opt/QCG/smoa/var/log/smoa-ntf/ -M  smoa_ntf 
     24}}} 
     25}}} 
     26Give the `smoa_ntf` user ownership of the log directory: 
     27{{{ 
     28#!div style="font-size: 90%" 
     29{{{#!sh 
     30 # chown smoa_ntf /opt/QCG/smoa/var/log/smoa-ntf/ 
     31}}} 
     32}}} 
     33== Service configuration == 
     34Minimal configuration requires only the host and port to be changed in the main service configuration file: `PREFIX/etc/smoa-ntfd.xml`. The complete configuration guide can be found in the `PREFIX/share/smoa-ntf/doc/` directory.  
    1135 
    12 =Configuration= 
    13 Before you start create a new system user (e.g. smoa_ntf) that will be used to start the service: 
    14  # useradd -d  /opt/QCG/smoa/var/log/smoa-ntf/ -M  smoa_ntf 
    15 Give the <code>smoa_ntf</code> user ownership of the log directory: 
    16  # chown smoa_ntf /opt/QCG/smoa/var/log/smoa-ntf/ 
     36= Starting the service = 
     37As the `smoa_ntf` user  type: 
     38{{{ 
     39#!div style="font-size: 90%" 
     40{{{#!sh 
     41  $ /opt/QCG/smoa/sbin/smoa-ntfd 
     42}}} 
     43}}} 
     44or if you want the service not to daemonize and print all logs to console type: 
     45{{{ 
     46#!div style="font-size: 90%" 
     47{{{#!sh 
     48 $ /opt/QCG/smoa/sbin/smoa-ntfd -d 
     49}}} 
     50}}} 
     51otherwise the logs can be found in `/opt/QCG/smoa/var/log/smoa-ntf/smoa-ntfd.log`. 
    1752 
    18 ==Service configuration== 
    19 Minimal configuration requires only the host and port to be changed in the main service configuration file: <tt>PREFIX/etc/smoa-ntfd.xml</tt> (The complete configuration guide can be found in the <tt>doc/</tt> directory). After finishing the SMOA Notification configuration you must edit the [[SMOA_Computing#Service%20configuration|SMOA Computing service configuration file]] again and update the content of the <code><ServiceURL></code> elements (in ''<Module xsi:type="smc:notification_wsa">'' section). For e.g if in the  <tt>PREFIX/etc/smoa-ntfd.xml</tt> one can find  <tt><Host>example.com<Host></tt> and <tt><Port>19005<Port></tt> the <code><ServiceURL></code> must be set to http://example.com:19005/ .  
     53= Stopping the service = 
     54The service is stopped by sending `SIGTERM` signal, e.g.: 
     55{{{ 
     56#!div style="font-size: 90%" 
     57{{{#!sh 
     58  $ pkill smoa-ntfd 
     59}}} 
     60}}} 
     61= Verifying the installation = 
    2062 
    21 {{Note}} You must restart the SMOA Computing service after updating the <code>smoa-compd.xml</code> configuration file. 
     63= Smoa Computing (QCG BES/AR) configuration = 
     64After finishing the Smoa Notification configuration you must edit the [[installation_QCG_BES_AR#Serviceconfiguration|Smoa Computing service configuration file]] again and update the content of the `<ServiceURL>` elements (in `<Module xsi:type="smc:notification_wsa">` section). For e.g if in the  `PREFIX/etc/smoa-ntfd.xml` one can find  `<Host>example.com<Host>` and `<Port>19005<Port>` the `<ServiceURL>` must be set to `http://example.com:19005/`.  
    2265 
    23 =Starting the service= 
    24 As the <code>smoa_ntf</code> user  type: 
    25   $ /opt/QCG/smoa/sbin/smoa-ntfd 
     66'''Note:''' You must restart the Smoa Computing service after updating the `smoa-compd.xml` configuration file. 
    2667 
    27 or if you want the service not to daemonize and print all logs to console type: 
    28  
    29  $ /opt/QCG/smoa/sbin/smoa-ntfd -d 
    30  
    31 otherwise the logs can be found in <code>/opt/QCG/smoa/var/log/smoa-ntf/smoa-ntfd.log</code>. 
    32  
    33 =Stopping the service= 
    34 The service is stopped by sending SIGTERM signal, e.g.: 
    35   $ pkill smoa-ntfd 
    36  
    37 =Verifying the installation= 
    38 After starting the SMOA Notification service and updating the SMOA Computing configuration try to submit a simple job and check the SMOA Computing log file to see if there are now any error messages on sending notifications, e.g.: 
     68When you start the Smoa Notification service and update the SMOA Computing configuration try to submit a simple job and check the Smoa Computing log file to see if there are now any error messages on sending notifications, e.g.: 
     69{{{ 
     70#!div style="font-size: 90%" 
     71{{{#!sh 
    3972 $ tail -f /opt/QCG/smoa/var/log/smoa-comp/smoa-comp.log 
    4073 INF Sep 17 16:15:01 24201 0x44b22940 [notification_ws] Sending notify message (topic = ActivityState/TerminalState/Finished, activity_id = 0544b24a-e960-400e-4910-f1a893632610, status = Finished) 
     74}}} 
     75}}}