Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
windows_installation [2015/09/08 12:44]
jrodriguez [Automated Installation]
windows_installation [2015/09/08 20:28] (current)
jrodriguez
Line 1: Line 1:
 +====== Installation ======
 +
 +
 +Open Mobile for Windows is distributed in a standard Windows installer package (MSI). ​ The client and profile are bundled together in an installer that will install both the software and a single configuration profile.
 +
 +For information on finding the version number in the installation package, click [[win_version_number_in_the_installation_package|here]].
 +
 +Software installers are available on the [[Download Profile]] page of the Open Mobile Portal. Dialer plug-in installers are available on the [[Download Software]] page.
 +
 +
 +This page includes details on the following items:
 +
 +  * **[[windows_installation&#​system_requirements|System Requirements]]**
 +  * **[[windows_installation&#​supported_hardware|Supported Hardware]]**
 +  * **[[windows_installation&#​manual_installation|Manual Installation]]**
 +  * **[[windows_installation&#​automated_installation|Automated Installation]]**
 +  * **[[windows_installation&#​note_on_imaging|Note on Imaging]]**
 +  * **[[windows_installation&#​manual_uninstallation|Manual Uninstallation]]**
 +  * **[[windows_installation&#​automated_installation|Automated Uninstallation]]**
 +  * **[[windows_installation&#​migrating_from_ipassconnect|Migrating from iPassConnect]]**
 +  * **[[windows_installation&#​installation_logs|Installation Logs]]**
 +  * **[[windows_installation&#​open_mobile_tutorial|Open Mobile Tutorial]]**
 +
 +
 +
 +===== System Requirements =====
 +
 +
 +Open Mobile for Windows has the following system requirements:​
 +
 +
 +==== Operating System ====
 +Any of the following:
 +
 +    * Windows XP (SP3) (32-bit only)
 +    * Windows Vista, Vista SP1 or Vista SP2 (32 or 64-bit)
 +    * Windows 7 or Windows 7 SP1 (both 32 or 64-bit)
 +    * Windows 8 or Windows 8.1 (32 or 64-bit)
 +
 +==== Additional Software Components ====
 +
 +
 +    * For Windows XP:
 +      * WLAN API and .NET Framework 3.5 SP1 or 4.0 must be installed.
 +      * 802.1x connections on Windows XP require the Windows hotfix available at [[http://​support.microsoft.com/​kb/​958071|http://​support.microsoft.com/​kb/​958071]].
 +      * Com+ Event System Com+ System Application,​ and MSDTC services must be installed and running.
 +    * For Windows Vista:
 +      * .NET Framework 3.5 SP1 or 4.0 must be installed (not required for SP1 or later).
 +
 +
 +==== Hardware Requirements ====
 +
 +
 +    * 1 GHz 32-bit (x86) or 64-bit (x64) processor
 +    * 1 GB of system memory
 +    * 512 MB of physical memory
 +    * Support for DirectX 9 graphics and 32 MB of graphics memory
 +    * At least one connectivity device installed, depending on your intended connection type:
 +      * Wi-Fi adapter for a wireless connection.
 +      * An iPass-supported Mobile Broadband device, plus appropriate driver software installed.
 +      * Ethernet adapter for an Ethernet connection.
 +      * 56K v90/92 modem for a Dial connection.
 +      * DSL modem for a DSL connection.
 +
 +
 +<note tip>​It’s recommended that your screen resolution is at least 1024×768.</​note>​
 +
 +
 +==== Supported Languages ====
 +
 +
 +Open Mobile is supported in Simplified Chinese, Traditional Chinese, English, French, German, Japanese, Korean, Spanish, and Thai.
 +
 +
 +==== Required Network Configurations ====
 +
 +Click [[:​required_configurations_for_open_mobile_access|here]] for a complete list of required network configurations for Open Mobile access.
 +
 +===== Supported Hardware =====
 +
 +
 +==== Mobile Broadband Devices ====
 +
 +
 +To use Mobile Broadband connectivity,​ you need an iPass-supported Mobile Broadband device and a subscription with the iPass Mobile Broadband service or another Mobile Broadband network carrier.
 +
 +
 +Open Mobile supports a wide variety of Mobile Broadband devices, and iPass regularly adds support for more.  Contact your iPass account representative if you have questions about support for a specific device.
 +
 +
 +<note important>​If your Mobile Broadband device is not provided by iPass, you should install it and test it for connectivity with your carrier’s network, using your carrier’s client, before attempting to use it with Open Mobile.</​note>​
 +
 +
 +==== Wi-Fi Devices ====
 +
 +
 +An 802.11b/g wireless device is needed for Wi-Fi connections. Open Mobile supports all standard Wi-Fi devices with an NDIS 5.1 or later interface.
 +<note important>​Installation of Open Mobile with the integrated Nortel VPN requires that the computer be restarted after the installation completes. </​note>​
 +
 +===== Manual Installation =====
 +
 +
 +Installation of Open Mobile requires an account with local administrative privileges. However, administrative privileges are not required to run Open Mobile.
 +
 +
 +**To install Open Mobile:​** ​
 +
 +
 +    - If you are currently running a previous version of Open Mobile, close it.
 +    - Double-click the installer .msi file.
 +    - Follow the prompts to install the software.
 +
 +
 +
 +
 +===== Automated Installation =====
 +
 +Open Mobile can be installed by software distribution tools, or on the command line, using MSI installation commands. All standard msiexec command line options are available for use with the Open Mobile installer.
 +
 +== Automatic Credential Assignment ==
 +Please contact an iPass admin to enable this feature.
 +With automatic credential assignment (ACA), users don't need to enter their username or password to use and connect with Open Mobile. Credentials are automatically assigned in the background once users have been verified.
 +There are two ways a user may encounter this account update. ​
 +
 +== Short Way to Automatic Credential Assignment ==
 +After ACA is enabled and migration is successful, you will receive an account update the next time you launch Open Mobile stating you no longer need to worry about usernames and passwords.
 +
 +After the account update, click Got it! and continue using Open Mobile. A notification for an account update may appear if you are on your device and Open Mobile is running in the background. The only change you may notice is that the Account Details option, under Settings, will no longer be visible as it is no longer relevant.
 +
 +== Longer Way to Automatic Credential Assignment ==
 +The slightly longer ACA method requires users to provide iPass with an email address and to access an email link that finalizes the update.
 +
 +
 +   - Click on Continue when the Account Updates screen appears. This screen may appear the next time you launch Open Mobile or if you click on an account update notification.
 +   - Enter your email address. You may need to select among domains if there are several associated with your user profile.
 +   - You will be notified that an email has been sent to the email address you provided. You must open the email sent by iPass and click on the link contained within the email.
 + 
 +== Additional Help ==
 +For a complete description of additional features of Open Mobile, click Help > iPass Open Mobile Help.
 +If the link doesn'​t work for any reason, there is an activation code included in the email that the users can enter.
 +==== Silent Installation ====
 +
 +
 +Open Mobile can be installed in silent mode, using standard Windows Installer options, by the command: ''​msiexec /i <MSI Installer>​ /​qn'' ​
 +
 +
 +<MSI Installer>​ is the name of the Open Mobile installer. If running from a command prompt, make sure your command prompt is opened in administrative mode.
 +
 +
 +==== Installing in a Supported Language ====
 +
 +
 +Open Mobile is supported in English (by default), French, German, Spanish, and Japanese. You can install the application in French, German, or Japanese by adding the LANGID flag to the command line: ''​msiexec /i <MSI Installer>​ LANGID=<​Language ID>'' ​
 +
 +Where the value of LANGID is one of the following 4-digit codes:
 +    * ''​1031'':​ German
 +    * ''​1033'':​ English (Default value. If no value is specified, or a code is specified that is not supported by Open Mobile, the installed language will be English.)
 +    * ''​1036'':​ French
 +    * ''​1041'':​ Japanese
 +    * ''​1034'':​ Spanish
 +
 +===== Note on Imaging =====
 +If you are imaging your computer after installing Open Mobile, the following steps will ensure that each user can be properly identified in the reports:
 +  - Delete the file: ''​%programdata%\ngcspap\spap.xml''​
 +  - Remove the registry key: ''​HKEY_LOCAL_MACHINE\SOFTWARE\OM\Devicescape\Connectd''​
 +===== Manual Uninstallation =====
 +
 +
 +Manual uninstallation of Open Mobile requires administrative rights on the PC. Follow the standard Windows procedure to uninstall Open Mobile.
 +
 +
 +===== Automated Uninstallation =====
 +
 +
 +Open Mobile can be uninstalled through software distribution tools or through the command line.
 +
 +
 +==== Silent Uninstallation ====
 +
 +
 +Open Mobile can be uninstalled in silent mode using standard Windows Installer options using the command: ''​msiexec /x OpenMobile.msi /​qn'' ​
 +
 +
 +<​OpenMobile.msi>​ is the name of the Open Mobile installer. ​ If running from a command prompt, make sure your command prompt was opened in administrative mode.
 +
 +
 +<note important>​A silent uninstallation will not remove the Open Mobile directory from the registry HKCU key. This folder will need to be removed manually. It is suggested that an administrator using any deployment script to remove Open Mobile include explicit functionality to remove this key.</​note>​
 +
 +
 +===== Migrating from iPassConnect =====
 +
 +
 +When migrating from iPassConnect,​ you can have applicable username, password, and domain credentials automatically migrated from an iPassConnect installation to Open Mobile. ​ Migration is prompted automatically on the first launch of the Open Mobile.
 +
 +There is a migration tool available for version 2.4.0 and later. Please contact Tech Support for help configuring this tool.
 +
 +===== Installation Logs =====
 +
 +
 +The Open Mobile installation process writes the standard Windows Installer logs, which by default are written to the ''​%temp%'' ​ directory. To change the default directory to which they are written, use the ''/​log '' ​ command.
 +
 +
 +Installer log filenames start with “MSI” and end with “log”, with a random string of characters in between. If troubleshooting an Open Mobile installation,​ use the latest MSI%%*%%.log file from the log directory.
 +
 +<note important>​On Windows XP Pro, installation logs are not created by default. In order to create an installation log, use the command line with an additional /log switch, as follows: "​msiexec.exe /i OpenMobile.msi /qn /log"
 +</​note>​
 +
 +
 +===== Open Mobile Tutorial =====
 +
 +
 +Open Mobile includes a Flash tutorial, accessible from the system tray icon, intended to get new users up and running quickly. To launch the tutorial, right-click the system tray icon and pick Tutorial.
 +
 +
 +
 +
 +
 +=====Anti-Virus Management=====
 +
 +The executable **ShowMessage.exe** is a simple application that helps identify if a user has entered incorrect credentials. Due to the transaction server activity, this executable can be misidentified as a virus. ​
 +
 +To prevent this from occurring, add the executable **ShowMessage.exe** to your anti-virus management whitelist. The path for ShowMessage.exe is listed below. Please note that 10669 is an example and should be replaced by (one of) your company'​s unique profile IDs. If you don't know your profile ID, please contact an your iPass admin. ​
 +
 +
 +**Path** ​
 +
 +<​code>​
 +C:​\ProgramData\NGC\Open Mobile\Profiles\10669\Custom\ShowMessage.exe
 +</​code>​
 +
 +
 +
 +
 +Go to: **[[:​windows_help|Open Mobile for Windows Help]]**
 +
 +
 +{{tag> installation tutorial requirements}}
 +
 +
  
 

©2015 iPass Inc. All rights reserved. Terms of Use