RATSwap

QuickGuide
Introduction
Purpose of RATSwap is Flexi FSM SW updating and Flexi FSM SW
RAT type swapping between WCDMA and LTE releases.
RATSwap.exe is mainly tested with WN6.0, WN7.0 and LN3.0 Flexi
SW releases. Support for LN1.0 and older WN releases (WN4.x) is
tested slightly but not fully proved.
RATSwap is command prompt SW, there is not any Graphical User
Interface.
RATSwap is currently tested in Windows 7 environment. Windows
XP or Vista or Windows 8 environments (or any other OS like Linux /
Wine) are not officially supported / tested -> use at your own risk in
other OS than Windows 7.
RATSwap does not perform commission or any other BTS
dependent configurations for FSM. State of FSM updated with
RATSwap is similar as in FSM delivered from production.
Installation
1. Extract RATSwap.zip to your preferred working directory.
2. Change permission rules of your RATSwap working directory
to allow all operations.
3. IF NEEDED, modify FsmSw folder to contain correct Flexi FSM
SW releases and files. Currently contains
WN7.0_1207_623_00 and this will be installed by default.
The package also contains WN6.0_22.12-159_B that can be
installed using the --path option
Additional packages may be available/ be made available on
request from Carl Eklund
Please note that packages downloaded from NOLS are
missing some XML files that are needed.

To convert a FSME with LTE SW to
WCDMA
1. Make sure there is not FTM connected to FSME. FTM turns ethernet security
features on and ethernet connection to FSME does not succeed.
2. Connect the FSME to your PC with a cross connected ethernet cable . The
cable should be inserted into the LMP of the FSME.
3. IP address for FSME connection have to be 192.168.255.126, subnet mask
255.255.255.0 , no gateway.
4. Firewall have to disble for FSME connection. Other network connections of
current PC does not disturb so no need to disable them.
5. Open command prompt to your working directory and run RATSwap .exe (with --
help or parameters described later on this QuickQuide)
6. Give the below command on the command line to start procedure:
RATSwap.exe --LteToWcdma
7. Await the following message indicating successful conversion (please see
Screenshot from typival execution console view slide, later on this quide):
Swap from LTE to WCDMA operation and Flexi SW release download succesfully
done.
Do not power off either the FSME or PC during the procedure, if possible run the
procedure with power back up





Parameters
--LteToWcdma (mandatory)
OR
--WcdmaToLte (mandatory)

Optional (not needed in typical case)
--prepare (optional)
--update (optional)
--backup (optional)
--unit (optional)
--path (optional)
Parameter description
--LteToWcdma
Mandatory parameter if Flexi FSM SW swap (RAT swap)
from LTE to WCDMA is operation in demand.
Starting RAT swap for current FSM, swap FCMD and FSPC
SW both. Updates WN SW release from certain folder in
use.
Usage: RatSwap.exe --LteToWcdma
Parameter description
--WcdmaToLte
Mandatory parameter if Flexi FSM SW swap (RAT swap)
from WCDMA to LTE is operation in demand.
Starting RAT swap for current FSM, swap FCMD and FSPC
SW both. Updates LTE SW release from certain folder in
use.
Usage: RatSwap.exe --WcdmaToLte
Parameter description
--prepare
Optional parameter for LteToWcdma or WcdmaToLte
parameter.
Leave FSM to use basic Platfrom SW (both FCMD and
FSPC). Not any official Flexi BTS release
updated/downloaded.
Additional Flexi SW release updating possible later. (with
puttipatti or RATSwap)
Usage: RatSwap.exe --WcdmaToLte --prepare
Parameter description
--update
Optional (but independent) parameter.
Updates Flexi SW release to current FSM. Uses same RAT
type as currently running on FSM.
Usage: RatSwap.exe --update
Parameter description
--backup
Optional (but independent) parameter.
Take backup from current FSM (both FCMD and FSPC).
Backup contains all files form currently active filesystem
(/rom when WCDMA or /ffs/run when LTE). Any
programmed binary from dedicated flash area will NOT be
reconstructed.
Usage: RatSwap.exe --backup
Parameter description
--unit
Optional parameter for all parameters mentioned earlier.
Limit current operation for this certain unit/board only
Usage example: RatSwap.exe --update --unit FCM
Parameter description
--path
Optional parameter for LteToWcdma, --WcdmaToLte or
--update operations.
User can give optional, own Flexi SW release or other SW
packet for updating/downloading procedure.
Folder structure under given folder have to be same like
folder structure under SW release under example Flexi SW
release (delivered with RATSwap tool).
Usage example: RatSwap.exe --update --path
../myOwnSwPacket/Wcdma/
Typical commands
RATSwap from LTE Flexi SW to WCDMA Flexi SW
RatSwap.exe --LteToWcdma
Update WCDMA Flexi SW (target allready WCDMA)
RatSwap.exe --update
RATSwap from LTE Flexi SW to WCDMA Flexi SW but
download only Platform SW to target.
RatSwap.exe --LteToWcdma --prepare
RATSwap LTE to WCDMA only for e.g. FSM1_FSP3 (after
terminated over all process)
RatSwap.exe --LteToWcdma --unit FSP3
Take back up (copy content of flash filesystem or /rom disk)
RatSwap.exe --backup
Screenshot from typical console view
FsmSw folder structure (WCDMA)
FsmSw folder structure (LTE)
Platform SW folder structure
Problems and known bugs
FSPC RAT swapping from LTE to WCDMA is not
totally robust against power off situation.
Support for very old Flexi SW releases not tested
fully -> propably do not work at all.
Error handling procedure for ethernet connection
break down during RAT swap procedure is not
fully solved.
OAM reseting target time to time. No way to
prevent it. User have to reset target manually first
and then start RAT swap procedure
immediately.
Problem solving procedure
Update or RAT swap procedure interrupts for
some socket error or spontanious reset.
If problem happens during step one restart
procedure again with same parameters
Problem solving procedure
Update or RAT swap procedure interrupts for
some socket error or spontanious reset.
If problem happens later than step one or if
restarting procedure does not help perform current
command for each unir separately, first prepare
units (downloading pre-configuration SW):
RATSwap.exe --prepare --unit FSM1_FCM
RATSwap.exe --prepare --unit FSM1_FSP1
RATSwap.exe --prepare --unit FSM1_FSP2
RATSwap.exe --prepare --unit FSM1_FSP3

Problem solving procedure
Then perform original command separately for all
units:
RATSwap.exe <parameter> --unit FSM1_FCM
RATSwap.exe <parameter> --unit FSM1_FSP1
RATSwap.exe <parameter> --unit FSM1_FSP2
RATSwap.exe <parameter> --unit FSM1_FSP3
If steps above fail and operation/parameter is
LteToWcdma or WcdmaToLte try to perform first --
prepare option for all units:
RATSwap LteToWcdma prepare unit FSM1_FCM
RATSwap LteToWcdma prepare unit FSM1_FSP1
RATSwap LteToWcdma prepare unit FSM1_FSP2
RATSwap LteToWcdma prepare unit FSM1_FSP3



Problem solving procedure
Then use update command separately for all
units to update Flexi SW in use:
RATSwap.exe --update --unit FSM1_FCM
RATSwap.exe --update --unit FSM1_FSP1
RATSwap.exe --update --unit FSM1_FSP2
RATSwap.exe --update --unit FSM1_FSP3



Problem solving procedure
Socket connection from PC to FSME break off
repeatedly.
Check and replace ethernet cable
Be sure there is not FTM connected to FSME
Be sure there is only one FSME connected to your PC
Be sure there is not any other applications running in PC
which communicate with FSME
Check you ethernet controller settings
Check your firewall settings, allow all options for FSME
connection or disable firewall application
If steps above does not help your PC or current FSME
might have some serious HW problems