Obexsender, Obexserver, SMS GW and Setup Application upgrade for SW 2.2 ======================================================================= Setup ===== The Setup application must upgraded to support the upgraded Obexsender and SMS GW. You must upgrade SMS GW even if you are not using it. 2006-08-24: Bug with empty iWRAP password fixed. 2006-08-15: Setup application has been updated to allow up to 1 year (31536000 seconds) for "If previous was ok, timeout before sending again" (okdelay) and "If previous was reject, timeout before trying again" (faildelay). NOTE: each device in okdelay/faildelay list uses RAM memory (and also flash, if you have enabled ignore-list dumping). If you have a lot of different phones in your network and a high value in ok/faildelay, you may eventually run out ram and/or flash, at which point Obexsender will stop working. For example, if in your network there is a new device each second, and you ok/faildelay is set to one month, you will end up having 43200 devices in the ok/faildelay lists. The dump file will grow then to up to 1.2MB and you will need 10.5MB of free RAM for the internal runtime memory structures. This you should be able to handle, if you have at least 2.5MB of free space in /mnt/mtd for the ignore-list dump and standard applications running. NOTE2: Writing a long ignore-list dump file to flash may take several seconds, during which the Obexsender is halted. You may want to set "dumpdelay" to a higher value in environments with a lot of new phones. SMS Gateway upgrade to fix Compact Flash GPRS card support ========================================================== - Configuration file has been changed, update Setup application too. - You need to upgrade obexsender too (Setup application needs the latest Obexsender) Obexsender and obexserver improvements ====================================== - dumpfile and dumpdelay added - possibility to copy incoming files from /tmp/obex for another dir - retrydelay, scandelay, replydelay added - watchdog support added - regexp and unicode support for reply (also delnoentry directive) - Setup application needs to be updated to support these WARNING ------- This update has gone through only limited testing, so please do not update all your devices at once. Test with a small test network first. Do not mix the old and new obexsender devices - phones will start receiving duplicates of the files. dumpfile, dumpdelay ------------------- The dumpfile configuration directive specifies the filename where ignore-list is saved for reboots. The dumpdelay configuration directive tells how often this file will be update on flash. The recommended setting is 900 (every 15 minutes). Using a small value here can physically burn the flash device! By default this dumping is disabled with "dumpdelay 0". Obexserver is updated so that it can be configured to copy incoming files from /tmp/obex directory to safe location before they are deleted by the obexserver (when processing "reply" and "delnomatch" functionality). Copy files from /tmp/obex to safe --------------------------------- To copy the files to safe location: 1. Create a copier script /usr/local/bin/copier #!/bin/sh # to be called from obexsender: --fork /usr/local/bin/copier SAVEDIR="/path/to/savedir" # This directory must exist! /bin/cp "$1" "${SAVEDIR}/$3`/bin/date "+%s"`-`echo $1 | /usr/bin/cut -f 2 -d-`" 2. Make it executable chmod a+rx /usr/local/bin/copier 3. Override the default obexserver settings Add following line to /etc/bluetooth.conf: SET BLUETOOTH LISTEN 3 "/usr/sbin/obexserver --bdaddr $b --prefix $b-$P- --fork /usr/local/bin/copier" 110 --fork will run /usr/local/bin/copier with parameters "filename bdaddr prefix" 4. Restart the Access Server Now all incoming files are copied to /path/to/savedir/bdaddr-btserverport-timestamp-filename.ext retrydelay ---------- The retrydelay feature allows Obexsender to retry sending content to remote devices in following situations: - Device has been found, but for some reason doesn't answer - Connection is established but is broken afterwards, for example in case remote device exits Access server's range - Connection is established but user doesn't notice the incoming transmission, ie. doesn't accept the connection scandelay --------- The scandelay setting specifies the delay in seconds before scanning incoming OBEX directory for PULL requests. replydelay ---------- The replydelay setting specifies the delay in seconds before sending the response file after PULL request has matched. Watchdog -------- Watchdog feature makes Obexsender to register to the system watchdog service. This way the Obexsender will make the Access Server to reboot if all iWRAP connections to the processes controlling Bluetooth radios fail. reply regexp support -------------------- Regexp support for reply directive does what is says. Also unicode content (newest phone models) works now. See obexsender.conf for details. broadcast --------- Broadcast configuration directive accepts interface name now. delnomatch ---------- New directive "delnomatch" added to cleaning up incoming /tmp/obex directory. LOGGING ------- Format has changed a bit: - retry/errorcode/elapsed tells that the connection attempt has failed after "elapsed" seconds with errorcode and device is considered worth retrying (errorcode is 0x104, 0x108 or 0x465 or 0x0 and elapsed time is about 30 or 60 seconds). - fail/errorcode/elapsed tells that something not worth retrying (errorcode) happened after certain time. The device is put to "fail" list. We can use this information to add new retry categories, if needed in the future. You might want start collecting logfiles for future analysis. - At command line you can now give the command "killall -USR1 obexsender" which signals the obexsender application to output current ignore (fail/block) list to the log, viewable from "total" log view. UPGRADING ========= 1. Make sure you have software version 2.2 installed in your Access server before updating Obexsender. If not, download necessary upgrade packages from http://www.bluegiga.com/techforum/. You can ask additional information from support@bluegiga.com 2. Back up your current /etc/obexsender.conf, if you dont want to reconfigure from scratch. 3. Send the WPKs to Access server using "WWW Setup -> Advanced -> Upload a software update" and wait for them to appear in "WWW Setup -> Advanced -> List installed software components". It is also possible to upgrade using a USB dongle. Then you should place the WPKs to the root directory of the dongle, after which they will be automatically processed by Access server when dongle is plugged in. 4. Merge by hand your old Obexsender settings to /etc/obexsender.conf from the back-up file created in phase 1. 5. Reboot the device. 6. Upgrade the other devices in your (test) network similarly.