vodafone mobile broadband via the phone - callertunes · 4 supported devices the following list...

Vodafone Mobile Broadband via the phone

Administrator’s guide for Corporate Installation

Make the most of now

Contents

Product features 3

Requirements 3

Operating system requirements 3

Hardware requirements 3

Constraints 3

Supported devices 4

Customisation of the installation 5

Components of the Vodafone Mobile Broadband via the phone 5

General use of MSI command line parameters 5

Command line parameters for the VTP installer 7

Lock OpCo 8

Lock billing type 9

Disable the software update module 9

Adding custom connections to the VMC via the phone installer 9

Adding custom connections to the ‘User Connections.xml 9

Changing the language settings 10

Command line parameters for the VTP Full installer 11

Disable RIM® driver installation 11

Enable manual start and manual stop of VTP 11

Additional drivers 11

Configuring VMC VTP installer using a transform file 11

Creating a transform file 12

General: Create a transform file 12

Task: Applying a language transform file 13

Task: Change MSI properties 14

Task: Modify and replace a file 15

Uninstall Vodafone Mobile Broadband via the phone (Full) 17

Uninstall from Add or Remove programs 17

Command line uninstall (No UI) 17

Deployment of VTP using a Software Management System 18

Getting started 18

Applying VTP to your Software Management System 18

Deployment process 18

3

Product features

Requirements This section describes the hardware and software requirements for the Vodafone Mobile Broadband via the phone (VTP) software. The requirements refer to Vodafone via the phone version 2.3.20 and may therefore be outdated. Please check the latest release documents of VTP for new or more information.

Operating system requirements Vodafone via the phone requires one of the following operating systems:

• Windows® XP® and Service Pack 2

• Windows Vista® 32/64 Bit.

Hardware requirements The hardware requirements for Vodafone VTP are described below.

• CPU: Minimum Pentium®/Celeron® 233 MHz; Recommended: Pentium 300 MHz

• RAM: Minimum 128 MB; Recommended 256 MB

• HDD: 20 MB free space

• A supported Mobile Device (See page 4)

• USB connection cable between PC and Mobile Device.

.

Constraints The following constraints are known when using VTP. Please note that these constraints refer to Vodafone VTP version 2.3.20 and may be outdated. Please check the latest Vodafone VTP release documents for new or more information.

• Exclusive access to the USB port is required

• Using a USB hub to connect to the mobile device may cause problems

• Admin user rights are required for installation.

Please note, that the operating system used may require a higher level of computer hardware. Check the release notes of your operating system for more information.

4

Supported devices

The following list shows all supported devices. The list refers to VTP version 2.3.20 and may be outdated. Please check the latest VTP release documents for more or new information.

Device IMEI IMSI Device Name MSISDN Data

connection

Embedded solutions

LG Arena KM900 Yes Yes Yes Yes Yes**

LG KF310 Yes Yes Yes Yes Yes**

LG KP270 Yes Yes Yes No Yes**

LG Renoir KC910 Yes Yes Yes Yes Yes**

Samsung Loches S8300 Yes Yes Yes No Yes**

Samsung Steel SGH-L810V

Yes Yes Yes No Yes**

Vodafone V724 FM Yes Yes Yes Yes Yes**

Vodafone V725 (firmware V107)

Yes Yes Yes Yes Yes

Vodafone V735 Yes Yes Yes Yes Yes**



Vodafone V830 Yes Yes Yes Yes Yes

Vodafone V830i Yes Yes Yes Yes Yes**

VTP Full supported devices

BlackBerry® 9000 Bold Indy

Yes Yes Yes No Yes**

BlackBerry® 9500 Storm Yes Yes Yes No Yes**

Nokia 5300 Yes Yes Yes Yes Yes**



Nokia 6120 classic Yes Yes Yes No Yes**



Nokia 6230i Yes Yes Yes No Yes**

Nokia 6233 (6234 in South Africa)

Yes Yes Yes Yes Yes**







Nokia E51 Yes Yes Yes Yes Yes**

Nokia E65 Yes Yes Yes Yes Yes**

Nokia N70 Yes Yes Yes Yes Yes**







5

Nokia N95 8GB Yes Yes Yes Yes Yes**


Samsung J700 Yes Yes Yes No Yes**

Samsung L760 Yes Yes Yes No Yes**

Samsung L770 Yes Yes Yes No Yes**

Samsung SGH E250 Yes Yes Yes No Yes**

Samsung SGH ZV10 Yes Yes Yes No Yes**

Samsung SGH ZV60 Yes Yes Yes No Yes**

Samsung U700 Yes Yes Yes No Yes**

Samsung U900 Yes Yes Yes No Yes**

Sony Ericsson C902 Yes Yes Yes No Yes**

Sony Ericsson C905 Yes Yes Yes No Yes

Sony Ericsson K770i Yes Yes Yes No Yes

Sony Ericsson K800i Yes Yes Yes No Yes

Sony Ericsson V640i Yes Yes Yes No Yes

Sony Ericsson W880i Yes Yes Yes No Yes



Sony Ericsson W980i Yes Yes Yes No Yes**

** The device does not present a second port that can be used for concurrent data connection and other information collection

Customisation of the installation

Vodafone Mobile Broadband via the phone is available as a device embedded solution (on a limited range of devices) as well as a standalone solution known as VTP Full. This section is only relevant for customers using the Full solution. Users of an embedded version will not be able to customise the installation.

Components of the VTP Full solution Vodafone Mobile Broadband via the phone VTP (Full) consists of two MSI installers:

• Vodafone Mobile Broadband VTP.msi

• Vodafone Mobile Broadband VTP.Full.msi.

The first installer contains the main application.

The second installer contains the VTP Full specific components and the RIM® BlackBerry® drivers.

The installers must be executed in the above order. The following sections describe the command line parameters for both MSI installers.

General use of MSI command line parameters MSI packages can be generally configured with command line parameters. This allows the settings of Vodafone VTP to be changed without making any changes to the installation package.

The following code is a sample MSI command line:

• Msiexec.exe /i “Vodafone Mobile Broadband via the phone.msi” LOCKED_OPCO=”23415” /norestart /qn

• Msiexec.exe calls the Microsoft Windows Installer which installs the MSI-Package

• /i “msi filename” is the command for installation of a MSI-Package

• OPCO_PROP=”OPCO Code” ” determines which operator network will be installed.

• /norestart suppresses a reboot if required

• /qn sets silent installation (No User interface).

6

This MSI command line would install the Vodafone VTP software silently (without any user interface, that means the user has no interactation with the installation procedure) with the Vodafone UK OPCO (OPCO = 23415) and without a reboot of the system after the installation.

MSI command line parameters can be called directly via the Windows command line:

Or they can be executed from a batch file for multiple use:

Msiexec.exe /i “D:\Vodafone Mobile Broadband via the phone.msi” LOCKED_OPCO=”23415” /norestart /qn.

Please note that the current file location of the MSI file must be included in the command, if it is not in the same location as the Msiexec.exe or the batch file.

7

Command line parameters for the Vodafone Mobile Broadband via the phone installerThe following MSI command line parameters can be used to configure the MSI-package ‘Vodafone Mobile Broadband via the phone.msi’:

Parameter Values Description

/i Package|Product code Installs or configures a product

/x or /uninstalll Package|Product code Uninstalls/Removes a product

/l [i|w|e|a|r|u|c|m|p|v|+|!]Logfile Specifies the log file path and indicates the flags to be logged i - Status messages w - Non-fatal warnings e - All error messages a - Startup of actions r - Action-specific records u - User requests c - Initial UI parameters m - Out-of-memory or fatal exit information o - Out-of-disk-space messages p - Terminal properties v - Verbose output x - Extra de-bugging information + - Append to existing log file ! - Flush each line to the log * - Log all information, except for v and x options

/q n|b|r|f Sets user interface level n - No UI at all - ‘silent install’ b - Basic UI - small progress bars displayed, but not interactive r - Reduced UI - standard windows displayed to report progress, but not interactive f - Full UI (default) - fully interactive

/norestart --- Do not restart and do not show message box for restart request

TRANSFORMS Transform file name Applies a Transform file to the MSI package

LOCKED_BILLING_TYPE Contract PayAndGo

Defines the billing type Not needed when using LOCKED_CONNECTION

LOCKED_CONNECTION Vodafone UK Contract … More values are detailed in the FAQ section or in the file connections.xml or userconnections.xml

Installs a connection type specified in the connections.xml or userconnections.xml

INSTALL_FLEXNET 1 (Default) 0

Installs or disables the Flexnet Update Software

8

Lock OpCo

With the command line parameter LOCKED_OPCO the software can be locked to a specific operator. For example: LOCKED_OPCO=”23415”

VTP supports the following operators:

Embedded VTP Full

Operator Opco EULA EULA Language

EULA Language

EULA Language

Vodafone UK 23415 UK English UK English

Airtel-Vodafone 23403 General English General English

A1 23201 General English General English

Bel Proximus 20601 Belgium English Belgium French

Vodafone.de 26202 Germany German German German

vodafone ES 21401 Spain Spanish Spain Spanish

vodafone IT 22210 Italy Italian Italy Italian

vodafone P 26801 Portugal Portuguese Portugal Portuguese

SFR 20810 France French France French

Vodafone NL 20404 Netherlands Dutch Netherlands Dutch

Vodafone IE 27201 Ireland English Ireland English

VF SE 24006 General English General English

Vodafone HU 21670 Hungary Hungarian Hungary Hungarian

Vodafone Greece 20205 Greece Greek Greece Greek

Vodafone NZ 53001 NZ English NZ English

Vodafone AU 50503 Australia English Australia English

Vodafone Malta 27801 General English General English

Vodafone EG 60202 Egypt English Egypt English

Vodacom 65501 South Africa English South Africa English

HR VIP 21910 Croatia English Croatia Croatian

Si.mobil-Vodafone 29340 General English General English

FI Elisa 24405 General English General English

TDC 23801 General English General English

TDC SONG Norway 2380171 General English General English

Zain BH 42602 General English General English

KT MTCNet 41902 General English General English

EE Elisa 24802 General English General English

Elisa Estonia 24802 General English General English

Vodafone Fiji 54201 General English General English

Vodafone Iceland 27402 General English General English

L LUXGSM 27001 General English General English

Swisscom 22801 General English General English

CYTAMOBILE-VODAFONE

28001 General English General English

Vodafone RO 22601 Romania Romanian Romania Romanian

SmarTone-Vodafone 45406 Hong Kong English Hong Kong English

M – Tel 28401 Bulgaria Bulgarian Bulgaria Bulgarian

Vodafone CZ 23003 Czech Czech Czech Czech

IND Excelcom 51011 General English General English

Bite Latvija 24705 Latvian Latvian Latvian Latvian

Bite Lietuva 24602 Lithuanian Lithuanian Lithuanian Lithuanian

Celcom Malaysia 50219 Malaysia English Malaysia English

SGP-M1-3GSM 52503 General English General English

SRI DIALOG 41302 Sri Lanka English Sri Lanka English

9

VODAFONE TR 28602 Turkey Tukish Turkey Turkish

Vodafone India Various India English India English

Vodafone Albania 27602 General English General English

Vodafone JP 44020 General English General English

Lock billing type

VTP can be locked to a specific billing type by using the parameter LOCKED_BILLING_TYPE. Example: LOCKED_BILLING_TYPE=”Contract”

Valid settings are:

• Contract

• PayAndGo.

If this setting used, the user will not be prompted to select the billing type on first run.

Disable the software update module The Flexnet software update feature is deployed by default. This can be suppressed using: INSTALL_FLEXNET=0.

Adding custom connections to the VTP installer To define a custom network connection for VTP, the connection must be added in the “userconnections.xml” file and selected by using the LOCKED_CONNECTION-Parameter. This section describes how custom connection can be added and applied.

Adding custom connections to the ‘UserConnections.xml’ The file “userconnections.xml” can be found in the following path: <VTP install folder>CommonAppData\Vodafone\Via the phone.

The custom connection can be added in the XML-file. The structure is the following: <Connection type=”user” opcode=”” opcodeName=””>

<name>Dummy connection</name>

<apn>

<apn>apn.dummy.com</apn>

<username>username</username>

<password>pass</password>

<dns1>1.2.3.4</dns1>

<dns2>6.7.8.9</dns2>

</apn>

<security>

<pap>disabled</pap>

<spap>disabled</spap>

<chap>disabled</chap>

<mschap>disabled</mschap>

<mschap2>enabled</mschap2>

<mschapwinlogin>enabled</mschapwinlogin>

</security>

<connectionbehaviour>manual</connectionbehaviour>

<billshock>enabled</billshock>

<firstTimeSetupEnabled>disabled</firstTimeSetupEnabled>

</connection>

10

The elements are described in the following list:

Element Values Description

<Connection type=”” opcode=”” opcodeName=””>

String type � Should always be set to 'user' opcode � Operator Code opcodeName � Operator Name

Name String The name of the connection

apn String The name of the APN e.g. apn.vodafone.de

Username String The username for the connection

Password String The password for the connection

Dns1, dns2 0.0.0.0 – 255.255.255.255 The DNS servers for the connection

Pap enabled disabled

Shall Pap be enabled

Spap enabled disabled

Shall Spap be enabled

mschap enabled disabled

Shall Mschap be enabled

Mschap2 enabled disabled

Shall Mschap2 be enabled

Mschapwinlogin enabled disabled

Shall Mschapwinlogin be enabled

Connectionbehaviour manual automatic (???) prompt (???)

Which Connectionbehaviour shall be applied?

Billshock

enabled disabled

Shall Bill Shock be enabled

firstTimeSetupEnabled disabled Not supported by custom connections. Should always be set to 'disabled'

To use the customised connection add the “userconnections.xml” file to a MSI transform (See page 15) and select the connection using the LOCKED_CONNECTION-Parameter.

Changing the language settings The language of the installation process and the application can be chosen by applying one of the supplied language transform files. The language settings can be applied via MSI command line parameters: Example: msiexec /i “installer name” /qn TRANSFORMS=”2070.mst” This command sets the installation and client language to Portuguese. To combine the language settings with a customisation please make a copy of the desired language transform (e.g. 2070.mst) and apply all changes to the copy.

These languages are currently supported:

Language (Country) Decimal Code Bulgarian (Bulgaria) 1026 Czech (Czech Republic) 1029 German (Germany) 1031 Greek (Greece) 1032 Spanish (Traditional) 1034 French (France) 1036 Hungarian (Hungary) 1038 Italian (Italy) 1040 Dutch (Netherlands) 1043 Romanian (Romania) 1048 Croatian (Croatia) 1050 Turkish (Turkey) 1055 English (United Kingdom) 2057 Portuguese (Portugal) 2070

Or you can apply the language directly to the MSI (see page 15).

11

Command line parameters for the VTP Full installer Please ensure the main “Vodafone Mobile Broadband via the phone.msi” is installed prior to installing the VTP Full installer (“Vodafone Mobile Broadband via the phone Full.msi”).

Disable RIM® driver installation Drivers for RIM® devices are installed by default. This can be suppressed using:

RIM_DRIVERS=0.

Enable manual start and manual stop of VTP

The default behaviour of VTP Full is to automatically launch when a supported device is inserted and to automatically shutdown when the device currently in use is removed. This can be suppressed so that VTP does not automatically launch or shutdown when the device is inserted/removed using:

MANUALSTARTSTOP=1.

The close ('X' icon) button on the main VTP interface will fully shutdown VTP when manual start and stop is enabled instead of the default behaviour which minimises the user interface.

Due to the normal behaviour of VTP relying on an auto run mechanism to launch when a device is detected, there is no obvious method for the user to launch VTP when manual start stop mode is enabled.

It is the responsibility of the administrator/Installer to create the required end user shortcuts to launch VTP. The file specified below should be the target of any shortcuts to launch VTP manually.

<Program Files Directory>\Vodafone\Via the phone\VodafoneLauncher.exe

Additional Drivers Please note that Vodafone Mobile Broadband VTP (Full) contains drivers for RIM devices only. Additional drivers supported by VTP (see page 4) must be installed separately. The necessary driver packages are available from the respective manufacturer’s website

Configuring VTP installer using a transform file A Windows Installer Transform is a database that contains the differences between two MSI databases. A transform can only be applied to an MSI database which is going to be installed, not to a product that is already installed on a target machine. Transforms are useful for system administrators to provide variations of a single product without having to modify the original installer. Multi-language installations are also performed by a default language contained in the MSI database and several transform files for the localised strings used by each language.

In this section we will describe how a MSI transform is created, how you can replace files using a transform file and how to apply a transform file to your software installation. For the creation of the transform file we will use ORCA®, a free tool from Microsoft®. Please note that there are other tools for the creation of transform files.

The ORCA tool from Microsoft can be downloaded from the following Web page:

http://support.microsoft.com/kb/255905/EN-US

12

Creating a transform file The following instructions are describing base steps to create a transform file and to perform common tasks with the ORCA software from Microsoft. All tasks can actually be put into one single transform.

General: Create a transform file This section describes the general steps to create a transform file. For any tasks see the further sections. If you would like to change the installation language, please see page 13.

• Open Orca

You should see the following window:

• Open the original “Vodafone Mobile Broadband via the phone” MSI file

From File menu, select Open and browse to the file “Vodafone Mobile Broadband via the phone.msi”

You now see the MSI structure:

• Create a new transform

From the Transform menu, select New Transform

In the title bar you should see that the MSI file is now transformed by a Transform:

From now on, any changes to the MSI will be saved in the Transform file. The original MSI will not be changed.

• Perform any task to the transform.

See further sections for more information.

• Save the transform

Select “Generate Transform” from Transform menu.

13

Name your transform file:

Close your new transform file

• Exit Orca

Now you have created a transform file for any MSI tasks. See the next sections to learn about the changes which can be applied to the MSI via a transform file

Task: Applying a language transform file To set the installation language of VTP without a MSI command, you can apply the language transform file directly to the MSI transform. Please note that the language transform file must be applied before any other change. The steps are described below.

• Open the original “Vodafone Mobile broadband via the phone” MSI file.

From File menu, select Open and browse to the file “Vodafone Mobile Broadband via the phone.msi.”

From the file menu, select Open and browse to the file ‘Vodafone Mobile Broadband via the phone.msi’

Apply the language transform file

Select “Apply Transform…” in the Transform menu:

14

Choose the language transform file you would like to apply:

The green bars on the left pane indicate the applied language settings:

You can now apply further changes (see other tasks) or save the transform file (See page12).

Task: Change MSI properties The installation process can be configured using MSI properties. page 5 describes how to configure the installation via the MSI command line parameters. The parameters can also be applied directly in an MSI transform. The result is the same as using command line parameters.

To change MSI properties, please follow these steps (a transform file must already have been created, see page 12):

• Select the “Property” table in the left pane:

• Choose the property you like to change:

15

Apply the change:

The green bars indicate a change in the MSI transform. You can now apply further changes (see other tasks) or save the transform file (See page 12).

Property Values Description

LOCKED_OPCO 23415 for Vodafone UK 26202 for Vodafone DE … More values are detailed in the FAQ section or in the file connections.xml

Determines the operator network to be installed Not needed when using LOCKED_CONNECTION







Task: Modify and replace a file This section describes how to modify and replace a file from Vodafone via the phone. As an example the file “UserConnections.xml” will be modified and replaced.

• Browse to the file “UserConnections.xml” and make a copy for backup

• Open the file “UserConnections.xml” with a text editor.

16

• Add your modifications to the XML-file (see page 9 for more information) and save the file:

• Check the size of the modified file

Right-click the modified file and select Properties

The file size is shown in the General tab. Please remember the file size in the parentheses.

In Orca please follow these steps (a transform file must already have been created, see page 12).

• In the left pane, select the file table.

• Select the modified file in the right pane:

17

• Replace the file size in the column “FileSize”:

You can now apply further changes (see other tasks) or save the transform file (see page 12).

Uninstall Vodafone Mobile connect via the phone (Full)

This section describes the two ways in which VTP (Full) can be uninstalled.

Uninstall from Add or Remove programs Following the correct installation of both the “Vodafone Mobile Broadband via the phone.msi” and “ Vodafone Mobile Broadband via the phone Full.msi” there will be a single entry in Add or Remove Programs Named “Vodafone Mobile Broadband via the phone”.

To uninstall VTP simply select to remove this application. This will remove both the msi's installed during the install procedure

Command line Uninstall (No UI) VTP can be uninstalled from the command line using msiexec.exe.

Both the “Vodafone Mobile Broadband via the phone.msi” and “Vodafone Mobile Broadband via the phone Full.msi” must be uninstalled in the reverse order they where installed. So the VTP Full msi must be uninstalled first.

The commands for uninstalling each msi are listed below.

Vodafone Mobile Broadband VTP.MSI:

• msiexec.exe /x {34A0FF07-F11A-4157-84A3-92F8AD688CBF} /qn

Vodafone Mobile Broadband VTP Full.MSI:

• msiexec.exe /x {E61D4E96-34D3-4B7B-BA0C-337D540D22EB} /qn

18

Deployment of Vodafone Mobile Broadband via the phone using a Software Management System

This section gives a description of the general deployment process of VTP.

Getting started Before configuring the automatic deployment of VTP, please make sure you have all necessary files for the software installation. Please confirm that the software is correctly configured and all customisations have been applied. We recommend that you use a test environment to check the installation package before deployment.

Applying VTP to your Software Management System After passing all tests, the software can be applied to your Software Management System (SMS). At this point we abstract from technical details, because these strongly depend on your corporate software environment and the SMS you are using. Please refer to your SMS documentation.

Generally there are two ways to deploy your software package:

• As an MSI Package

• As a single executable.

When deploying an MSI package you can control the configuration via your Software Management System (refer to your SMS documentation). Alternatively, you can build a single executable for your software package using a third-party tool (for example Winzip® or Installshield®). In this case, the SMS is used for deployment only. All configurations are made in the executable file and cannot be controlled via the SMS. Please note, that depending on your SMS other package configurations can be possible. Refer to your SMS documentation for the best way to deploy your software package.

Deployment process The Software Management System (SMS) deploys your software package to all designated clients. Depending on your SMS the installation will be executed on the target systems. Please note that the installation of VTP requires admin rights. After the installation is complete the software is ready for use.

19

Appendix A VTP MSI command line parameter




/l [i|w|e|a|r|u|c|m|p|v|+|!]Logfile Specifies the log file path and indicates the flags to be logged. i - Status messages w - Non-fatal warnings e - All error messages a - Startup of actions r - Action-specific records u - User requests c - Initial UI parameters m - Out-of-memory or fatal exit information o - Out-of-disk-space messages p - Terminal properties v - Verbose output x - Extra de-bugging information + - Append to existing log file ! - Flush each line to the log * - Log all information, except for v and x options


/norestart --- Do not restart and do not show message box for restart request


Determines the operator network to be installed. Not needed when using LOCKED_CONNECTION




Installs a connection type specified in the connections.xml or userconnections.xml.



20

Appendix B VTP MSI properties

Property Values Description


Determines the operator network to be installed. Not needed when using LOCKED_CONNECTION







Appendix C VTP Full MSI command line parameter




/l [i|w|e|a|r|u|c|m|p|v|+|!]Logfile Specifies the log file path and indicates the flags to be logged. i - Status messages w – Non-fatal warnings e - All error messages a - Startup of actions r - Action-specific records u - User requests c - Initial UI parameters m - Out-of-memory or fatal exit information o - Out-of-disk-space messages p - Terminal properties v - Verbose output x - Extra de-bugging information + - Append to existing log file ! - Flush each line to the log * - Log all information, except for v and x options


/norestart --- Do not restart and do not show message box for restart request.

RIM_DRIVERS 1 (Default) 0

Installs or disables RIM BlackBerry® drivers

MANUALSTARTSTOP 1 Disables auto launch and close of VTP

21

© March 2009. Vodafone Limited. Vodafone and the Vodafone logos are trademarks of the Vodafone Group. Other product and company names mentioned herein may be the trademarks of their respective owners. The information contained in this publication is correct at the time of going to print. Such information may be subject to change, and services may be modified, supplemented or withdrawn by Vodafone without prior notice. All services are subject to Terms and Conditions, copies of which may be obtained upon request. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The RIM and BlackBerry families of related marks, images and symbols are the exclusive properties of and trademarks of Research In Motion – used by permission Vodafone Limited, Vodafone House, The Connection, Newbury, Berkshire RG14 2FN www.vodafone.co.uk Registered in England No. 1471587 Via_the_phone_corporate_Admin_Guide_2.4.15_EN

vodafone mobile broadband via the phone - callertunes · 4 supported devices the following list...

Documents