Setup guide for WRAP v4.

19- WRAP 3350

Page 1 (24)

Setup guide for WRAP Main v4.20 (32-bit) and later

This is a step-by-step guide to follow when installing WRAP version 4.19 (32-bit) and later.
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.
Make sure that you are entitled to version 4.19, if not the installation is cancelled.
For upgrades, there are some differences depending on if the databases used are in MS
Access format or MS SQL Server. If MS SQL Server database is used as database
server the database administrator must perform a database upgrade, please refer to
page 6.
LocalDB is a minimal version of the MS SQL Server database engine and can be use in stand-
alone installations of WRAP. In a multi-user environment SQL Server shall be used.
If you update from version 4.6 or lower please contact WRAP International for further
instructions.
 Setup guide for WRAP v4.19- WRAP 3350
Page 2 (24)

Contents
Setup guide for WRAP Main v4.19 (32-bit) and later ............................................................... 1
Contents ...................................................................................................................................... 2
System requirements .................................................................................................................. 3
Installation instructions for WRAP Main v4.19......................................................................... 4
Update of WRAP ....................................................................................................................... 6
Update of databases in SQL server. ........................................................................................ 6
Update of databases in MS Access. ........................................................................................ 6
First time start of WRAP .......................................................................................................... 11
Databases .................................................................................................................................. 14
Creating a new WRAPDB database in SQL server. ............................................................. 14
Configuration of Network License Server ............................................................................... 15
FAQ - Frequently asked questions ........................................................................................... 18
Installation............................................................................................................................. 18
Start of WRAP ...................................................................................................................... 18
Geographical data ................................................................................................................. 21
Databases .............................................................................................................................. 21
Miscellaneous ....................................................................................................................... 22
Installation details .................................................................................................................... 23
Other files.............................................................................................................................. 24
 Setup guide for WRAP v4.19- WRAP 3350
Page 3 (24)

System requirements
Operating Windows 7 SP1
system Windows 8 or 8.1 or later
Window 10
Windows Server 2008 with SP2/2008/R2
Windows Server 2012/ 2012R2
For Windows 8.1 and Windows Server 2012 R2,
KB2883200 (available through Windows Update) is
required.
.NET Framework 4 with update KB2468871-v2 or later
.NET Framework version must be installed.
Recommended In order to read the documentation a reader for PDF
files and one for Powerpoint(.ppt) files are
recommended.
Computer See recommendation for operating system.

Memory See recommendation for operating system. For

calculations in high resolution over large areas at least
4 GB is recommended.
Video Minimum 1024x768 pixels, 32k colours (65k+
recommended).
 Setup guide for WRAP v4.19- WRAP 3350
Page 4 (24)

Installation instructions for WRAP Main v4.19

Step Action Check

1. The setup is started by executing the file WRAP Setup (32-bit).exe. OK ____

2. First a splash screen is shown: OK ____

and then a License agreement dialogue:

Please check the checkbox and press Install.

3. Enter needed data in the UAC dialogue and proceed. OK ____

4. A progress meter is shown: OK ____

 Setup guide for WRAP v4.19- WRAP 3350
Page 5 (24)

Step Action Check

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

Click the Readme button to finish the installation process and view the
Readme file with the news or click the Close button to finish the
installation process directly.
Now the installation is complete.

6. If this is an update, please go to section “Update of WRAP” at page 6.

If this is a first-time installation, please go to section “First time start of
WRAP” at page 11.
 Setup guide for WRAP v4.19- WRAP 3350
Page 6 (24)

Update of WRAP
The next step of updating depends on whether the database used is in Microsoft Access
format or in Microsoft SQL Server format. Databases using the SQL server database engine
should be updated manually.
Databases in MS Access can be updated automatically to LocalDB format using ChangeDB
but the MS Access format can still be used.
When starting WRAP after the update please note the memory usage dialogue.

Update of databases in SQL server.

7. Take a back-up of the database.

8. Execute the script UpdateWRAPDBInSQLServers.sql on the database.

If another name is used replace WRAPDB on the line:
* use "WRAPDB"
The script is in the folder ClientServerWRAPDB\SQL Server of the
installation medium.

9. If a SQL Server database has been used previously, text strings might
be specified to be using varchar. For some languages, this is insufficient
and nvarchar must be used. Use the script
UpdateWRAPDBColsFromVarcharToNVarchar.sql to update the text
fields within the database to nvarchar. This may apply to databases
created before 24 January 2017.

Update of databases in MS Access.

MS Access databases can be automatically updated to LocalDB format when starting
ChangeDB. After the update, they will be connected to WRAP when ChangeDB is exited.
Answer No to the question “Do you want to convert…” it you still want to use the MS Access
format.
If an error, “Databases cannot be converted. Please refer to WRAP SetupGuide for more
information” is shown please install Microsoft Access RT 2007 or 2010, otherwise follow the
instructions below.

10. Start ChangeDB.

 Setup guide for WRAP v4.19- WRAP 3350
Page 7 (24)

11. If database that can be converted is attached the following dialogue is

shown:

Press Yes to convert the database and use it in WRAP. Press No if you still
want to use the MS Access database.

12. If Yes was pressed a new dialogue is shown:

If the database only shall be used in LocalDB at the computer performing

the update select the highest version.
If the database shall be used in SQL Server please select the version of SQL
Server to be used. Lower versions of SQL Server are not able to read higher
versions of mdf-files. Additional scripts are needed to be executed after the
update and connection to SQL Server. Please refer to “Update WRAP
LocalDB database to run in SQL Server”.
 Setup guide for WRAP v4.19- WRAP 3350
Page 8 (24)

13. After click OK a new dialogue is shown:

14. Enter needed data in the UAC (User Account Control) dialogue and
proceed. The conversion will now start:
 Setup guide for WRAP v4.19- WRAP 3350
Page 9 (24)

15. The conversion will take a while and a command window is displayed in
the background. Please be patient, this might take a few minutes.

16. At last the conversion is finished:

17. If there are more databases to be converted step 11 to step 16 is repeated.

18. Some databases will not be converted, a message like the below will then
be shown:
 Setup guide for WRAP v4.19- WRAP 3350
Page 10 (24)

19. At last the dialogue will show up with the converted database attached:

20. In order to connect the WRAP demo database, click the button “Add Demo
database” The button “Convert Access DB…” can be used for converting
WRAP databases in MS Access format to LocalDB format

21. Click Exit so save any changes and exit ChangeDB.

 Setup guide for WRAP v4.19- WRAP 3350
Page 11 (24)

First time start of WRAP

22. A WRAP program folder with some programs items has now been added to
your Windows Start menu.
Browse… opens Windows explorer in the folder where the WRAP
documentation is installed.
ChangeDB is used to change directory paths and connect and set up
databases to use with WRAP.
Map Data Manager is a stand-alone application for converting certain
geographical database formats into the faster and more compact proprietary
formats used by WRAP. The Map Data Manager needs a special site key.
SocketCommunicator is a tool for testing the WRAP API. The WRAP
API needs a special site key.
WRAP is the main application.
WRAP Getting Acquainted is an introduction to WRAP.
WRAP Product Specification specifies the features of WRAP.
WRAP Tutorial is document with some exercises.
WRAP User’s Manual is the manual with a lot of examples.

23. You should now be able to launch the WRAP application using the WRAP
shortcut.
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.19- WRAP 3350
Page 12 (24)

24. The following dialogue is shown in the start-up sequence until a licensed
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 [email protected] and await the return of the “Site key”
from WRAP International AB. The returned Site Key shall be entered into
the Site Key field.

25. A dialogue for the memory usage is shown. Please read carefully and select
a proper value using the slide bar.

The setting can later be changed under menu Settings – Memory usage
limit.
 Setup guide for WRAP v4.19- WRAP 3350
Page 13 (24)

26. Now you can enter the world of WRAP. Please see the document “Getting
acquainted with WRAP”
 Setup guide for WRAP v4.19- WRAP 3350
Page 14 (24)

Databases
From WRAP v4.19 the standard database engine used in WRAP is SQL Server. The
connected MS Access databases will be migrated to LocalDB as described at page 6.
LocalDB is a minimal version of the MS SQL Server database engine and can be use in stand-
alone installations of WRAP. In a multi-user environment SQL Server shall be used.
Scripts to create databases in SQL Server and Oracle are provided. The scripts are located in
in the folder ClientServerWRAPDB\SQL Server of the installation medium.

Creating a new WRAPDB database in SQL server.

27. Execute CreateWRAPDBInSQLServer. The default name of the
database instance is WRAPDB. If another name is wanted replace
WRAPDB on the lines:
* create database "WRAPDB"
* use "WRAPDB"

28. Execute the script UpdateWRAPDBInSQLServers.sql on the database.

If another name is used replace WRAPDB on the lines:
* use "WRAPDB"

29. Execute the script GrantPermissions.sql. If another name is used

replace WRAPDB on the line:
* use "WRAPDB"

Refer also to Read Me WRAP SQL Server database.txt on the installation medium.
 Setup guide for WRAP v4.19- WRAP 3350
Page 15 (24)

Configuration of Network License Server

To use a license server please install WRAP on both the server machine and the machines on
which WRAP shall run. Note! The licence server must be a physical server and cannot be
virtualized.

Step Action Check

1. On the license server: License the server by starting WRAP and send the
site code to [email protected]. Refer to the licensing procedure in section “First
time start of WRAP”. Close WRAP on the server.

2. On the license server: Start the EasyLicenseNetworkConfig in the folder

C:\ProgramData\WRAP\CrypKey. Note that this is a hidden folder in
Windows.

3. Select license type ”Server”, enable TCPIP and enter the IP-address of the
server. The default port is 4758. (Note that the IP address in the figure
below is just an example.). Press OK.

4. On the clients: Start the EasyLicenseNetworkConfig in the folder

C:\ProgramData\WRAP\CrypKey.
 Setup guide for WRAP v4.19- WRAP 3350
Page 16 (24)

Step Action Check

Select license type ”Client”, enable TCPIP and enter the IP-address of the
server. If the default port is not used add :port number after the address.

Function:
When starting the software WRAP checks with the license server if a valid license is
available. If there is a license available, it is kept by the client WRAP instance until WRAP is
shut-down. At that time the license is returned to the license server. Note that the client must
have contact with the license server when WRAP is running since the license is checked now
and then when WRAP is running.
There is no inactivity time limit within the software that releases the license automatically, so
if several users are using a single license it is important to shut-down WRAP when done to let
other users access the license. If a networked license is used and WRAP crashes or loses
contact with the license server, the license will be released after approximately 20 minutes.

Problems:
If the EasyLicenseNetworkConfig is not started please try to start with parameter -F in a
command window.
Note that any firewall in the system must allow traffic on the port specified.
Setup guide for WRAP v4.19- WRAP 3350
Page 17 (24)
 Setup guide for WRAP v4.19- WRAP 3350
Page 18 (24)

FAQ - Frequently asked questions

Installation
1. Q: Why is a message “Installation cancelled. Your WRAP version is too old for
this update! Please contact WRAP International ([email protected]) for further
information.” shown?
A: This message appears when WRAP v4.5.1 or older is installed on the computer.
Please verify that you are entitled to this update and then kill your present licence.
Send the kill code to [email protected], uninstall WRAP manually, install v4.8 and then
request for new key.
2. Q: Why is a message “Your WRAP Site key is too old for this version! Please
contact WRAP International ([email protected]) for information.” shown?
A: This message appears when WRAP v4.6.x or is installed on the computer but the
site key is not valid for this update. Please verify that you are entitled to this update
then request for new key (mail to: [email protected]).
3. Q: Why is a message “An error occurred! Please contact WRAP International
([email protected]) for further investigation.” shown?
A: Please contact WRAP International for further assistance.
Start of WRAP
4. Q: Why is a message “Authorization not present, WRAP Win is now running in
demo mode” shown?
A: The message appears if you do not have a licensed version of WRAP.
5. Q: What does this dialogue mean?

A: The way coordinates are stored in the databases is changed since version 4.16.1.0.
If you have not updated there might be a need to define which geographical datum
format any object with coordinates (i e station and sites) is saved with.
 Setup guide for WRAP v4.19- WRAP 3350
Page 19 (24)

Check all objects with the same datum and click “Apply to checked”. Repeat until all
objects are handled and the list is empty.

Note! WRAP tries to find out which datum which is the correct one. This is often
correct but not always so please check before applying the suggestion. Note also that
if there are several users defined in the database, all users must follow this procedure.

6. Q: Why is a message like below shown when starting WRAP?

A: Probably an older version of WRAP has been installed on the computer before.
Start the ChangeDB program from the start menu. On the first tab connect the WRAP
databases you want to use. If you are a new user of WRAP you should use the
database MyWRAPdB as writeable. You should also connect wrapwindb_demo in
order to been able to run the samples in the manual.

7. 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 c:\Program Data\WRAP (the folder is normally hidden.) and then
enter setupex /u to uninstall the CrypKey service. After this the computer has to be
restarted.
 Setup guide for WRAP v4.19- WRAP 3350
Page 20 (24)

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.

8. 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 the computer does 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.
9. 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. This can be done from within the main window of WRAP, see below:

10. 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.
11. Q: When updating from previous version, my edited geo settings from my old
installation show up after upgrading?
A: The WrapGeo.wgc should be copied to correct location. Copy the old wrapgeo.wgc
file into c:\Program Data\WRAP. In the older versions of WRAP the wrapgeo.wgc
was normally located in c:\program files\wrap.
 Setup guide for WRAP v4.19- WRAP 3350
Page 21 (24)

12. Q: I have installed SFAF and SMADEF plug-ins but I cannot see any different
functionality? The same applies to the CoordMan plug-in.
A: In order to use the plug-ins, please turn off WRAP and start ChangeDB. In the last
tab the plug-ins to use must be checked. Note! When using a database with the
SMADEF plug-in the first time, your organisation is set to the database and cannot
easily be changed. Please refer to the documentation.
13. Q: I have installed plug-ins but am not able to see any of them within ChangeDB.
A: The version of the plug-ins and WRAP differ.
Geographical data
14. Q: What geodata is included in the installation?
A: The 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.
15. 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 classes 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.
16. Q: Why is no geographical data shown in the Map Viewer window?
A: The problem is usually that WRAP cannot find the geographical files at the
specified search path. Check that the search paths are correct, see above. The function
“Update GeoDB paths” is very useful if the complete GeoDB directory has been
moved. Just click the button with this name and browse to the GeoDB folder to
update.

Databases
17. Q: Where are the databases installed?
A: In the common application data folder a WRAP folder is added. It is typically at
c:\Program Data\WRAP. The folder is 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.
 Setup guide for WRAP v4.19- WRAP 3350
Page 22 (24)

18. Q: Which databases are installed?

A: A demo database which comprises data for the sample projects (as read-only). An
empty database “MyWRAPdB” (as writable). This should then be the production
database used by the WRAP users. There are also two databases installed to be used
together with the Obstruction Manager tool in WRAP. They need to be connected
using ChangeDB before use.

Miscellaneous
19. Q: How are 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.
20. 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.
21. 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.
22. 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:\Users\user\AppData\Local\WRAP where user is your log in name on the computer.
The folder is 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.19- WRAP 3350
Page 23 (24)

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.
• In the shared documents folder a WRAP folder is added. It is typically at
C:\Users\Public\Public Documents\WRAP. 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 \Samples – folder with sample projects, test files and API Messages 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:\Program Data\WRAP. The folder is 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 licence 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 \MagneticModel with two files for calculating magnetic parameters.
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.
• In the user application data folder a WRAP folder is added. It is typically at
c:\Users\user\AppData\Local\WRAP. The folder is normally hidden. The
wrapgeo.wgc and the \PlugIn and \ToolSettings are copied into this folder the first
time the user starts WRAP
 Setup guide for WRAP v4.19- WRAP 3350
Page 24 (24)

• If the feature API is installed please look in the document

WRAP1974_WRAPAPIInterface.pdf for details.
•
Other files
The installation program also installs other software modules:
a. CrypKey software security.
b. Windows KB3118401 depending on the Windows version on the target
machine.
c. Intel Parallel Studio for Fortran Windows Redistributable
d. Microsoft Visual C++ Redistributable
e. NTIA/ITS HFBC is installed in c:\itshfbc
f. 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.
g. Microsoft SQL Server Migration Assistant for Access v7.2.0
h. Microsoft SQL Server Native Client 2012
i. Microsoft SQL Server LocalDB 2014
j. SQLite ODBC Driver from www.ch-werner.de
k. Firebird ODBC Driver from www.firebirdsql.org