zerosap v1.0.1

zerosap

Library to call SAP pyRFC from NodeJs

Dispatcher API

Using this module, NodeJS can dispatch RFC calls to a SAP backend system.

More API Documentation coming soon. Meanwhile, look at app.js .

Worker

Zerosap uses the official SAP pyRFC python library, and wraps it as the "Zerosap Worker".
As a first-class library fully supported by SAP, pyRFC ensures that Zerosap has great stability and full capabilities (e.g. RFC server scenario).

We support two ways of running this worker:

A. Embedded into NodeJs

• NodeJs automatically manages the Python worker process via a zerorpc bridge.
• This scenario is great for getting started.

B. Remote Daemon

• A "Zerosap Worker" runs as a daemon on a Python-capable host within the internal network/LAN.

• The host can be the UNIX/Windows server that also hosts SAP Netweaver itself (or another host that have access to the RFC Ports of the target SAP system).

• The Worker connects back to the NodeJS Dispatcher to receive instructions via a secure zerorpc channel.

• Multiple Worker instances enable NodeJS to act as a reverse proxy and load balancer, as RFC requests are fanned out from NodeJS to multiple target SAP backend systems.
• Elliptic-curve cryptography is used.
• This scenario is great where security and performance is paramount.

Dependencies

• libzmq.so >= 4.0.5 (with libsodium support)
• zerorpc >= 0.4.4
• pyrfc >= 1.9.4
• daemonize >= 2.3.1

Installation

ZeroRPC Installation

Libsodium

• Reference
• Tarball

	wget https://github.com/jedisct1/libsodium/releases/download/1.0.1/libsodium-1.0.1.tar.gz
	dig +dnssec +short txt libsodium-1.0.1.tar.gz.download.libsodium.org
	cat libsodium-1.0.1.tar.gz | openssl dgst -sha256  # If the output is not the same as from the previous command, abort as the downloaded file has been tampered with.
	tar -xvf libsodium-1.0.1.tar.gz
	cd libsodium-1.0.1
	./configure
	make && make check  # Ensure all tests pass.
	sudo make install
	ls /usr/local/lib/

ZeroMQ

• Reference

	wget http://download.zeromq.org/zeromq-4.0.5.tar.gz
	tar -xvf zeromq-4.0.5.tar.gz
	cd zeromq-4.0.5
	sudo yum install gcc-c++
	./configure
	make && make check  # Ensure all tests pass.
	sudo make install
	ls /usr/local/lib/

ZeroRPC for Python

• ZeroRPC cannot be installed directly via pip / easy_install due to pyzmq that is pinned to an outdated version (version 14.1.1 & above has solved the issue).
• These instructions will install directly from their GitHub master (for libsodium cryptographic support):

	wget https://github.com/dotcloud/zerorpc-python/archive/master.zip
	unzip master.zip
	cd zerorpc-python-master/
	nano setup.py   # Change to pyzmq>=14.1.1
	PKG_CONFIG_PATH=/usr/local/lib/pkgconfig python setup.py install

pyRFC Installation

• Installing pyrfc requires the SAP NW RFC SDK that is distributed on the SAP Support Portal.
• Further instructions here.
• Downloads

	wget https://raw.githubusercontent.com/SAP/PyRFC/master/dist/pyrfc-1.9.4-py2.7-linux-x86_64.egg
	easy_install pyrfc-1.9.4-py2.7-linux-x86_64.egg

Daemonize Instalation

• The easiest to install.

	pip install daemonize

Configuration

The zerosap worker reads environmental variables for configuration:

start.sh

	#!/bin/bash
	DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
	cd "${DIR}"

	# source /opt/rh/python27/enable
	PARAMS=$@ scl enable python27 - << \EOF

	source bin/activate

	export USER=zerosap
	export GROUP=zerosap 
	export ZEROSAP_ZMQ_HUB=tcp://<ipaddress of nodejs zerosap-dispatcher>:4801

	cd zerosap/
	ZEROSAP_RFC_CLIENT=100 ZEROSAP_RFC_USER=<username> ZEROSAP_RFC_PASSWD=<password> python bin/zerosap.py ${PARAMS}

	EOF

Startup

• Starting the zerosap worker daemon is simple:

	sudo useradd -r zerosap
	sudo usermod -a -G zerosap prdadm
	
	chmod +x /usr/sap/PythonVE/py27-pyrfc/start.sh
	sudo /usr/sap/PythonVE/py27-pyrfc/start.sh
	tail -f /tmp/zerosap.log