Installing CONTROL on an Oxford Store branch computer

At Head Office:
1. Create polling directories:
  - $CCDIR/OXFORD/<BRANCH>
  - $CCDIR/OXFORD/<BRANCH>/send
  - $CCDIR/OXFORD/<BRANCH>/receive
2. Create the branch as needed in the OXFORD company. Should be copy of an existing store with appropriate modifications.
3. Create the polling location as needed in the OXFORD company. Should be copy of an existing store with appropriate modifications.
4. If the branch is a new branch, copy stock and category records to branch from ??HO?? (sicrep)
5. Tar (retain absolute path) the following into control.tgz.
  1. /u/cc/adm.store
  2. /u/cc/pixmap
  3. /u/cc/standard
  4. /u/cc/blank
  5. /u/cc/std
  6. /u/cc/binl
  7. /u/cc/binx11
  8. /u/cc/lib
6. Tar (retain absolute path) the following user files into users.tgz
  1. /u/cc/usr/common.sh
  2. /u/cc/usr/ccc/.bash_profile
  3. /u/cc/usr/ccc/.bash_logout
  4. /u/cc/usr/pos/.bash_profile
  5. /u/cc/usr/pos/.bash_logout
7. If the store does not have a VPN connection, tar (retain absolute path) the following VPN files into vpn.tgz
  1. /etc/ppp/peers/oxford
  2. /etc/ppp/peers/oxford_id_dsa
  3. /etc/ppp/connect-script
  4. /etc/ppp/ip-up.local
8. Tar (absolute path) the following into eftpos.tgz:
  1. /u/eftpos
  2. /usr/java/j2re1.4.2_01/lib/i386/librxtxSerial-2.0.5.so
  3. /usr/java/j2re1.4.2_01/lib/i386/librxtxSerial.so
  4. /usr/java/j2re1.4.2_01/lib/ext/comm.jar
  5. /usr/java/j2re1.4.2_01/lib/ext/jcl.jar
  6. /usr/java/j2re1.4.2_01/lib/javax.comm.properties
  7. /etc/X11/fvwm2/system.fvwm2rc
9. When installing for Windows based store (ISHKA)
  1. Create required location by CLONING (F4) from existing on. sicrep cats and products to new location
  2. Copy data from one of the existing PC
    1. cd \cc\ishka
    2. pkzip zipidx *.idx
    3. pkzip zipdat *.dat
    4. from server wget ftp://polling:mushroom@192.168.$n.100/ishka/zipidx.zip
    5. from server wget ftp://polling:mushroom@192.168.$n.100/ishka/zipdat.zip
  3. Unpack them into empty directory (JEN) - cd /u/cc/JEN; unzip zipdat.zip; unzip zipidx.zip
  4. conset -c JEN ; clrco;
  5. transfer all file to \cc\ishka
  6. make sure adm files are taken from another Windows installation
  7. Copy-create new location on PC and make sure to delete log.dat - so it does not poll back
  8. check ccreg (must be DEMO) and make sure it is conset to correct branch and termno is 2
  9. do not do 8. in Computer advanced set NODEID to ISHKA
10. 1. Copy data from HO into polling files
  1. Make sure there isn't a copy of rslog.dat in the local directory and copy standard rslog.dat into the local directory
  2. Make sure there isn't a copy of rsendtrn.dat in the local directory and copy standard rsendtrn.dat into the local directory
  3. Dump the following records to the local copy of rslog.dat IN THE FOLLOWING ORDER:
    1. Menus (menurep -l rslog.dat)
    2. Branches (brurep -l rslog.dat)
      1. Branch Code = 1
      2. Branch Code = HO
    3. Employees (empurep -l rslog.dat)
    4. Creditor Types (cutrep -l rslog.dat)
    5. Creditors (cutrep -l rslog.dat)
    6. Companies (courep -l rslog.dat)
    7. Salespeople (smurep -l rslog.dat)
    8. Colours (clrurep -l rslog.dat)
    9. Sizes (sizurep -l rslog.dat)
    10. Categories (catrep -l rslog.dat)
    11. Stock Items (sturep -l rslog.dat)
      1. The stock in the branch
      2. Stock from warehouse location
    12. BOMs (bomrep -l rslog.dat)
    13. Debtor Types (dutrep -l rslog.dat)
    14. Debtors (dutrep -l rslog.dat)
    15. Debtor Notes (dutrep -l rslog.dat)
  4. Process all polling files received (commpost -s)
  5. Post all transactions (postal)
  6. Extract all transactions relating to this store (sendpost -f tran.dat -o rsendtrn.dat -B <BRANCH> 1 12 14 16 17 21 22 30)
  7. Extract ALL Customer Orders, Debtor Payments Gift Vouchers, etc. (sendpost -f tran.dat -o rsendtrn.dat 22 23 24 25 26 36)
  8. For DIM stores send all counts to the store
```
cd <CCDIR>/<COCODE>/<BRCODE>/
cp /u/cc/standard rstcount.dat .
conset -c <COCODE> -B <BRCODE>
sscrep -b 0 -l z -g -o rstcount.dat
```
  9. Make sure in comaad, head office location (WAREH) has generate stock counts set to "ALL".
  10. Zip up rslog.dat and rsendtrn.dat into rsend1.zip
  11. Send all of the tar and zip files to the new store.
At the Store:
1. Install the following packages: (Should be available at HO server or Greenwood server)
  - fribidi-0.10.1-2.i386.rpm
  - libstroke-0.4-1mdk.i586.rpm
  - fvwm-2.5.5-1.i386.rpm
  - xloadimage-4.1-24.i386.rpm
  - telnet-server-0.17-23.i386.rpm
  - mgetty-1.1.28-9.i386.rpm
  - ncompress-4.2.4-31.i386.rpm
  - rxvt-2.7.5-15.i386.rpm
  - vsftpd-1.1.0-1.i386.rpm
  - pine-4.44-13.i386.rpm
  - rsh-server-0.17-10.i386.rpm
  - postfix-1.1.11-5.i386.rpm
2. Install j2re1.4.2_01. It is important that you use this EXACT version of Java.
3. Create the /u/ and /u/cc/ directories with world-readable/writable/executable permissions
4. Link /cc/ to /u/cc/
5. Untar the contents of control.tgz to the appropriate directory.
6. Rename the adm.store directory to adm
7. Copy the blank company directory to be called OXFORD
8. Export CCDIR=/u/cc
9. Export NODEID=DEMO
10. Run conset to change to the OXFORD company
11. Rename the branch code "1" to be <BRANCH>
12. Rename the polling location "1" to <BRANCH>
13. Create the necessary system users
  1. cc
  2. pos
  3. polling
14. Untar users.tgz to the appropriate directory
15. If necessary, untar vpn.tgz to the appropriate directory and insert the necessary inittab command.
16. Untar eftpos.tgz into the appropriate directory.
17. Edit serialPortName in /u/eftpos/eftclt/eftclt.settings so that the eftpos client accesses the correct serial port.
18. Link /usr/share/fvwm/system.fvwm2rc to /etc/X11/fvwm2/system.fvwm2rc
19. Place rsend1.zip in the /u/cc/OXFORD/<BRANCH>/receive/ directory. Polling should automatically process this.
20. Setup the appropriate cron jobs
21. Run and test EVERYTHING !!
22. After polling runs once, list out the voucher redemptions (salstr 8). Make sure the redemption location matches what is in head office.
23. Update this piece of documentation.

Note for ISHKA new stores.

Make sure to start from a blank stock file (standard company) and associated stock indices. If not, and we copy from a database with broken stock index, we may run into problems when we attempt to reindex the stock file later on (such as merging to the wrong record and having weird things change, like the barcode number).

CategoryInstallation

Installing_Oxford_Stores

Installing CONTROL on an Oxford Store branch computer