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

Let us know if it runs (or not) on another OS.

Windows

  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 all dependencies for standard installation. Some extra dependencies are needed for less used functions (eg. extracting data from excel or pdf files).

*nix installation

There is no *.deb or *.rpm for bots - would be great if you have experience with this and want to give some help. 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

Place the directories botssys, usersys and config somewhere else (out of /usr), change the owner/rights and make symbolic links in the bots installation to these directories.

Installation from scratch

Installation on amazon EC2, looks like red hat version of linux (Note that versions might not be correct anymore)

#install django
$ wget -O django.tar.gz https://www.djangoproject.com/download/1.4.13/tarball/
$ tar -xf django.tar.gz
$ cd Django-1.4.13
$ 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.1.0.tar.gz http://sourceforge.net/projects/bots/files/bots%20open%20source%20edi%20software/3.1.0/bots-3.1.0.tar.gz/download
$ tar -xf bots-3.1.0.tar.gz
$ cd bots-3.1.0
$ sudo python setup.py install
$ cd ..
#set rigths for bots directory to non-root:
$ sudo chown -R myusername /usr/lib/python2.6/site-packages/bots

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

Installation from scratch (bots2.2)

Installation on vanilla CentOS6.2 (logged in as root) (Note that versions might not be correct anymore):

#install django
wget http://www.djangoproject.com/download/1.3.1/tarball/
tar -xf Django-1.3.1.tar.gz
cd Django-1.3.1
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
python setup.py install
cd ..
#install Genshi
wget http://ftp.edgewall.com/pub/genshi/Genshi-0.6.tar.gz
tar -xf Genshi-0.6.tar.gz
cd Genshi-0.6
python setup.py install
cd ..
#install bots
wget http://sourceforge.net/projects/bots/files/bots%20open%20source%20edi%20software/2.2.1/bots-2.2.1.tar.gz/download
tar -xf bots-2.2.1.tar.gz
cd bots-2.2.1
python setup.py install
cd ..

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

Dependencies

Always:

  • Needs: python 2.6/2.7. Python >= 3.0 does not work.
  • Needs: django >= 1.4.0, django <= 1.7.0
  • Needs: cherrypy > 3.1.0

Optional:

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

  • SFTP needs paramiko and pycrypto. Newer versions of paramiko also need ecdsa.

  • 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