deviceBridge™ User Guide

Transcription

deviceBridge™ User Guide
Mobile Labs
deviceBridge™ User Guide
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
i
Contents
1
About deviceBridge
1
2
Requirements
1
2.1
deviceConnect Appliance Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
2.2
deviceConnect Power Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
2.3
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
2.4
Network Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
2.5
Trust Hardware Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
2.6
deviceBridge Hardware Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
2.7
Supported Mobile Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
3
4
5
6
7
8
9
Getting Started
4
3.1
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
3.2
Install deviceBridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
deviceBridge Applications
7
4.1
deviceBridge Application on Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
4.2
deviceBridge Application on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
deviceBridge Command Line Interface
21
5.1
21
deviceBridge Command Line Interface for OSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuration file
23
6.1
Configuration file contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24
6.2
Sample Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24
deviceBridge Maintenance and Management
25
7.1
25
deviceBridge logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mobile Labs Support
25
8.1
25
Upgrading deviceConnect Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Legal Notices
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
26
ii
Mobile Labs, LLC 7.1, April 2016
1 About deviceBridge
deviceBridge is an application that allows a user to connect remotely connected devices in deviceConnect™ to a user’s
local workstation, as if the device was connected by USB cable, giving users the ability to use remote devices to develop,
debug, and test native and web mobile applications.
2 Requirements
2.1 deviceConnect Appliance Specifications
Dimensions
Monitor Height
Cart Weight
Capacity
USB Hubs
Appliance Fans
Server
37 5/8" W x 39 1/8" H x 24" D
19.35"
216 lbs
48 devices
3 Datamation 16-Port USB Charge and Sync Hubs
3 intake fans, 3 exhaust fans
Apple Mac Mini running OS X 10.11.3
Intel i7 3.0 GHz processor, 16GB RAM, 1TB Hard Disk Drive
2.2 deviceConnect Power Requirements
International
Fans
Domestic Fans
Mac-mini
USB Hubs
Monitor
6.5 Watts, 230 Volts, 0.045 Amps (x6= 0.27 Amps)
5.5 Watts, 115 Volts, 0.08 Amps (x6= 0.48 Amps)
85 Watts, 230 Volts, 0.36 Amps
225 Watts, 230 Volts, 0.97 Amps (x3= 2.91 Amps), 3.6 Amps Max
28 Watts, 12 Volts, 2.3 Amps
2.3 Software Requirements
Various components will require different software. The deviceConnect UI is a browser based application and browser
based deviceViewer. These can run on many platforms and browsers. Mobile Labs Trust is a software download that
only runs on Windows. Below are the software requirements needed to use deviceConnect.
2.3.1 deviceConnect Management
Browsers
OS X
Windows
IE 8 or greater, Edge, Firefox, Chrome, Safari
10.8 or greater
Windows 7 or greater
Note
Xcode 6.0 on a Macintosh running OS X 10.9 is required to provision the deviceControl applications for use and
optionally to incorporate the Trust instrumentation library to your iOS application. You will need an Apple Developer or
Enterprise account to provision and instrument applications.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
1 / 26
2.3.2 deviceViewer Browser
Browsers
OS X
Windows
IE 10 or greater, Edge, Firefox, Chrome, Safari 6.1.5 or greater
10.8 or greater
Windows 7 or greater
2.3.3 Mobile Labs Trust
Windows
.NET
HP
Windows 7 or greater
4.0
QuickTest Professional (QTP) 11 or Unified Functional Tester (UFT) 11.5X - 12.5X
(required for automation)
Note
QTP version 11 requires patch QTPTEA_00002. This patch must be requested through HP Support. Contact your
QTP system administrator to initiate a support request to receive this patch.
2.3.4 deviceBridge
Browsers
OS X
Windows
Xcode
Firefox, Chrome, Safari 6.1.5 or greater
OS X 10.10.4 or greater
Windows 7 or greater
Version 6 or greater
2.3.5 deviceConnect Command Line Interface (CLI)
.NET
Framework
Mono
Windows
OS X
4.0
3.2.4.9 (http://www.mono-project.com/Mono:OS X)
Windows 7 or greater
10.8 and greater
Note
Mono is only required for Mac OS X.
2.4 Network Requirements
deviceConnect was designed and built to be installed behind corporate firewalls. Therefore, there are some network
requirements for deviceConnect.
Tip
Mobile Labs recommends being connected by Ethernet cable rather than WiFi for controlling devices. Each device
connection will utilize around 3 Mbps bandwidth.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
2 / 26
2.4.1 Static IP Address
Because deviceConnect contains a server, a static IP address must be assigned to the server allowing users to access the
server.
Tip
A DNS entry for the IP address can make getting to the server easier for users.
nect.company.com.
For example: devicecon-
2.4.2 Ports
The internal network is used for communication from a web browser and Mobile Labs Trust to the deviceConnect server.
The following ports must be open for communication to the server:
80
10160
22
This port is used to access the deviceConnect web UI.
This port is used by Mobile Labs Trust to communicate to the server for device control and
automation.
SSH port to remotely manage the server. This is optional as the server can be managed
directly with the mouse and keyboard.
2.4.3 WiFi or Cellular
deviceConnect does not share the network connection with the devices, therefore it is necessary to give the devices WiFi
or Cellular connections. This is required because it’s important for applications to use the same connection mechanisms
they normally make for testing, without being interfered by the deviceConnect communication that comes over the USB
connection.
2.5 Trust Hardware Configuration
2.5.1 Recommended Configuration
The following lists show the recommended and minimum requirements for using Mobile Labs Trust. If you are using
HP Unified Functional Testing, these requirements are in addition to the minimum requirements for using UFT.
Computer /
Processor
Memory
Color Settings
Graphics Card
Intel® Core™ i7
6GB
32 bit
1GB
2.5.2 Minimum Configuration
The following is the minimum configuration of hardware supported.
Computer /
Processor
Memory
Color Settings
Graphics Card
Intel® Core™ i5
4GB
32 bit
256MB
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
3 / 26
2.6 deviceBridge Hardware Configuration
2.6.1 Recommended Configuration
The following lists show the recommended and minimum requirements for using deviceBridge. If you are using any
other development and testing software, these requirements are in addition to the minimum requirements for such
software.
Computer /
Processor
Memory
Disk
2.2GHz Quad-core Intel Core i7
16GB 1600MHz DDR3L SDRAM
500 MB available disk space
2.6.2 Minimum Configuration
The following is the minimum configuration of hardware supported.
Computer /
Processor
Memory
Disk Space
1.6GHz dual-core Intel Core i5 processor
2.5GHz 4GB of 1600MHz DDR3 memory
250 MB available disk space
2.7 Supported Mobile Platforms
Apple iOS
Android
Amazon™
devices running versions 6.0 - 9.3
phones or tablets running versions 2.3, 4 - 6.0
Phones and Tablets running Android versions 2.3, 4 - 6.0
Note
Android devices running on a x86 processor or using 64bit JNI libraries are currently not supported. If 64bit JNI
libraries are used, the application is installed as a 32bit application.
3 Getting Started
deviceBridge is a licensed add-on to deviceConnect. Before deviceBridge can be used the license file in deviceConnect must be updated to enable deviceBridge services. Contact your account representative to purchase and enable
deviceBridge.
3.1 Prerequisites
In order to use deviceBridge for Android devices, you must have the following installed on your computer:
• JAVA
• Android SDK
Note
If your have installed Android Studio, you already have the Android SDK
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
4 / 26
3.2 Install deviceBridge
deviceBridge is an application that must be installed in order to bridge a device to the user’s local workstation. Follow
these steps to install deviceBridge:
1. In the deviceConnect user menu, click the Download deviceBridge to download the files.
2. Extract the files from the dcb.zip file
3.2.1 OS X Installation
1. Extract the deviceBridge-OSX.zip file
2. Copy or move the deviceBridge.app file to the Applications folder to make it easy to access
Note
The first time the app is run, it will prompt the user for username and password for an account with administrative
privileges, and install necessary background components (dcb and dcbControl) and update system configuration as
needed. This installation process is repeated whenever there is a new version of deviceBridge with new versions of
those components. When the installation process is complete, the user is prompted to restart Xcode, iTunes, etc.
3.2.2 Windows Installation
1. Extract the deviceBridge-x86.msi or deviceBridge-x64.msi installer file from the dcb download file
a. For a 32-bit Windows machine, use deviceBridge-x86.msi
b. For a 64-bit Windows machine, use deviceBridge-x64.msi
2. Click Run on the Open File - Security Warning “Do you want to run this file” window
3. Click Next on the Mobile Labs deviceBridge SetUp Wizard
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
5 / 26
4. Click Yes for user account control windows
a. If prompted, enter computer admin account user name
b. If prompted, enter computer admin account password
c. Click Finish to complete the deviceBridge Setup Wizard
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
6 / 26
Note
Windows .NET Framework 4.0 must be installed prior to installing deviceBridge.
4 deviceBridge Applications
4.1 deviceBridge Application on Mac OS X
4.1.1 Launch Application
To launch the deviceBridge app:
1. Open the deviceBridge.app that was downloaded and installed to the Applications folder.
2. Click open on the warning deviceBridge.app is an application downloaded from the Internet. Are you sure you
want to open it?’ dialog
3. Click continue on the deviceBridge Component Updates Required dialog
a. Enter computer admin account Username
b. Enter computer admin account Password
c. Click Install Helper
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
7 / 26
4. Click OK on deviceBridge Updates Complete dialog
5. Restart Xcode or iTunes or any other iOS testing tools
When deviceBridge is launched deviceBridge notifications will appear in the OS X notification center for various activities like devices being connected or disconnected. These notifications can be configured in the OS X notifications
system settings.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
8 / 26
4.1.2 OS X Permission Requirements for Android deviceConnect
In order to connect to Android devices, deviceBridge will need to use a copy of the adb application in the Android SDK.
On launch, it will ask you to specify the location of the installation directory.
You can close the Android SDK Configuration window if you do not want to use deviceBridge with Android Devices.
Otherwise, once you have installed Android SDK to your local machine,
1. Click the Choose button
2. If Android SDK is installed, the Finder window will automatically open to platform-tools
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
9 / 26
3. Choose adb and click Choose
Note
Choose the Do not ask me again checkbox to stop the Android SDK Configuration windows from appearing if you do
not wish to use Android devices with deviceBridge.
4.1.3 Configuration
Use the configuration window to connect servers, devices and change Android SDK Configurations. To launch the
configuration window, click on the deviceBridge icon in the menu bar and choose deviceBridge Configuration. In the
window, when a device or a server are configured, information about the server or device is displayed. For a server, you
can change the login information by clicking the "Change login. . . " button. Click on the "View in deviceConnect" link
to launch deviceConnect and bring up the device list or device details page.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
10 / 26
Add Server
To add a server to deviceBridge:
1. Click the + button
2. Choose Add Server. . .
3. Enter deviceConnect host
4. Edit the Server Name field. By default it will update to the host entry.
5. Enter your deviceConnect username
6. Enter your deviceConnect password
7. Click Add
Once the server has been added it will immediately be connected.
Add Devices
To add devices to deviceBrige:
1. Click the + button
2. Choose Add Device. . .
3. Select one or more devices to connect
4. Click Add
Tip
Double click to instantly add a device and close the window
Note
The add devices window will appear after entering a new server in the configuration window.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
11 / 26
Warning
For iOS devices using Xcode may require that the symbol files need to be copied into Xcode. This can
be an issue over a network as any interruptions will require that the download start over. If this problem is
experienced, it might be best to copy the files directly from the deviceConnect server to your computer. The
path of the symbol files on the server and your computer are ~/Library/Developer/Xcode/iOS\
DeviceSupport
Remove Servers and Devices
To remove a server and devices from being connected to the computer with deviceBridge:
1. Select the server or device in the list
2. Click the - button
3. Click Remove button on confirmation window
Note
Removing a server will also remove all of the associated devices.
Android SDK Configuration
Android SDK configurations can be changed from the deviceBridge Configuration window.
1. Click the settings button
2. Choose Android SDK Configuration. . .
3. Make needed changes and click Choose
Export Configuration
The deviceBridge configuration details can be exported to a file so they can be saved and loaded at another time.
1. Click the settings button
2. Choose Export Configuration. . .
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
12 / 26
3. Enter in a file name and location
4. Click the export button
Note
The file contents are exported in a JSON file format.
Import Configuration
deviceBridge configurations can be imported making it easier to connect to servers and devices instead of adding each
server and device one by one.
1. Click the settings button
2. Choose Import Configuration. . .
3. Choose a file to import
4. Click Import
The servers and devices will then be connected with deviceBridge.
4.1.4 Status
Use the status window to view the status of connected servers and devices. To launch the status window, click on the
deviceBridge icon in the menu bar. The servers and devices will appear in the window and display their connected state
to deviceConnect.
4.1.5 Save Logs
In the event that you are experiencing an issue, support may ask for the deviceBridge logs.
1. Select Save Logs. . . in the deviceBrige menu
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
13 / 26
2. Choose a file name and location
3. Click Save
The logs contain the following files:
• ~/.dcbridgerc
• /var/log/system.log*
• /usr/local/var/dcb/*
• /Library/Logs/com.mobilelabsinc.*
• /Library/Logs/DiagnosticReports/dcb*
• /Library/Logs/DiagnosticReports/deviceBridge*
• /Library/Logs/DiagnosticReports/com.mobilelabsinc.*
• /Library/Application Support/CrashReporter/dcb*
• /Library/Application Support/CrashReporter/deviceBridge*
• /Library/Application Support/CrashReporter/com.mobilelabsinc.*
• /Library/Preferences/SystemConfiguration/*.plist
4.1.6 User Guide
The user guide can be opened and viewed by selecting deviceBridge User Guide from the deviceBridge application
menu.
4.1.7 About deviceBridge
Choosing About deviceBridge will pop open a new window displaying the deviceBridge version and copyright.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
14 / 26
4.1.8 Quit deviceBridge
When you choose the Quit deviceBridge option in the deviceBridge menu, the application will close and disconnect the
servers and devices from the computer. The existing configuration is retained so that when the application is launched
the same servers and devices will be retained.
4.2 deviceBridge Application on Windows
4.2.1 Launch Application
To launch the deviceBridge app:
1. Click on Mobile Labs > deviceBridge in the Windows Start Menu
Notifications will appear in the Windows notification area, at the far right of the taskbar, for various activities like,
devices being connected or disconnected.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
15 / 26
Tip
Right-click for the options to pin to your taskbar or Start menu
Note
In order to connect to Android devices, deviceBridge will need to use a copy of the adb application in the Android SDK.
On launch, it will ask you to specify the location of the Android SDK platform-tools directory. If you wish to change
the location later, you can choose Android SDK Configuration in the Options menu of the deviceBridge Configuration
window.
Note
Non-administrator Windows accounts can run deviceBridge after it has been installed by a user with administrative
privileges. deviceBridge cannot be run by multiple users simultaneously on a client workstation.
4.2.2 Configuration
Use the configuration window to connect servers and devices. To launch the configuration window, right click on
the deviceBridge icon in the notification area and choose deviceBridge Configuration. In the window, when a device
or a server are configured, information about the server or device is displayed. For a server, you can change the
login information by clicking the "Change login. . . " button. Click on the "View in deviceConnect" link to launch
deviceConnect and bring up the device list or device details page.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
16 / 26
Add Server
To add a server to deviceBridge:
1. Click the Add Server. . . button
2. Enter deviceConnect Host
3. If needed, edit the Server Name field. By default it will update to the host entry.
4. Enter your deviceConnect User Account
5. Enter your deviceConnect Password
6. Click OK
Once the server has been added it will immediately be connected.
Add Devices
To add devices to deviceBrige:
1. Click the Add Devices. . . button
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
17 / 26
2. Select one or more devices to connect
3. Click OK
Tip
Double click to instantly add a device and close the window
Note
The add devices window will appear after entering a new server in the configuration window.
Remove Servers and Devices
To remove a server and devices from being connected to the computer with deviceBridge:
1. Select the server or device in the list
2. Click the Remove button
3. Click the OK button on confirmation window
Note
Removing a server will also remove all of the associated devices.
Export Configuration
The deviceBridge configuration details can be exported to a file so they can be saved and loaded at another time.
1. Click the File drop-down menu
2. Choose Export Configuration. . . or Ctrl+E
3. Enter in a file name and location
4. Click the Save button
Note
The file contents are exported in a JSON file format.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
18 / 26
Import Configuration
deviceBridge configurations can be imported making it easier to connect to servers and devices instead of adding each
server and device one by one.
1. Click the File drop-down menu
2. Choose Import Configuration. . . or Ctrl+I
3. Choose a file to import
4. Click the Open button
The servers and devices will then be connected with deviceBridge.
4.2.3 Status
Use the status window to view the status of connected servers and devices. To launch the status window, click on
the deviceBridge icon in the notification area. The servers and devices will appear in the window and display their
connected state to deviceConnect.
4.2.4 Save Logs
In the event that you are experiencing an issue, support may ask for the deviceBridge logs.
1. Select Save Logs. . . in the deviceBrige menu
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
19 / 26
+
. Choose a file name and location . Click Save
The logs contain the following files:
• com.mobilelabsinc.deviceBridge.log
• com.mobilelabsinc.deviceBridge.0.log, com.mobilelabsinc.deviceBridge.1.log, com.mobilelabsinc.deviceBridge.2.log,
...
• dcb.log
• dcb.config
• System Information.txt
Note
The 0.log, 1.log, 2.log files are older versions of the com.mobilelabsinc.deviceBridge log. A new log is started each
day (or when the log becomes too big), and older files’ numbers are rotated. A maximum of five such logs are stored.
4.2.5 User Guide
The user guide can be opened and viewed by selecting deviceBridge User Guide from the deviceBridge application
menu.
4.2.6 About deviceBridge
Choosing About deviceBridge will pop open a new window displaying the deviceBridge version and copyright.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
20 / 26
4.2.7 Quit deviceBridge
When you choose the Exit deviceBridge option in the deviceBridge menu, the application will close and disconnect the
servers and devices from the computer. The existing configuration is retained so that when the application is launched
the same servers and devices will be retained.
5 deviceBridge Command Line Interface
5.1 deviceBridge Command Line Interface for OSX
deviceBridge comes with a Command Line Interface that can be used to connect and disconnect devices that are housed
in deviceConnect.
5.1.1 Installing the binary as a CLI
The deviceBridge application contains a binary file that can be installed to be used as a Command Line Interface.
To install the deviceBridge binary:
1. Follow the steps to install the deviceBridge application.
2. The dcb binary file MUST be copied from /Applications/deviceBridge.app/Contents/MacOS/
to /usr/local/bin/
3. Open Terminal application and execute the following command to make the file executable
sudo chmod +x /usr/local/bin/dcb
Note
the CLI and the GUI cannot be run at the same time as only one deviceBridge instance can be running.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
21 / 26
5.1.2 Running a command
Running a command is as simple as calling "dcb" in a Terminal window. Running the command "dcb" will display the
options that can be used
dcb
The result of the command would be:
deviceConnect Bridge 7.0.0.0
Copyright (c) 2016 Mobile Labs, LLC. All rights reserved.
Usage: dcb [global-options] command [options] args...
Commands:
help - Provides help on a given command.
install - Install dcb as a launchd service (requires root).
uninstall - Uninstall dcb launchd service (requires root).
Global options:
--config - Path to a configuration file.
--debug - Enable debugging output.
Note
The install and uninstall commands will require using "sudo" to run the command.
Examples of some common commands:
dcb
sudo
sudo
sudo
sudo
dcb
dcb
dcb
dcb
install
--debug true install
--config other_config_file install
uninstall
Note
The help command in conjunction with another command will provide more information about the command. For
instance sudo dcb help install will provide more information about the install command.
5.1.3 Connect to a device
To start and connect to devices with deviceBridge, run the following command in a Terminal Window:
sudo dcb install
Once you have the device connected, you can connect to the device with the deviceControl application in the web based
deviceViewer. You should be able to access the desired devices in your development apps such as Xcode, Instruments,
and iTunes.
Tip
Start deviceBridge before opening a connection to the web viewer or other tools that you would like to use.
Note
Since this operation restarts usbmuxd, applications which you intend to use with deviceBridge may need to be
restarted afterwards.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
22 / 26
Note
Xcode takes a long time for a device to appear within the UI due to the amount of device queries it performs. iTunes/Instruments do not take as long.
5.1.4 Disconnect a device
The following command will stop deviceBrige and disconnect the device
sudo dcb uninstall
This will release the devices from deviceConnect as long as there are no other sessions to the device such as the
deviceViewer
Note
If you do not run this command, the device will stay retained or will connect again as soon as a network connection is
established to deviceConnect.
5.1.5 Swapping devices
When you start deviceBridge with "sudo dcb install", the configuration file is copied to the following location: /usr/local/var/dcb/config.json. The deviceBridge process is then started using the .json file. See the Configuration File section
of this document to learn more. In order to change devices during usage
To swap out a device:
1. Edit the contents of /usr/local/var/dcb/config.json. This will require use of sudo, because that file will be owned
by root.
2. To cause the server to re-read /usr/local/var/dcb/config.json, the user sends a SIGHUP signal to the process.
sudo kill -HUP NNNN
Simply replace NNNN with the Process ID of the dcb process. If you do not have the Process ID, the following
can be used:
sudo killall -HUP dcb
Note
The .dcbridgerc configuration file is not changed. It is recommended that you update this file if you want your changes
to be permanent.
Note
If the properties of a server or device are changed, then dcb will treat that as removal of the existing object followed
by insertion of a new object with the new properties. For example, if the "name" field of a device is changed, dcb will
disconnect from that device and then re-connect. As another example, if the "token" field for a server is changed, dcb
will disconnect from that server and all associated devices, then reconnect to the server and its devices.
6 Configuration file
The configuration file is the file that stores the configuration of the servers and devices to run deviceBridge. The
configuration file is stored on OS X as the following file:
$HOME/.dcbridgerc
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
23 / 26
6.1 Configuration file contents
In order to easily build a deviceBridge configuration file, use the deviceBridge application. The deviceBridge configuration file is automatically generated and updated as you use the application.
The configuration file is a file that contains the configuration in JSON format. The servers entry is a JSON Array of the
following objects.
Object
isHttpsWeb
host
name
token
user
linkedDevices
Description
Boolean: Determines if the deviceConnect web interface is accessed via
HTTPS.
String: The IP or DNS name of the deviceConnect server
String: A name of the deviceConnect server that is meaningful to the user
String: The API token of the deviceConnect user
String: The username for the deviceConnect user
JSON Array: A json schema of the devices to connect via deviceBridge
Each linkedDevices contains the following information in the servers section has the following items:
Object
id
os
name
vendorUniqueIdentifier
Description
GUID: The deviceConnect ID of the device. This can be found in the
URL of the browser for the device details page of this device.
String: iOS or Android
String: The name of the device in deviceConnect
String: The vendor unique identifier in deviceConnect. For iOS this is
the UDID of the device. For Android this is the serial number.
Note
Android is not yet supported.
6.2 Sample Configuration
{
"servers" : [
{
"isHttpsWeb" : false,
"linkedDevices" : [
{
"id" : "c933508d-9927-4803-93e4-2171435c7464",
"os" : "iOS",
"name" : "IPHONE5",
"vendorUniqueIdentifier" : "14af9f6fc2f30e284a8464d43594fb16976e2e56"
}
],
"host" : "10.0.1.100",
"name" : "10.0.1.100",
"token" : "ceba3df1-b9d1-415f-a704-be29a3838899",
"user" : "[email protected]"
}
]
}
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
24 / 26
7 deviceBridge Maintenance and Management
7.1 deviceBridge logs
Sometimes it is necessary to looks at the deviceBridge logs to review the actions of the system. The deviceBridge
system logs the output to the following logs:
7.1.1 OS X
/Library/Logs/com.mobilelabsinc.dcb.log
/var/log/system.log
The first log file mentioned above contains only the deviceBridge log information. The second log mentioned above
contains all of the logs of the computer system including the deviceBridge logs. The deviceBridge log file is rotated to
have a maximum file size of 5MB with a total log file size of 20MB. The extneded logs will have sequential numbers
and are g-zipped, as well as logs that are older than 14 days will be removed.
7.1.2 Windows
%APPDATA%\Local\Mobile Labs\deviceBridge\dcb
%APPDATA%\Local\Mobile Labs\deviceBridge\System Information
The first log file mentioned above contains only the deviceBridge log information. The second log mentioned above
contains all of the logs of the computer system including the deviceBridge logs.
8 Mobile Labs Support
We work hard to make our products easy to use and trouble-free, but if you have questions or issues with any of our
products, please contact us! We are easy to reach and always at-hand if needed.
We strive to be easy to do business with, to keep our promises, and to put our customers first. Our global support team
is available whenever you need them to keep your Mobile Labs products running at their peak.
If you have a question or issue, you can quickly open a Support Ticket with our customer support team at http://support.mobilelabsinc.com
Our team will be notified immediately and a support ticket will be automatically opened in our tracking system. You
can expect a prompt reply with an answer or next steps to resolve your issue.
If you need immediate assistance after hours, you can reach us at +1-888-975-2066. Simply leave a phone number
where you can be reached, and a Mobile Labs support manager will return your call.
For more information about Mobile Labs support or for general questions and/or concerns, please call our main number,
404-214-5804. You can also reach us by email: [email protected].
THANK YOU for being a Mobile Labs customer!
8.1 Upgrading deviceConnect Server
Mobile Labs reminds you to consult with Mobile Labs Support before applying any upgrades or making any modifications to your deviceConnect server(s). The deviceConnect servers are configured especially for deviceConnect
functions, are optimized for security and performance, and are therefore sensitive to OS X software levels and file structure. Modifications to the Mac OS X system, including Apple-supplied upgrades, can cause a deviceConnect outage
and could necessitate a lengthy repair or replacement process. In particular, please do not accept prompts to download
or apply upgrades to the operating system. The deviceConnect server is not configured to support general user-land use;
logins to the Mac OS should only occur at the suggestion of our Support personnel. Please consult with Mobile Labs
Support before making any changes as we want you to always have 100 per cent availability.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
25 / 26
9 Legal Notices
Confidential and Proprietary
The information contained in this document is confidential and proprietary to Mobile Labs, LLC. No part of this guide
may be distributed or disclosed in any form to any third party without written permission of Mobile Labs, LLC.
Disclaimers
The information contained herein is subject to change without notice.
Mobile Labs shall not be liable for technical or editorial errors or omissions contained herein.
Copyrights
Copyright © 2016 Mobile Labs, LLC. All rights reserved.
Trademarks
Mobile Labs is a trademark of Mobile Labs, LLC.
deviceConnect is a trademark of Mobile Labs, LLC.
deviceBridge is a trademark of Mobile Labs, LLC.
Mobile Labs Trust is a trademark of Mobile Labs, LLC.
iOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license.
App Store is a service mark of Apple Inc.
Xcode is a registered trademark of Apple Inc.
iTunes is a registered trademark of Apple Inc.
Android is a trademark of Google Inc.
Amazon, Kindle, Fire and all related logos are trademarks of Amazon.com, Inc. or its affiliates.
Microsoft, Windows, Windows XP are U.S registered trademarks of Microsoft Corporation in the United States and
other countries.
HP Unified Functional Testing is a registered trademark of Hewlett-Packard Development Company. HP and the names
of any other HP products referenced herein are trademarks and/or service marks or registered trademarks and/or service
marks of Hewlett-Packard Development Company, L.P., and/or its subsidiaries.
Copyright © 2016 Mobile Labs, LLC. All rights reserved. Confidential and Proprietary
26 / 26