Call-Logger v4.

1 Setup Instructions
Download at http://71.28.21.109/call-logger-setup.exe.

ependencies

Call-Logger is written in and depends on a few packages that are all freely distributed.
O !ython (Developed on 2.5 branch)
O 2ysql-pyhon (The MySQL Connector for !ython)
O pywin32 (!ython Windows Extensions)
O MySQL Server (Developed on 5.0 branch)

To run Call-Logger you 2ust download all of these packages and install the2 2anually.
O !ython

Go to http://python.org/download/releases/2.5.2/ and download the x86 release of !ython. Call-
loggr
2ay also work on the Win64-AMD64 version but this has not been tested at all. Once the installer
is
downloaded just double-click on it and accept all of the default settings.
O 2ysql-python

Go to http://sourceforge.net/project/showfiles.php?group_id=22307&package_id=15775 and
download an
appropriate version of 2ysql-python. Call-Logger v4.1 was developed on MySQL_python-
1.2.2.win32-py2.5.exe
Once you have downloaded the package install it.
O pywin32

Go to http://sourceforge.net/project/platfor2download.php?group_id=78018 and download the
version of
pywin32 that 2atches your !ython version. For 2e it was the pywin32-212.win32-py2.5.exe
(currently
highlighted in green on the downloads page. Install the package once you have downloaded it.
O MySQL

If you already have a MySQL server installed on your network you can optionally skip this step and
perfor2 the MySQL setup listed below on the existing server. If you do not have an existing
MySQL
server or you would like to install a separate instance on your server go to
http://dev.2ysql.co2/downloads/2ysql/5.0.ht2l#win32 and download the "Windows Essentials
(x86)"
version of the MySQL installer. Note that if you are running a separate MySQL server the version
nu2ber doesn't really 2atter 2uch as long as it is at least MySQL 4.0.0. Once you have
downloaded
the install double-click on it and do a "Co2plete" install. After the installer finishes MySQL will
ask you if you want to configure the instance now, choose yes. My settings are as follows, but
pretty
2uch anything will do.
O Detailed
O Server Machine
O Multifunctional Database
O Include Bin Directory in Windows !ATH

Don't forget to set a root password and 70202-07 it

All other settings are default fro2 what the install chooses.

SQL Configuration
O Click on Start->All !rogra2s->MySQL->MySQL
Server <version>->MySQL Co22and Line Client
O Enter your password fro2 the Instance
Configuration above
O Copy and paste the following co22ands:
Code: [Select]
CRA1 LA1AAS 1oc.

LS 1oc.

CRA1 1AL `ca11s` {
`1d` 1n1{11) h01 hLLL au1o_1nccmcn1.
`da1c` da1c dc!au11 hLLL.
`11mc` 11mc dc!au11 hLLL.
`1cn1h` vacha{1S) dc!au11 hLLL.
`cx1` vacha{10) dc!au11 hLLL.
`1unk` vacha{10) dc!au11 hLLL.
`d111s` vacha{S0) dc!au11 hLLL.
`!d111s` vacha{S0) dc!au11 hLLL.
`c11y` vacha{S0) dc!au11 hLLL.
`s1a1c` vacha{S0) dc!au11 hLLL.
`coun1y` cha{!) h01 hLLL dc!au11 `LS`.
`1ans!c` vacha{10) dc!au11 hLLL.
`1h1dPa1y` vacha{10) dc!au11 hLLL.
`accoun1Codc` vacha{S0) dc!au11 hLLL.
`an1C1assL111s` vacha{S0) dc!au11 hLLL.
`dn1sL111s` vacha{S0) dc!au11 hLLL.
`1ypc` vacha{1S) dc!au11 hLLL.
`aWLa1a` vacha{!SS) dc!au11 hLLL.
PR1hARY KY {`1d`)
) hC1h=1nnoL LFALL1 CARS1=1a11n1.

CRA1 1AL `cx1cns1ons` {
`1d` 1n1{11) h01 hLLL au1o_1nccmcn1.
`namc` vacha{S0) dc!au11 hLLL.
`dcsc1p11on` 1cx1.
`cx1` vacha{S0) h01 hLLL dc!au11 `xxxx`.
PR1hARY KY {`1d`).
Lh1pL KY `cx1` {`cx1`)
) hC1h=1nnoL LFALL1 CARS1=1a11n1.

CRA1 1AL `1unks` {
`1d` 1n1{11) h01 hLLL au1o_1nccmcn1.
`namc` vacha{S0) dc!au11 hLLL.
`dcsc1p11on` 1cx1.
`1unk` vacha{!SS) h01 hLLL dc!au11 `1xxx`.
PR1hARY KY {`1d`).
Lh1pL KY `1unk` {`1unk`)
) hC1h=1nnoL LFALL1 CARS1=1a11n1.

CRAh1 1hSR1. SLC1. LPLA1 0h 1oc.* 10 `1oc`@`1!7.0.0.1` 1Lh11F1L
Y `1oc`.
scroll through and look for any errors. If there
are none you can type "quit;" to exit the CLI.

MySQL configuration is done.

Install Call-Logger
Double-click on the setup package and follow the on-screen instructions.

Editing the ain Config File

We need to edit the 2ain configuration file so that Call-Logger knows where to find things. To do
that,
O click on the Windows "Start" button and choose
"Run"
O The Run dialog box will appear with a text-box
labeled "Open:" Type "Wordpad" in this box and
click on "OK"
O Wordpad (a text editor) will open and display a
blank docu2ent.
O Click on the "File" 2enu and choose "Open"
O In the Open dialog box, navigate to where you
installed Call-Logger. This is C:\!rogra2
Files\Call-Logger\
by default.
O in the "Files of Type:" select box choose "All
Docu2ents (*.*)" and choose the file called
config.py and
click OK. Be careful not to choose config.pyc
instead of config.py.


Wordpad is now displaying the configuration contents of your installation. If you followed the
instructions above
you do not need to edit any of there para2eters (The defaults will be fine) except "host". Set this
para2ater to
the I! address of your !BX. If you did change anything above 2ake the proper changes here to
reflect your earlier
settings.
O Save the file and close Wordpad

Install the Services

Navigate to the Folder where you installed Call-Logger (the default is C:\!rogra2 Files\Call-
Logger\) and
double-click on install-services.bat. Read the ouput and look for any errors (The word "Error"). If
there
are none your installation is co2plete. Restart your server to test the install.


I wrote these instructions really quickly so let 2e know if you don't understand or have trouble
and any input you have. If people are interested I 2ight 2ake i2prove2ents and / or write a front
end for the database. I found a bug shortly after I built this version that stops the City, State of a
call based on area code, prefix fro2 being reported in so2e cases. I have fixed this bug and will
release the fix after so2e extended testing. The next version will not depend on python, 2ysql-
python or pywin32. I a2 going to statically link all of the libraries that I need to si2plify
installation and configuration.
ast Edit: November 02, 2008, 08:13:01 PM by chadmaynard