Install

Bots works on operating systems with python installed. Confirmed is:

  • windows (windows10, XP, Vista, windows7, Server 2008, Server 2012, etc)
  • apple OS.X
  • linux debian (ubuntu, mint, etc)
  • linux Red hat (Centos. Fedora)
  • OpenSolaris
  • FreeBSD
  • AIX

Windows using bots installer

  1. Install Python
    1. Check if Python is already installed.
    2. Use python 2.7; Python >= 3.0 does not work.
    3. Download Python installer.
    4. Install python (double-click).
  2. Install bots
    1. Download bots installer.
    2. Install bots (double-click).
    3. Installation takes some time; be patient. During the installation the libraries bots needs are installed.
    4. You will be notified if the installation went OK.
    5. If not: contact is via the mailing list.

Note

  1. Mind your rights. Both Python and Bots need to be installed as admin (windows vista/7/8/10).
  2. The windows installer includes libraries for standard installation. Additional libraries/ are needed for eg. SFTP, web API. Best option for installation of additional libraries is using pip, see below.

Install using pip

$ sudo pip install 'django<1.8'
$ sudo pip install 'cherrypy<8.0'
$ sudo pip install genshi
$ wget -O bots-3.2.0.tar.gz http://sourceforge.net/projects/bots/files/bots%20open%20source%20edi%20software/3.2.0/bots-3.2.0.tar.gz/download
$ tar -xf bots-3.2.0.tar.gz
$ cd bots-3.2.0
$ sudo python setup.py install
$ cd ..
#set rigths for bots directory to non-root:
$ sudo chown -R myusername /usr/lib/python2.7/site-packages/bots

#start up bots-webserver:
$ bots-webserver.py

*nix installation

There is no *.deb or *.rpm for bots. So a standard python source code install is done.

  1. Install Python
    1. Check if Python is already installed - most of the time python is already installed on *nix. Use python 2.6 or 2.7. (not python >= 3.0).
    2. If not: use package manager or see python web site.
  2. Install dependencies/libraries
  3. Install bots
    1. Download bots installer (e.g. bots-3.1.0.tar.gz)
    2. Unpack (command-line): tar bots-3.1.0.tar.gz
    3. Go to created directory (command-line): cd bots-3.1.0
    4. Install (command-line): python setup.py install
    5. Postinstall: depending on what do want: change rights for directories botssys, usersys and config or place these elsewhere and make symbolic links in the bots installation directories.

Note

Change the owner/rights for directories botssys, usersys and config. Another option is to move these directois to other place and use symbolic links in bots isntallation.

Installation from scratch

Installation on amazon EC2, looks like red hat version of linux

#install django
$ wget -O django.tar.gz https://www.djangoproject.com/download/1.7.11/tarball/
$ tar -xf django.tar.gz
$ cd Django-1.7.11
$ sudo python setup.py install
$ cd ..
#install cherrypy
$ wget http://download.cherrypy.org/CherryPy/3.2.2/CherryPy-3.2.2.tar.gz
$ tar -xf CherryPy-3.2.2.tar.gz
$ cd CherryPy-3.2.2
$ sudo python setup.py install
$ cd ..
#install Genshi
$ wget http://ftp.edgewall.com/pub/genshi/Genshi-0.7.tar.gz
$ tar -xf Genshi-0.7.tar.gz
$ cd Genshi-0.7
$ sudo python setup.py install
$ cd ..
#install bots
$ wget -O bots-3.2.0.tar.gz http://sourceforge.net/projects/bots/files/bots%20open%20source%20edi%20software/3.2.0/bots-3.2.0.tar.gz/download
$ tar -xf bots-3.2.0.tar.gz
$ cd bots-3.2.0
$ sudo python setup.py install
$ cd ..
#set rigths for bots directory to non-root:
$ sudo chown -R myusername /usr/lib/python2.7/site-packages/bots

#start up bots-webserver:
$ bots-webserver.py

Dependencies

Always:

  • Needs: 2.7 Python >= 3.0 does not work.
  • Needs: django < 1.8
  • Needs: cherrypy < 8.0

Optional:

  • Genshi (when using templates/mapping to HTML).

  • SFTP needs paramiko.

  • Cdecimals speeds up bots. See website

  • bots-dirmonitor needs:

    • pyinotify on *nix
    • Python for Windows extensions (pywin) for windows
  • xlrd (when using incoming editype ‘excel’).

  • mysql-Python >= 1.2.2, MySQL (when using database MySQL).

  • psycopg2, PostgreSQL (when using database PostgreSQL).

Install FAQ

I try to install bots at Windows 7/10, but…..
  • Probably a rights problem - you’ll have to have administrator rights in order to do a proper install.
  • Right click the installer program, and choose ‘Run as Administrator’.
  • sometimes the shortcut is not installed in the menu, and you will have to make this manually.
Does bots have edifact and x12 messages installed out-of-the-box?
No. But this can be downloaded on the sourceforge site either as part of a working configuration (plugin) of separate (grammars).
Bots is not working on linux - rights problems.
Did you start bots-webserver and/or bots-engine with sufficient rights - e.g. as root. Change the owner/rights of the files in botssys, usersys and config; run bots-webserver/bots-engine without root rights.

Error during windows installation

close failed in file object destructor:
sys.excepthook is missing
lost sys.stderr
  • seems to happen when UAC is turned off.
  • Actually bots just seems to be installed OK, and works OK…..
  • Fixed this in version 3.2