Skip to Content.
Sympa Menu

Configure HTTP server: Running separate FastCGI service

Requirements

General instruction

First, install WWSympa FCGI service. And then configure HTTP server if necessary.

Install WWSympa FCGI service

Systemd


Notes:


  1. Register WWSympa FastCGI service.

    Put wwsympa.service file into Systemd system directory (such as /usr/lib/systemd/system).

    • With binary distributions, wwsympa.service file may have already been installed, if that package supports Systemd.


      Note:

      • Some binary distributions ship configuration ready to edit:

        • With RPM (RHEL/CentOS 7) this file is prepared by sympa-httpd or sympa-nginx package.

    • If you have installed Sympa from source, and you have given --with-unitsdir=DIR option to configure script, you may find a file wwsympa-spawn-fcgi.service in service subdirectory of source tree. Use it as wwsympa.service (however also check the notes below).


      Note:

      • On Sympa prior to 6.2.70, you may find a file wwsympa.service in src/etc/script subdirectory of source tree.

      • Additinally, on Sympa prior to 6.2.36, you may find a file nginx-wwsympa.service. Use it as wwsympa.service.


    Whichever web server you use, the distributed service file will work. The only thing to take care of is the user defined by the -U option in FCGI_OPTS:

    FCGI_OPTS="-M 0600 -U apache"
    

    The value of this parameter (‘apache’ in the example) must be set to the username used by your web server (www-data for Apache HTTP Server in Debian, nginx for nginx on most of distributions, etc.)

    You can keep this parameter by adding the line above to a file /etc/sysconfig/sympa.


    Note:

    • You can also serve Sympa SOAP interface with this method. Follow the same instructions but with sympasoap-spawn-fcgi.service (or sympasoap.service, nginx-sympasoap.service) file.

  2. Start WWSympa FastCGI service.
    # systemctl start wwsympa.service
    # systemctl status wwsympa.service
    
  3. Activate WWSympa FastCGI service.
    # systemctl enable wwsympa.service
    

FreeBSD ports/package

  1. Configure and activate the spawn-fcgi service (Note: Replace $EXECCGIDIR and $PIDDIR below):
    # sysrc spawn_fcgi_enable="YES"
    # sysrc spawn_fcgi_app="/usr/local/bin/perl"
    # sysrc spawn_fcgi_app_args="$EXECCGIDIR/wwsympa.fcgi"
    # sysrc spawn_fcgi_bindsocket="$PIDDIR/wwsympa.socket"
    # sysrc spawn_fcgi_bindsocket_mode="0600 -U www"
    # sysrc spawn_fcgi_username="sympa"
    # sysrc spawn_fcgi_groupname"sympa"
    

    Note:

    • If you also want to serve Sympa SOAP interface with this method, you may have to write an rc script to start another spawn-fcgi service. Contribution by readers will be appreciated.

  2. Start WWSympa FastCGI service.
    # /usr/local/etc/rc.d/spawn-fcgi start
    

System V init script

  1. If your system supports system V init script, edit example init script as you prefer, and copy it to system V init directory (such as /etc/rc.d/init.d) as the wwsympa file.


    Note:

    • You can also serve Sympa SOAP interface with this method. Follow the same instructions but with this example init script. Copy it as the sympasoap file.

  2. Start WWSympa FastCGI service.
    # service wwsympa start
    # service wwsympa status
    
  3. Activate WWSympa FastCGI service.
    # chkconfig wwsympa on
    

Setup HTTP server

Proceed to Setup HTTP server as FastCGI proxy.

Top of Page