HP Mobile Center Install Guide - HP Mobile Center Help

HP Mobile Center
Software Version: 1.10
Install Guide
Document Release Date: May 2015
Software Release Date: May 2015
Install Guide
Legal Notices
Warranty
The only warranties for HP products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable
for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Restricted Rights Legend
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR
12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for
Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Copyright Notice
© Copyright 2015 Hewlett-Packard Development Company, L.P.
Trademark Notices
Adobe® is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
UNIX® is a registered trademark of The Open Group.
Red Hat® is a registered trademark of Red Hat, Inc. in the United States and other countries.
Apple and the Apple logo are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.
iPad® is a trademark of Apple Inc.
iPhone® is a trademark of Apple Inc.
Google™ © 2012 Google Inc. All rights reserved. Google and the Google Logo are registered trademarks of Google Inc.
Support
Visit the HP Software Support Online web site at: https://softwaresupport.hp.com
This web site provides contact information and details about the products, services, and support that HP Software
offers.
HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access
interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by
using the support web site to:
l
l
l
l
l
l
l
l
Search for knowledge documents of interest
Submit and track support cases and enhancement requests
Download software patches
Manage support contracts
Look up HP support contacts
Review information about available services
Enter into discussions with other software customers
Research and register for software training
Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support
contract. To register for an HP Passport ID, go to: https://softwaresupport.hp.com and click Register.
HP Mobile Center (1.10)
Page 2
Install Guide
To find more information about access levels, go to: https://softwaresupport.hp.com/web/softwaresupport/accesslevels.
HP Software Solutions & Integrations and Best Practices
Visit HP Software Solutions Now at https://h20230.www2.hp.com/sc/solutions/index.jsp to explore how the products
in the HP Software catalog work together, exchange information, and solve business needs.
Visit the Cross Portfolio Best Practices Library at https://hpln.hp.com/group/best-practices-hpsw to access a wide
variety of best practice documents and materials.
HP Mobile Center (1.10)
Page 3
Install Guide
Contents
Install HP Mobile Center
HP Mobile Center Architecture
Network connectivity
Before you start
Install HP Mobile Center
Install your HP Mobile Center license
Run tests with HP Mobile Center
Send Us Feedback
HP Mobile Center (1.10)
5
6
8
9
10
13
14
15
Page 4
Install Guide
Install HP Mobile Center
Install HP Mobile Center
HP Mobile Center helps you take control of your mobile reality, and addresses the challenge of
optimizing mobile app quality and user experience throughout the application lifecycle. Built on native
HP technology, HP Mobile Center leverages our expertise in functional and performance testing, and
integrates mobile testing with Sprinter, Unified Functional Testing, LoadRunner, Performance Center,
and Network Virtualization.
This guide describes how to install HP Mobile Center. It contains the following information:
l
HP Mobile Center architecture
l
Installation prerequisites
l
Installing HP Mobile Center
For more details on HP Mobile Center, see the HP Mobile Center Help.
HP Mobile Center (1.10)
Page 5
Install Guide
Install HP Mobile Center
HP Mobile Center Architecture
HP Mobile Center is a standalone server that provides mobile device access to different test
applications. HP Mobile Center supports a distributed architecture where different test clients can all
interact with the same Mobile Center server instance.
The individual components of HP Mobile Center, and the relationship between them and the different
clients is shown in the diagram below:
The HP Mobile Center architecture comprises:
Component
Function
Mobile Center
server
This is a single web server that:
l
l
HP Mobile Center (1.10)
Mediates between the testing tool client calls to mobile devices, and provides
a user interface within the testing tool for recording and running tests on real
mobile devices.
Accepts apps for testing, and manages app versions.
Page 6
Install Guide
Install HP Mobile Center
Component
Function
l
Database server
Provides a user interface (Lab Management console) for administrators to
manage users, manage apps and view their properties such as OS and version,
and to control devices: restart, unlock, or open a device remotely.
This server is by default run on the Mobile Center server itself. Currently, the
PostgreSQL database stores the following:
l
User management
l
Metadata of the connected device (such as OS, version.)
l
Metadata of the uploaded apps
l
Device lock (by user)
l
l
Transient test steps (This is mostly redundant and may be removed in the
future from the database)
Applications under test with multiple versions
Users can schedule backups to run at a specific time. In addition, using standard
PostgreSQL tools, users can set up a high availability database to prevent lengthy
downtime.
Connector
The connector is available on Linux & Windows, and is designed as a lightweight
piece that can also be installed on a testing engineer’s desktop.
The connector manages the physical USB connection to the device, and the
logical state machine on top of it. It receives lifecycle events from the USB library
such as device connected/disconnected, agent finished installing, agent started,
etc., and transfers them to the HP Mobile server for adding the device to the
pool. It is also responsible for installing and uninstalling apps on the device, and
for mapping ports to connect to the device over USB.
Test devices
connected to the
Mobile Center
server
These are the devices (smartphones/tablets) on which the tests are run. The
following applications are copied to the test devices:
l
l
l
NV server
HP Mobile Center (1.10)
The HP Mobile Center Agent, which manages commands to the AUT, to the OS
(out-of-app control), and to the RDP server that supplies the UI and remote
control for the testing tools clients.
Agent Launcher (iOS only) for the safe launching of the HP Mobile Center
Agent.
The AUT – Application under Test.
This is an optional network virtualization server that can be used to test
applications running under different network conditions. This server can simulate
latency and packet loss.
Page 7
Install Guide
Install HP Mobile Center
Network connectivity
The next diagram shows a more drilled-down view, with a focus on the physical deployment of an HP
Mobile Center server. The different protocols that run over the various links, and the ports used by
those channels are also shown.
Testing tool clients and HP Mobile Center server connectivity
Testing tool clients connect to the HP Mobile Center server for the following:
l
A user interface (UI) for managing devices and uploading apps, over http.
l
API (JSON commands) for tests and management, sent over WebSocket (WS).
l
The RDP client, via Guacamole.
HP Mobile Center server and connector connectivity
The HP Mobile Center server sends a REST request to the connector to start the connection.
The connector establishes a WebSocket (WS) connection with the HP Mobile Center server, allowing
two-way asynchronous communication from the connector to the server, and vice versa, on the same
socket. API calls and files are passed over WS.
The Guacamole protocol flows from the (Guacomole) server guac daemon directly to the port that is
mapped for the mobile device, without going through the connector. This flow is needed for the RDP.
Connector and HP Mobile agent connectivity
The HP Mobile Center agent listens on a WS port.
HP Mobile Center (1.10)
Page 8
Install Guide
Install HP Mobile Center
The connector maps a port forward to the mobile device for communication of API traffic using mobile
libraries (Android Debug Bridge (ADB), Mobile Device Library). It also opens a WS socket connection to
the agent.
The connector maps a port forward for RDP. The Guacamole daemon sends RDP traffic as described
above in HP Mobile Center server and connector connectivity.
Before you start
Server Requirements
The HP Mobile Center server can also be run on a virtual machine.*
Before installing the HP Mobile Center server, make sure that your server machine meets the following
requirements:
Computer Processor:
2x2 GHz or higher dual core processor (Quad core recommended.)
Operating System:
Red Hat Enterprise Linux 6.5 minimal workstation x64
CentOS 6.5
CentOS 6.6
Memory:
4GB RAM
HP Mobile Center requires at least 1G RAM free (2G recommended.)
Free Hard Disk Space:
20 GB of free disk space for application files and folders.**
You must also have an additional 1 GB of free disk space on the system disk
(the disk on which the operating system is installed.)
**May require more depending on the number of apps that you are testing
with Mobile Center.
Browser:
Chrome, Firefox 31, Internet Explorer 10, Internet Explorer 11.
(Browsers supported on clients connecting to HP Mobile Center's Lab
Management administrator's console: Chrome, Firefox 31, Internet Explorer
10, Internet Explorer 11)
Database:
(comes with the
installation package)
PostgreSQL server Version 9.3
Maximum number of
40 devices
connected devices per
server:
HP Mobile Center (1.10)
Page 9
Install Guide
Install HP Mobile Center
*Hosted virtualization hypervisors are supported. HP Mobile Center has been certified with VMWare
Workstation (10.0.3).
Network requirements
The following ports are required:
Server
HTTP (8080)
Connector
HTTP (8080)
Devices:
RDP
3389
Android-specific
5000
5001
iOS-specific
12345
Prerequisites for Installation
Note: You must have root permissions to install the HP Mobile Center server.
1. A linux machine:
l
Redhat Enterprise Linux 6.5 workstation 64 bit (minimal install) or
l
CentOS 6.5 or
l
CentOS 6.6
2. The hostname of the server machine must be accessible:
ping -c 1 `hostname` succeeds.
Install HP Mobile Center
HP Mobile Center 1.10 can be installed as a full installation where there is no previous installation of HP
Mobile Center, or as an upgrade on top of an existing installation of HP Mobile Center. The installer
checks what files are already installed, and installs/ updates the relevant files.
When you install HP Mobile Center 1.10, the following components are installed:
l
l
The HP Mobile Center server
The HP Mobile Center connector. (The connector can also be installed as a standalone component on
a different machine, and configured to connect to the HP Mobile Center server machine. For more
details, see the HP Mobile Center Help .)
HP Mobile Center (1.10)
Page 10
Install Guide
Install HP Mobile Center
Note: HP Mobile Center comes with a 45-day trial license. After the trial period, you need to
install a valid license from HP to continue working with Mobile Center. For details, see the HP
Mobile Center Help .
How to install HP Mobile Center 1.10
Follow these steps to install HP Mobile Center either as a full installation where no previous version is
installed, or as an upgrade to an existing installation:
1. Download the HP Mobile Center 1.10 ISO file (T9826-15002.iso).
2. Log in as root on your Linux/HP Mobile Center server machine.
3. Create the HPMC directory by running the following command:
mkdir /mnt/HPMC/
4. Access the contents of the ISO file:
mount -o loop T9826-15002.iso /mnt/HPMC/
You can display a list of contents to verify that the file is mounted by running ls /mnt/HPMC/
5. Copy the HPMC_setup folder from the ISO file to your Linux machine:
cp -r /mnt/HPMC/HPMC_Setup/ /root/
6. Change the directory to HPMC_Setup:
cd /root/HPMC_Setup/
7. Run the installation script:
./hpmc_install.sh
Follow the command line prompt instructions.
8. Read the License Agreement, and select y to accept the terms and proceed with the installation.
9. For full installation of HP Mobile Center:
Specify the following or use the defaults:
o
The installation creates a new user "hpmc". Enter the password for this user (Default.
hpmc)
o
PostgreSQL server port (Default. 5432)
o
PostgreSQL server superuser password (Default. password)
Note: If you don't use the default value for the PostgreSQL password, save this password
because it will be required if you upgrade HP Mobile Center in the future.
HP Mobile Center (1.10)
Page 11
Install Guide
Install HP Mobile Center
For upgrade of HP Mobile Center:
When prompted for the PostgreSQL server superuser password, use the same password that you
used for the initial installation of HP Mobile Center. If you used the default value for the original
installation, do not change this password when upgrading to HP Mobile Center 1.10 otherwise an
error message will be displayed.
10. Once the installation is complete, select y or press enter to start the server.
Starting and stopping the server
You can stop and start the HP Mobile Center server during runtime with the following commands:
l
To start the server: service hpmc start
l
To stop the server: service hpmc stop
l
To restart the server: service hpmc restart
Note: The server starts on port 8080.
Changing the default port for the HP Mobile
Center server
By default, the server starts on port 8080. You can change the default port by running the update port
script.
1. Log in as root on the HP Mobile Center server machine.
2. Navigate to the conf directory:
cd opt/hpmc/conf
3. Run the script to update the port:
./update_hpmc_port.sh
4. When prompted, specify the new port for the HP Mobile Center server.
The script updates all the relevant files according to the provided port.
5. Restart the server at the end of the process so that the port change can take effect.
Note: If the HP Mobile Center server port is changed, users who installed the standalone
connector standalone connector with the previous server port information need to re-install the
connector using the new Mobile Center server port details. For more details, see the HP Mobile
Center Help .
HP Mobile Center (1.10)
Page 12
Install Guide
Install HP Mobile Center
Enabling localization
To display system apps (apps that are used to run the device itself) in a supported language other than
English, after installing HP Mobile Center navigate to:
/opt/hpmc/conf/connector.properties
and insert the following line in the file:
ENABLE_LOCALIZATION=true
Restart the server.
Install your HP Mobile Center license
HP Mobile Center comes with a 45-day trial license, activated on the date that you install the software.
After the trial period, you need to install a valid license from HP to continue working with Mobile Center.
Tip: When you have 45 days or less left for your trial or purchased license, the remaining days
icon
is displayed in the top right corner of the Mobile Center window. You can see the
number of days left for your license.
To install your license, you need to:
1. Obtain a license key from the HP Licensing for Software portal.
2. Install the license key on the HP Mobile Center server.
Activate a license and obtain a license key
1. Obtain a valid entitlement order number. Contact your HP sales representative for help if needed.
2. Navigate to the HP Licensing for Software portal. Enter your Entitlement Order Number (EON) to
activate your license and receive a license key. You will need an HP Passport account to sign in to
the portal.
Note: The license period starts from the date that you activate your license and obtain the
license key, and not from the date that you install the software.
Existing customers with an active support contract can use the My Updates portal to obtain the license
key required for the HPMC 1.1 update.
Using the My Updates portal:
HP Mobile Center (1.10)
Page 13
Install Guide
Install HP Mobile Center
1. Go to the My Updates portal.
2. Enter your Service Agreement ID (SAID).
3. Select Mobile Center 1.10 SW E-Media.
4. Click Get License. You will be re-directed to the Licensing for Software Portal to get the new
license key required for the update.
For assistance, contact an HP regional licensing support center or your HP sales representative.
Install a new license key
You will need the license key string to install your HP Mobile Center license. The license key can be
copied directly from the HP Licensing for Software portal. If you saved the key for download as a .dat
file, copy the license key string from the .dat file.
Install your license for HP Mobile Center as follows:
1. On the HPMC server machine, log in as root.
2. Run the following command:
echo 'your license key string' >> /opt/hpmc/data/hpmc_licenses.dat
3. Restart the server:
service hpmc restart
Run tests with HP Mobile Center
Before other users can integrate their testing tools and run tests with HP Mobile Center, the
administrator also needs to:
l
l
Configure the app packager
Add HP Mobile Center users:
Navigate to: http://<HP Mobile Center server name or IP address>:8080/admin and log in
with your credentials:
l
Connect devices to HP Mobile Center
l
Configure HP Mobile Center to work with network virtualization
For details, see the HP Mobile Center Help.
HP Mobile Center (1.10)
Page 14
Send Us Feedback
Can we make the Install Guide better?
Tell us how: [email protected]
HP Mobile Center (1.10)
Page 15