NOKIA DATA

PACKAGE
MANAGER

Nokia Service Software User

Guide

NOKIA DATA PACKAGE

MANAGER
Owner:
Scope:
Originator:
Version:
Document ID:
Location:

Nokia, Care, GTM, Competence Management

User Guide Nokia Service Software for all Service Levels
Design for Manufacturing and Care
Version 4.0
SR1774
Salo, Finland

Page

Change History
Version
V 0.1
V 0.2
V 1.0
V 2.0
V 3.0
V 3.1
V 3.2
V 4.0

Date
Status
14.3.2011Draft
1.4.2011 Draft
5.4.2011 Draft
16.6.2011Approved
7.9.2011 Approved
16.12.2011
16.12.2011
23.12.2011
2011.50.1

Comments
According to v 2011_10_0
According to v 2011_13_0
Reviewed & approved first version
Reviewed for Global Release 2011.20.0
Reviewed for Global Release 2011.35.2
Draft Draft for Global Release 2011.50.0
Draft Envira instruction added to chapter 8
Approved
Reviewed for Global Release

Page

Table of Contents
1. General......................................................................................... 5

1.1 Legal Notice................................................................................................................ 5

1.2 License Issues............................................................................................................. 6
1.2.1 OpenSSL License...................................................................................................... 6
1.3 Nokia Online (NOL)...................................................................................................... 6
1.4 Installation path.......................................................................................................... 6

2. Prepare......................................................................................... 7
2.1
2.2
2.3
2.4
2.5
2.6
2.7

Supported OS.............................................................................................................. 7
Minimum HW Requirements........................................................................................ 7
SW Requirements........................................................................................................ 7
Other Requirements.................................................................................................... 7
Turn off User Account Control...................................................................................... 7
Data Package Manager Lite discontinued....................................................................7
Install Data Package Manager..................................................................................... 8

3. Launch Data Package Manager.....................................................12

3.1 Update Data Package manager and other applications from the Application Launcher13
3.2 Use in Online and Offline Modes................................................................................ 13
3.2.1 First Time Startup................................................................................................... 13
3.2.2 Configuring the Startup Mode................................................................................. 13
3.2.3 Temporary change between Online and Offline modes...........................................14

4. Configuration and Preferences.....................................................14

4.1
4.2
4.3
4.4

Data Packages........................................................................................................... 14
Downloads................................................................................................................. 15
Network..................................................................................................................... 15
Administrations......................................................................................................... 16

5. User Interface of the Nokia Data Package manager........................16

6. Data Package Browser.................................................................17

6.1 How to browse product software files online from Nokia Firmware Repository..........17
6.1.1 Filtering the results................................................................................................. 18
6.1.2 The Files, their size and indication about their status.............................................19
6.1.3 Downloading Files Immediately.............................................................................. 20
6.1.4 Quick Scheduling.................................................................................................... 20
6.1.5 Optional Content Files............................................................................................. 21
6.2 Local Content............................................................................................................ 21
6.3 Ongoing Browser Activities........................................................................................ 22

7. Data Package Sheduler................................................................22

7.1 Creating a new scheduled task to update all variants for same product type...........23
7.1.1 Scheduled task to update specified variants..........................................................24

8. General Instructions and Troubleshooting.....................................26

9. Availability of Product Variant Package Files from FiRe..................26
10. Reporting Errors and Change Requests.........................................26
11. Notes.......................................................................................... 27

Page

Nokia Data Package Manager User Manual

1.

GENERAL

Nokia Data Package Manager is a service software tool which provides following functions:
Real Time downloading of product software files via online connection from Nokia Firmware
Repository (FiRe)
Scheduled downloading of product software files via online connection from Nokia Firmware
Repository (FiRe)
Search function and creation of filters for the data you need to download.
Checking and organizing your locally installed product software content.
The purpose is to stop the delivery of separate Care Data Packages, and continue software
content delivery via online connection. Please note that you can also download software
content from FiRe by using the Data Package Download function in Phoenix service
software, or by using care Suite Product Support Tool in Online mode.
Important: This document does not claim to be exhaustive. The actual software install or
uninstall process may vary from this description depending on the computer hardware used,
the software already installed and the entries in the registry.
Close all applications before installing Nokia service software.
Read the information provided by the installation program carefully, it often points out
important steps in the installation!

1.1

Legal Notice
Copyright Nokia Corporation 2011. This material, including documentation and any related
computer programs, is protected by copyright controlled by Nokia Corporation. All rights are
reserved. Copying, including reproducing, storing, adapting or translating, any or all of this
material requires the prior written consent of Nokia Corporation. This material also contains
confidential information, which may not be disclosed to others without the prior written
consent of Nokia Corporation.

1.2

License Issues

1.2.1

OpenSSL License
http://www.openssl.org/source/license.html

1.3

Nokia Online (NOL)

Information and software for all Nokia products is available on Nokia Online (NOL)
(www.nokiaonline.com). After logging in with a valid user name and password, select the Care
Service.
For documents which have been released after May 31st 2010, please see KICS Information
Page (https://icknowledge.online.nokia.com). Service & Repair related documentation can be
found in S&R Documents - category
For documents which have been released before May 31st 2010, please see Support Library

Page

If you do not have access to NOL, please go to the site and click on Registration Request.

1.4

Installation path
A default installation path is: C:\Program Files\Nokia\Nokia Care Suite\ Data Package
Manager.

Page

2.

PREPARE

2.1

Supported OS

Microsoft Windows XP SP2

Microsoft Windows 7
Please make sure you have all the latest Windows updates installed on your PC.

Minimum HW Requirements

2.2

CPU: Intel or Intel compatible 1 GHz or faster

RAM: Minimum 1 GB
Hard Disk: 300 MB available
Product-specific service cable or service adapter

SW Requirements

2.3

DOT.NET 2.0 Service Pack 2 or higher

MSXLM 6.0
Data Package Manager installation package: NokiaDataPackageManager
_<year>_<week>_<build_number>.msi where year, week and build number are variable
Online access to Internet and Nokia Firmware Repository (FiRe) for product-specific data files
Optionally locally installed product specific data files from Nokia Online (NOL)

Other Requirements

2.4

2.5

Installation must be done with Administrator rights

Internet connection

Turn off User Account Control

NOTE: This applies to Microsoft Windows 7 users only.

Before you start installation the User Account Control should be turned off. Go to Control Panel ->
User accounts ->Turn user account control on /off -> Uncheck UAC box -> click OK. Then reboot
your PC.

2.6

Data Package Manager Lite discontinued

New versions of the Data Package Manager Lite version are not released. The full version of Data
Package Manager is the only version to be used on all service levels.

Page

Install
2.7

Install Data Package Manager

You can install Nokia Data Package Manager on top of previous versions.
1. Locate file NokiaDataPackageManager _<year>_<week>_<build_number>.msi where
year, week and build number are variable.
2. Double-click NokiaDataPackageManager _<year>_<week>_<build_number>.msi and
follow the prompts for installation.
3. Click Next when space requirements computing is done.

4. Select I accept and then click Next.

5. Enter user name and organization.

Page

6. Click Install to begin installation. You can select a desktop shortcut to be created.

7. Wait while Nokia Data Package Manager is being installed.

Page

8. Click Finish.

Page

10

LAUNCH DATA PACKAGE MANAGER

3.

You can launch Nokia Data Package Manager in the following ways:

If the Shortcut on desktop option was selected during installation, double-click the Nokia
Data Package Manager shortcut on the desktop.

If you used the default installation path, launch the application from C:\Program
Files\Nokia\Nokia Care Suite \ Data Package Manager\ Bin\
DataPackageManager.exe
Or start Nokia Care Suite Application Launcher from Start -> Programs > Nokia -> Nokia
Care Suite > Launch Nokia Care Suite. Then start Nokia Data Package Manager from
there
NOTE: The selection of applications shown in the Application Launcher depends on what
Nokia Tools are installed on your PC.

Application Launcher

Page

11

3.1

Update Data Package manager and other applications from the Application Launcher
If there is an online connection to Firmware Repository (FiRe), the Application Launcher also
enables you to check for updates and install them if available.
1. To check available updates, click on Updates and click Check for updates link.
2. If update is available click Download.
3. After the update is downloaded click Install

3.2

Use in Online and Offline Modes

Like other Nokia Care Suite based applications, the Data Package Manager can be used in both
online and offline modes.
Online mode with Internet connection is needed when you want to check product
software online and download data to your local drive.
In offline mode without Internet Connection all other functions except browsing and
downloading of new content can be done.

3.2.1

First Time Startup

When Data Package manager is launched for the first time, operating mode is by default online.
With connection to Internet, DPM is launched and you can use all functions.
If you dont have Internet connection, following message will be shown. To continue in offline
mode, select Yes.

3.2.2

Configuring the Startup Mode

You can determine the startup mode from File->Preferences->Administrations menu.

Every time the application is launched, it works in the operating mode set in this menu even if
the mode had been temporarily changed to different one
3.2.3

Temporary change between Online and Offline modes

Current operating mode is indicated in the bottom right hand corner of the screen. If temporary
change in operating mode is needed, you can make the change from File-> Work Online /
Work Offline menu. If you change from online to offline mode and have ongoing activities,
you will be shown a warning.

Page

12

4.

CONFIGURATION AND PREFERENCES

The settings of the Data Package Manager can be determined in File-> Preferences menu.

4.1

Data Packages
In this view you can configure where you want the files to be downloaded. The location can be a
folder on your PC or on a network server. Default location is the common data package location
used by all Care Suite family applications and Phoenix service software.

4.2

Use default folder when using Care Suite or Phoenix in one workstation only
You can define a preferred folder where you have installed Data Packages previously if it is not
the default folder. You can also define a folder on a network server which is shared by multiple
workstations.
Integration Verification verifies that checksum of the downloaded file is correct

Downloads
In this view you can configure options for large content file downloading to ensure optimal
downloading times

Page

13

4.3

Always ask will make sure you are asked for the need of large content files when download
is started
Select Always download if you know that you always need the content files. NOTE: think
about the increased download time and storage space needed on your hard disk!
Select Never download if you never want to download content files.

Network
In this view you can configure network and firewall settings

4.4

Administrations
In this view you can configure options for startup preferences.

Page

14

5.

USER INTERFACE OF THE NOKIA DATA PACKAGE MANAGER

The User Interface of the Data Package Manager is split into two views according to functions.
You can change between these two views by using the buttons in the left bottom hand corner of
the screen
Data Package Browser for browsing and real time downloading of product software files
Data Package Scheduler for creating download activities which are scheduled to any
chosen time

6.

DATA PACKAGE BROWSER

Data Package Browser has three functional parts
Online Server for browsing and downloading software content from Nokia Firmware
Repository
Local Content for browsing software content from your local storage
Ongoing Browser Activities for viewing active downloads

6.1

How to browse product software files online from Nokia Firmware Repository
In the Data Package Browser / Online Server view you can define product type for which
you want to look for software content. When you select Search, software information for all
product variants (= product codes) of the type will be shown. Optionally you can also specify the
product code. If product code is also defined, software information specific only for this variant
will be shown.
You can change the width of the columns for example to be able to see full variant name. You can
move upwards and downwards on the list by moving the slider in the right hand side of the view,
and from left to right by using the slider at the bottom.

Page

15

6.1.1

Filtering the results

The amount of variants depends on the product type and it is shown at the bottom of the UI. To
ease up your work, you may filter the results. When Enable Result Filtering - checkbox is
CHECKED, you can type filtering criteria to Name, Product code and SW version fields. Below is
an example of a filter created by using part of the variant name.
You can also filter the information in ascending (small arrow points upwards) or descending (small
arrow points downwards) order. Just click the field you want, and the small arrow will appear.
Below an example where variants have been set do descending order based on product code in
addition to the variant name.

When Enable Filtering by Region - checkbox is CHECKED, it is possible to view variants

based on sales region. Please note that currently this information is not available for all product
Page

16

variants and <unavailable> may be shown. Please note that when Regional Filtering is enabled,
queries may take considerably longer than without it.

6.1.2

The Files, their size and indication about their status

The UI of the Data Package Manager provides variety of information concerning the variant files,
which are always of the latest available versions.

Name, Region and Product Code identify the variant and sales area / country /
customer
SW Version shown can be used to check if your locally installed files are up to date
Status indicates progress of the download. You can control the download by clicking the
small icon next to the status description.
Progress bar gives an estimation about how much of the download is completed in
percentages
Firmware files are the product software files which are needed for all product types.
They are the kind of files which until now are included in the traditional product specific
Data Packages
Content files mean additional content files, which may not be needed for all product
types. These files contain movies, applications and other optional content, making them
very large in size. They are not typically a part of a traditional product specific Data
Package but must be installed separately to the product specific folder on PC.
Page

17

6.1.3

Please make sure to check the file size, because it has impact on the
downloading time and required local disk space. If the size of the file is shown as
0.00 B it does not exist.
Estimated Time is estimation about the download time based on the network speed at a
given time; it may change with the variations in network speed.

The small icons indicate the status of files on local disk

Downloading Files Immediately

Before you start downloading, please always check the size of the file(s) and the space you have
available on your hard disk.
To select the files you want to download:
Click the small arrow to the right of the status or
Click the variant name and select Download Selected
You can make multiple selections by using SHIFT and CTRL keys and then clicking
variant names

6.1.4

Quick Scheduling

If you dont want to download files immediately, it is possible to schedule the download
to happen at a more convenient time. Schedule Selected will open the Task Scheduler
UI where you can specify the desired downloading time and other details. Please see
chapter 7 Data Package Scheduler.

Page

18

6.1.5

Optional Content Files

If the variant uses optional content files, you will be prompted if you want to download them as
well. The setting in File-> Preferences->Downloads-> Content Files is set to Always
Ask by default. You can change this setting if needed.

6.2

Local Content
In this view you can check the status of the content in your local storage. The content of the local
storage is compared to the latest situation in FiRe. It is possible to check if updated versions are
available, update and also delete files.
The dropdown in the left top corner will show a list of product types for which you have
content locally.
Product codes of the selected type will be shown when you select Search
Status will show Up To Date if no updates are available, Out of Date if updates are
available
When update is available, you can start update by electing Download Selected
You can remove variant files from your local folder if you dont need any more.

NOTE: The local content is refreshed only when you start Data Package Manager Application or
press the
Refresh button located next to Product Type. If you have ongoing activities,
the status will not get refreshed automatically.

Page

19

6.3

Ongoing Browser Activities

You can check the status of ongoing activities from this view, and control them. It is possible to
suspend or restart activities.

7.

DATA PACKAGE SHEDULER

Data Package Scheduler can be used to create scheduled downloads at any time. It has two
panes:
Tasks shows the list of scheduled tasks and their status.
Task Details shows the download status of variants within a selected task

New Create new scheduled download to task list

Edit Edit existing scheduled download on the task list
Remove Removes existing scheduled downloads from task list

Page

20

7.1

Creating a new scheduled task to update all variants for same product type.
Please note that with option Update All Variant Content selected you can not specify
individual product codes and Content File downloading is disabled! If a product has a large
amount of variants, download takes a long time!

Select New, Schedule Task UI opens

Give the download a suitable name
Provide Product Type designator
Provide the desired downloading time. Please note that the task may be started within +/30 minutes of the desired time to balance the network and server load.
Select Update All variants
Select OK

Page

21

7.1.1

Scheduled task to update specified variants

Select New to open Schedule Task UI

Give the download a suitable name which described the content
Provide Product Type designator
Provide the desired downloading time. Please note that the task may be started within +/30 minutes of the desired time to balance the network and server load.
Provide Product Code ( you can also type or paste several product codes to this field)
Select Add, code will be added to list. You can add multiple product codes of the same
product type to the same event, and remove them from list by selecting the variant and
Remove
You can choose if you want to download optional content files or not
To display the variant name for selected product code, select Load Variant names
Variant support is checked when you select Load Variant names. If there is no
software for the variant in FiRe, and you try to add it into the task you will be given a
warning:

When ready, select OK. Tasks will be moved to list

Page

22

On the Tasks - pane you can see:

The list of tasks, which you can edit or remove

The progress of each task in Task Details pane
Next Run time, Last Run Time
You can sort the information on UI based on task name, product type, and status.

On the Task details- pane you can see status for each variant included in a specific task
When a task has been completed, it will disappear from the list of tasks

Page

23

8.

GENERAL INSTRUCTIONS AND TROUBLESHOOTING

9.

When using DPM to download variants to a shared server, you should make sure that
individual work stations are not using the data in the folder at the same time. Please
schedule your download tasks so that simultaneous update and use of the
same files is not possible. This is because old data is removed before new data is
downloaded.
Incomplete Remote Files icon on the Browser and Local Content UIs means that some
files for variant are missing from FiRe. No action is required.
Downloading speed and time may vary based on network speed. When data package files
for certain product code are downloaded for the first time, downloading may take much
longer than usually. This happens because when the first download happens, data is
transferred from Nokia databases to caching servers. Next downloads will be faster,
because data is already buffered on caching servers which are located close to the end
users.
When Regional Filtering is enabled, queries to FiRe may take considerably longer than
without it.
Data Package Manager Lite (KICS article SR1786) was launched for Level 1 and 2 services
in June 2011. Since version 2011.35.2 the Full version of Data Package
Manager is the only available version for all service levels. Before you install
Data Package Manager 2011.35.2 please uninstall Data Package Manager Lite
(v 2011.24.1) from your PC.
Nokia Service Software Applications (Phoenix, Care Suite etc) include a tool called Envira
for collecting log files from different locations. The user does not need to know the
locations of different files, Envira will collect log files from all locations and create a
compressed ZIP file which can then be sent to Nokia for investigation
When experiencing problems with the Data Package Manager Tool:
o Make sure you have the latest Care Suite Product Support Tool (PST) installed on
the same PC.
o Reproduce the problem with Data Package Manager.
o Close Data Package Manager
o Start Care Suite PST
o Start Envira tool from Help Troubleshooting menu
o Specify a time span from which the files are collected (Minimum 1 Hour)
o Press Create ZIP and wait for a while for the operation to be completed
o Create a GENIUS case to Nokia and attach the ZIP file with logs to it

If files for any variant are missing from FiRe, please create a Genius case to the product
program in question. Please specify product and product code clearly.

AVAILABILITY OF PRODUCT VARIANT PACKAGE FILES FROM FIRE

All product specific variant package files have been uploaded to the Nokia Firmware
Repository since the launch of Nokia N8-00 (RM-596). For products which are older
than the N8-00, availability of all files is not guaranteed.
Page

24

10.

If you notice that files are missing from the Firmware Repository, please create a case to
the GENIUS tool to the product program in question.
In the Genius case, please state the product type, product code and files which are
missing (Mass Memory Content files, other service file package files etc)
Genius cases will be processed, and if technically possible files may be uploaded to FiRe.

REPORTING ERRORS AND CHANGE REQUESTS

If you are not able to solve problems locally, a case can be escalated to local Nokia care or by
using the GENIUS tool directly.

11.

NOTES
This product includes software developed by the OpenSSL Project for use in the OpenSSL
Toolkit (http://www.openssl.org/).
Copyright (c) 1998-2005 The OpenSSL Project. All rights reserved.
Copyright (c) 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved.
OpenSSL license text can be found from http://www.openssl.org/source/license.html.
Microsoft, Windows, Windows Vista and Windows XP are either registered trademarks or
trademarks of Microsoft Corporation in the United States and/or other countries.

Page

25