Setup guide for WRAP v4.

6 WRAP0984O
Page 1 (17)

Setup guide for WRAP v4.6 and WRAP SAM

Please follow this setup guide carefully to minimise the risk of trouble during and after the
installation. The guide applies both for new installations and updates from previous versions.
Some sections in the setup guide have a grey background. These are for users with a WRAP
version already installed, only. It is very important that these grey sections are read and
followed carefully.

Contents
Setup guide for WRAP v4.6 and WRAP SAM .......................................................................1
Contents .................................................................................................................................1
Installation instructions for WRAP Win v4.6 (main program) .................................................2
First time start of WRAP ........................................................................................................6
Installation instruction of WRAP SAM – Spectrum Allocation Manager ............................. 10
FAQ - Frequently asked questions ........................................................................................ 12
Start of WRAP ..................................................................................................................12
Geographical data..............................................................................................................13
Databases .......................................................................................................................... 14
Miscellaneous ................................................................................................................... 14
Installation details................................................................................................................. 16
 Setup guide for WRAP v4.6 WRAP0984O
Page 2 (17)

Installation instructions for WRAP Win v4.6 (main program)

Step Action Check

1. First check out the system requirements with your computer. OK ____

Software Specification
Operating Windows XP with minimum SP2
system Windows Vista with minimum SP1
Windows 7
Windows Server 2003 R2 with SP2
Windows Server 2008 with SP2
Windows Server 2008 R2
Recommended In order to read the documentation a reader for PDF
files and one for Powerpoint(.ppt) files are
recommended.

Hardware Specification
Computer PC, 1 GHz or more recommended.

Memory 512 MB or more recommended, for Vista and Win7 2

GB recommended. For calculations in high resolution
over large areas 2GB is recommended.
Video Minimum 1024x768 pixels, 32k colours (65k+
recommended).
Hard disk Demo version: Approximately 166 to 570 MB is
installed depending on selections made.
Geo Database: About 1 GB or more for a full set,
highly dependent on size of area, resolution etc.
Optional: Sufficient space for MS Access and/or
database server software, e.g. MS SQL Server.

2. IMPORTANT! For users with WRAP already installed. Take a copy of OK ____
the following files and save the copy in a separate folder on the hard disk
(or on another disk).
The file wrapgeo.wgc. (Normally located in c:\Program Files\WRAP.)
The file logo.bmp. (Normally located in c:\Program Files\WRAP.)
The WRAP database(s) you are using. (Normally located in c:\Program
Files\WRAP\Databases.)
 Setup guide for WRAP v4.6 WRAP0984O
Page 3 (17)

Step Action Check

The geographical data you are using. (Normally located in c:\Program
Files\WRAP\GeoDB.)

3. IMPORTANT! For users with WRAP already installed. This version OK ____
needs a new site key. To acquire a new key perform:
Start the old version of WRAP, goto WRAP Licence, Kill
Licence and send the kill code to info@wrap.se
Uninstall WRAP manually as below.
Continue with step 4 and follow the instructions.

4. Older versions of WRAP must first be uninstalled manually. Use the OK ____
Add/Remove Programs option found in the Windows Control Panel mark
the WRAP item and select Remove or Uninstall.
The folder …\WRAP\bin will remain and hold some files even after
uninstall of a licensed version of WRAP has been made. These files must be
manually deleted using the Windows Explorer file manager before
installing the new WRAP version.

5. Note that the GTOPO30 geo data is not included in this setup. Depending OK ____
on which version of WRAP that is already installed the GTOPO30 geo data
might be uninstalled during the installation of WRAP v4.6. If you use it and
want to keep it please backup manually.

6. To start the installation, insert the delivery medium into the computer. The OK ____
setup is started by executing the file setup.exe.

7. WRAP needs Microsoft .NET 2.0 Framework SP1 to be installed for proper OK ____
function. If this is not present on the computer the following dialogue will
appear.
 Setup guide for WRAP v4.6 WRAP0984O
Page 4 (17)

Step Action Check

Press install and follow the instructions.

If a question about installing Microsoft .NET 2.0 Framework appears
please click Yes to install it. Continue with installing.NET 2.0 Framework.

8. This welcome dialogue will appear when the installation program is OK ____
launched.
 Setup guide for WRAP v4.6 WRAP0984O
Page 5 (17)

Step Action Check

9. Next is the licence agreement dialogue. The licence agreement must be OK ____
accepted to proceed with the installation.

10. In this dialogue the user can choose between Complete and Custom OK ____
installation.

The Complete installation option will install files needed for WRAP
including geographical data for the samples. However, the test messages
files for WRAP API are not installed. To install these select the Custom
option.

11. If the Custom option is selected a new dialogue will appear. In this OK ____
dialogue the user can also include/exclude the Documentation, the Samples
and the Geographical demo data. This is not recommended. If the samples
or the geographical data are excluded the sample projects cannot be used.
The feature API should only be installed if included in the licence.
To exclude a feature, point and click on it with the left mouse button to
bring up the options menu and click on This feature will not be available. A
 Setup guide for WRAP v4.6 WRAP0984O
Page 6 (17)

Step Action Check

red cross mark will appear over the feature that is not to be installed.

12. A dialogue like below is shown. OK ____

Please press OK.

13. If the installation was successful this dialogue will appear: OK ____

Press the Finish button to complete the installation process. In some cases
the user will be asked to restart the computer.

14. When the installation program has finished installing WRAP will launch a OK ____
ReadMe.txt file that contains information on what is new in this version of
WRAP. This file is also copied to your WRAP Documentation folder on
your hard drive.

15. Now the installation is complete.

First time start of WRAP

16. Before starting WRAP the first time, please make sure that the Crypkey OK ____
License service is installed and started.
(This is performed in the Control Panel/Administrative Tools/Services. If it
is not started please reboot the computer. If the Crypkey License service
still is not started at all please open a command window. Change directory
to common application data folder\WRAP\CrypKey. (The common
application data folder is typically at C:\Documents and Settings\All
 Setup guide for WRAP v4.6 WRAP0984O
Page 7 (17)

Users\Application Data\WRAP on Windows XP and c:\Program

Data\WRAP on Vista and Win 7. These folders are normally hidden.) Then
enter setupex.)

17. A WRAP program folder with some program items and subfolders has now OK ____
been added to your Windows Start menu.
WRAP is the main application.
The Documentation folder holds shortcuts to some of the documents
installed. Select ‘Browse documents…’ to browse the entire documentation
installed.
(ChangeDB is used to change directory paths and connect and set up
databases to use with WRAP. Run ChangeDB and press <F1> with focus
on this dialogue to bring up this Help topic.
For the Map Data Manager, refer to WRAP User’s Manual section WRAP
Map Data Manager or run Map Data Manager and press <F1> with focus
on this dialogue set to bring up this Help topic.
If the API feature was installed a Tools folder comprising the
SocketCommunicator is also installed. This is a tool for testing the WRAP
API.)

18. You should now be able to launch the WRAP application. OK ____
Note: The default user names that can be selected when starting WRAP are:
Guest (no password)
Testuser (no password)
WRAP User (password “wrap”)
 Setup guide for WRAP v4.6 WRAP0984O
Page 8 (17)

19. The following dialogue is shown in the start-up sequence until a licensed OK ____
version of WRAP has been unlocked. In a demonstration version it is
always shown.

In order to get a licensed version of WRAP. Press OK in the above

dialogue. Then go to the menu WRAP Licence/Authorise dialogue. Send
your “Site code” to info@wrap.se and await the return of the “Site key”
from WRAP International AB. The returned Site Key shall be entered into
the Site Key field.
IMPORTANT! The Site code and Site key procedures MUST be
performed by the computer administrator that installed WRAP.

20. Now you can enter the world of WRAP. Please see the document “Getting OK ____
acquainted with WRAP” under the shortcut WRAP/Documentation.
 Setup guide for WRAP v4.6 WRAP0984O
Page 9 (17)

21. For users who updated from WRAP v4.5.x or lower version (v4.5) of OK ____
WRAP:
In order to reset your previous settings perform these steps:
Shut down WRAP
Copy the logo.bmp and wrapgeo.wgc into the folder common
application data folder\WRAP. (It is typically at C:\Documents and
Settings\user\Application Data\WRAP on Windows XP and
c:\Program Data\WRAP on Vista and Win 7. These folders are
normally hidden.)
We recommend copying the geographical data into C:\Documents
and Settings\All Users\Application Data\WRAP on Windows XP
and c:\Program Data\WRAP on Vista and Win 7. These folders are
normally hidden.
Copy the database files and WRAP project to suitable locations.
Start the ChangeDB program to change the directory paths and
station database files in use with WRAP.
Start WRAP and connect the geographical data into WRAP using
the menu <Settings>-<Geographical>. Normally you can
use the [Update geoDB paths…] button. Refer to the WRAP
help function.
 Setup guide for WRAP v4.6 WRAP0984O
Page 10 (17)

Installation instruction of WRAP SAM –

Spectrum Allocation Manager
Step Action Check

1. WRAP SAM will install a SAM database SAM.mdb in the common OK ____
application data\WRAP folder. If you already have this file and have made
changes, please take a copy of the file and save the copy in a separate folder
on the hard disk (or on another disk)

2. To start the installation, insert the delivery medium into the computer. The OK ____
setup is started by executing the file setup.exe in the WRAP-SAM folder.
Note! In order to have SAM working the WRAP Main software has to be
installed first.

3. WRAP needs Microsoft .NET 3.5 Framework to be installed for proper OK ____
function. If this is not present on the computer the following dialogue will
appear.

Press install and follow the instructions.

4. This welcome dialogue will appear when the installation program is OK ____
launched.
 Setup guide for WRAP v4.6 WRAP0984O
Page 11 (17)

Step Action Check

5. Next is the licence agreement dialogue. The licence agreement must be OK ____
accepted to proceed with the installation.

6. The next dialogue starts the installation when pressing Install. OK ____

7. If the installation was successful this dialogue will appear: OK ____

Press the Finish button to complete the installation process. In some cases
the user will be asked to restart the computer.

8. Now the installation is complete. OK ____

 Setup guide for WRAP v4.6 WRAP0984O
Page 12 (17)

FAQ - Frequently asked questions

Start of WRAP
1. Q: Why is a message “Authorization not present, WRAP Win is now running in
demo mode” shown?
A: The message appears if you have not a licensed version of WRAP.
2. Q: Why is a message “Initialization: Driver failed or busy, WRAP Win is now
running in demo mode” shown?
A: When installing WRAP, the CrypKey Software Security is also installed.
Sometimes the CrypKey service fails to initialise. To solve this problem go to the
Control Panel/Administrative Tools/Services. There should be a row for the Crypkey
License:

If it is not started right-click and start.

If it is not present at all please open a windows explorer window. Change directory to
c:\program files\wrap\bin. Then run the file setupex.exe (Run as Administrator) and
try to start WRAP again. (You will hardly notice that setupex.exe is executed.)

If the message appears again please open a command window (Run as Administrator).
Change directory to common application data folder\WRAP\CrypKey. (The common
application data folder is typically at C:\Documents and Settings\All
Users\Application Data\WRAP on Windows XP and c:\Program Data\WRAP on Vista
and Win 7. These folders are normally hidden.) and then enter setupex /u to uninstall
the CrypKey service. After this the computer has to be restarted.

After restart open a command window (Run as Administrator) again. Change directory
to c:\program files\wrap\bin.Then enter setupex. Now WRAP can be started again.
3. Q:Why is the following message shown?
 Setup guide for WRAP v4.6 WRAP0984O
Page 13 (17)

A: The message means that the version to be installed is not valid for you current
version of WRAP. If you know that you have licence to install the new version please
follow the instructions of step number 3 of the setup instructions.

4. Q: Why is a message “Restriction file write protected, WRAP Win is now

running in demo mode” shown?
A: This can have at least two reasons. Reason 1: The Windows folder Program Files is
write protected or the user of computer do not have write access to this folder. Reason
2: If WRAP is installed on a central server and accessed via Remote desktop. Please
contact WRAP International for a new key.
5. Q: How are the different Users defined?
A: The Users in WRAP are defined in the WRAP database. The Users in the login
Select Users dialogue are from the database defined as the write database. There is a
table named TUser in which the users are defined. (The table is hidden in MS Access.)
It is possible to change the names and passwords for the users as well as adding more
users
6. Q: How can I make WRAP always start with the same project?
A: One option is to double click on the project file to open. The recommended way is
to set the start project using the <Settings>-<Set Startup Project>
function in the WRAP Project window.
7. Q: When updating from previous version, my my edited geo settings from my old
installation show up after upgrading to version 4.6?
A: The WrapGeo.wgc should be copied to correct location. Copy the your old
wrapgeo.wgc file inte C:\Documents and Settings\All Users\Application Data\WRAP
on Windows XP and c:\Program Data\WRAP on Vista and Win 7. In the older
versions of Wrap the wrapgeo.wgc was normally located in c:\program files\wrap.
Geographical data
8. Q: What geodata is included in the installation?
A: The Complete installation installs the following geodata:

Folder Data

SwedenDemo and subfolders Image, Raster and Vector data of part of

Sweden

IDWM ITU Digitized World Map

The geo class SwedenDemo defines the demo geodata of Sweden and IDWM. There
is also one geo class with IDWM only.
9. Q: How is geodata entered into WRAP?
A: Geographical data is defined in WRAP using the menu <Settings>-
<Geographical>. There can be several so called geographical class where each
class defines a particular set of geodata. Geodata normally comprises vector, raster
and image data. For each type of data the path to the data shall be defined together
with the properties of the data. For more details refer to the WRAP Help function.
 Setup guide for WRAP v4.6 WRAP0984O
Page 14 (17)

10. Q: Why is not any geographical data shown in the Map Viewer window?
A: The problem is usually that WRAP can not find the geographical files at the
specified search path. Check that the search paths are correct, see above.

Databases
11. Q: Where are the databases installed?
A: In the common application data folder a WRAP folder is added. It is typically at
C:\Documents and Settings\All Users\Application Data\WRAP on Windows XP and
c:\Program Data\WRAP on Vista and Win 7. These folders are normally hidden. The
databases are installed in a subfolder \Databases. During installation four databases are
stored here. The databases can be stored anywhere and using ChangeDB WRAP can
be connected to any WRAP database.
12. Q: Which databases are installed?
A: A demo database which comprises data for the sample projects. An empty database
which should be copied into another location and connected to WRAP using
ChangeDB. This should then be the production database used be the WRAP users.
There is also two databases installted to be used together with the Obstruction
Manager tool in WRAP.

Miscellaneous
13. Q: How is the different available radar types defined?
A: The radar types are defined in table TOMRadarType. Column Name is the radar
type. The other columns, (Range1WP, Range2WP, Range1Mast, Range2Mast,
CalcMethod1 and CalcMethod2 are only use in Obstruction Manager. Please refer to
User’s Manual for more information.
14. Q: How are the available options of Status and Usage of frequencies defined?
A: The available options of Status and Usage are defined in TFrequencyStatus and
TFrequencyUsage, respectively. Changes shall be made directly in the database.
15. Q: How are the available Levels of hierarchy defined?
A: The Levels are defined in THieararchyLevel.Column Name defines the names and
can only be edited in the database. The same applies for HierarchyLevel. (The lower
level the higher up in the hierarchy structure. HierarchyLevel = 0 is reserved for
None.) The minimum frequency separations are edited using the Divide Allotment
function in WRAP.
16. Q: I want to take a backup copy of the file wrapgeo.wgc. Where do I find it?
A: The file wrapgeo.wgc is located in the user application data folder. It is typically at
C:\Documents and Settings\user\Local Settings\Application Data\WRAP on Windows
XP and c:\Users\user\AppData\Local\WRAP on Vista and Win 7 where user is your
log in name on the computer. These folders are normally hidden. To show the folder
start <Windows Explorer>-<Tools>-<Folder Options…> Got to the tab
View and tick Show hidden files and folders.
Setup guide for WRAP v4.6 WRAP0984O
Page 15 (17)
 Setup guide for WRAP v4.6 WRAP0984O
Page 16 (17)

Installation details

This section describes the details of the WRAP installation. It provides an understanding of
how the different WRAP files and folders are installed and how they are used. It is not
necessary to read for the normal user.
The WRAP program files are installed into the c:\program files\WRAP\bin folder.
This folder contains all DLL:s and other files used by WRAP. It also comprises one
subfolder \Reports which comprises report files (.rpt) for the station and equipment
reports from the database.
In the shared documents folder a WRAP folder is added. It is typically at
C:\Documents and Settings\All Users\Documents\WRAP on Windows XP and
C:\Users\Public\Public Documents\WRAP on Vista and Win 7. In the WRAP folder
the following files and folders are added:
o \Coverage Results – standard folder for storing results
o \Documentation – in this folder the WRAP documentation is installed. The
documentation comprises User’s Manual, References and other files in pdf-
format as well as presentations in ppt-format.
o \MapInfo – folder in which MapInfo symbols shall be stored, if used.
o \Samples – folder with sample projects, test files and APIMessages for tests.
o \Symbols\UserDefined – standard folder for user image files used as map
symbols.
In the common application data folder a WRAP folder is added. It is typically at
C:\Documents and Settings\All Users\Application Data\WRAP on Windows XP and
c:\Program Data\WRAP on Vista and Win 7. These folders are normally hidden. In
the WRAP folder the following files and folders are added:
o \Databases – standard folder for databases. During installation four databases are
stored here. The databases can be stored anywhere and using ChangeDB
WRAP can be connected to any WRAP database.
o \CrypKey with license information. Do not change anything concerning this
folder without contacting WRAP International.
o \GeoDB with some subfolders with demo geographical data. New geodata
should typically be stored in this folder
o \PlugIn and \ToolSettings are folders that are automatically copied to the user
application data folders at the first time WRAP is started.
o logo.bmp. File with logotype which is used at printouts. Change this file to your
own logo if you want it on the printouts. The width/height relationship should
be approximately 4.16/1 (with 256 colours) in order to fit the space on the
printout.
o wrapgeo.wgc. File with geographical settings automatically copied to the user
application data folders at the first time WRAP is started.
 Setup guide for WRAP v4.6 WRAP0984O
Page 17 (17)

In the user application data folder a WRAP folder is added. It is typically at

C:\Documents and Settings\user\Local Settings\Application Data\WRAP on Windows
XP and c:\Users\user\AppData\Local\WRAP on Vista and Win 7. These folders are
normally hidden. The wrapgeo.wgc and the \PlugIn and \ToolSettings are copied into
this folder the first time the user starts WRAP
The installation program will install Gpdetvag.dll (DETVAG 90/FOI Com object file)
to c:\program files\WRAP\bin folder. This may affect other programs using this dll.
The installation program will install Crystal Reports runtime version.
WRAP installs IDWM (ITU Digitized World Map) onto your hard drive and updates
the initialisation file br_soft.ini which is located in your Windows folder. This may
affect other programs possibly using IDWM.
The installation program will also install CrypKey software security.
If the feature API is installed please look in the document
WRAP1974_WRAPAPIInterface.pdf for details.