Installing RemoteSpark via Sideload (1.9.x)

TABLE OF CONTENTS

• Sideload on HoloLens - prerequisites
• Sideload on HoloLens using Windows Device Portal (USB)
• Sideload on HoloLens using Windows Device Portal (WiFi)
• Sideload on HoloLens using Mobile Device Management
• Sideload on PC - prerequisites
• Sideload on PC using PowerShell
• Sideload using Windows App Installer
  • Import the Security Certificate
  • Install Dependencies
  • Install RemoteSpark app package

Note: to install RemoteSpark by sideloading, you will first need to have received an app package from our Operations team.

Sideload on HoloLens - prerequisites

IMPORTANT: to side load an application, the HoloLens must be in Developer Mode and the Device Portal must be turned on.

To enable Developer Mode: open Settings > Update & Security> For Developers. 

Set Developer Mode to ON

*Note: Developer Mode can be turned OFF after the installation is complete. It only needs to be turned on for the duration of RemoteSpark’s installation.

The Device Portal is a web server on your HoloLens that you can connect to via USB or WiFi on your PC.  If you haven’t yet set up the HoloLens Device Portal, see here for instructions.

To enable the Device Portal: open Settings > Update & Security> For Developers. 

Set Device Portal to ON

Note: for any sideload installation of RemoteSpark on the HoloLens, you will need a PC to connect with the device (either over WiFI or USB).

Sideload on HoloLens using Windows Device Portal (USB)

1. Extract (unzip) the RemoteSpark app package.
2. Connect the HoloLens to your PC with a USB-C cable.
   • If you have a 1st generation HoloLens, this will be a micro-USB cable.
3. From a web browser on your PC, go to https://DEVICEIP:10080/
   • To find your device IP, open your menu and navigate to Settings > Network & Internet > Select your wifi connection > Advanced options > IPv4 address
   • You should an error message “This site is not secure”, click Details (or Advanced on other browsers) and go on to the website.
     
4. Log in when prompted.
   • If it’s the first time you’ve logged in to the Device Portal, you’ll need to create a user name and password.
     
5. Click Apps under Views on the side navigation bar.
6. Click Browse/Choose File under Select application package.
   • Select RemoteSpark (APPXBUNDLE File).
7. Select the checkbox for Allow me to select framework packages.
   
8. Click Next.
9. Click Browse/Choose File under Choose any necessary dependencies.
10. From the Dependencies folder of the RemoteSpark file, select an arm dependency. Click Open.
    • Repeat this step for each dependency as you can only select one at a time.
      
    • Note: if you have a 1st generation HoloLens, you will need to select the x86 dependencies instead of arm.
11. Click Install.
    

Sideload on HoloLens using Windows Device Portal (WiFi)

Important: the HoloLens and PC will need to be on the same WiFi network to install RemoteSpark with this method.

1. Extract (unzip) the RemoteSpark app package.
2. On your HoloLens, locate the device’s IPV4 address from the Settings application under Network and Internet/WiFi/Advanced Options (of the WiFi network you are using).
   
   • You can also scroll to the bottom of the WiFi network list and select Hardware Properties to find the IPV4 address.
3. On a PC that’s connected to the same WiFi network as the HoloLens, type the IP address of the HoloLens in your web Browser to bring up the Windows Device Portal.
   
   • You should an error message “This site is not secure”, click Details (or Advanced on other browsers) and go on to the website.
     
4. Log in when prompted.
   • If it’s the first time you’ve logged in to the Device Portal, you’ll need to create a user name and password.
     
5. Click Apps under Views on the navigation bar along the left side of the home page of the Device Portal interface.
6. Click Browse/Choose File under Select application package.
   • Select RemoteSpark (APPXBUNDLE File).
7. Select the checkbox for Allow me to select framework packages.
   
8. Click Next.
9. Click Browse/Choose File under Choose any necessary dependencies.
10. From the Dependencies folder of the RemoteSpark file, select an arm dependency. Click Open.
    • Repeat this step for each dependency as you can only select one at a time.
      
      
    • Note: if you have a 1st generation HoloLens, you will need to select the x86 dependencies instead of arm.
11. Click Install.
    

Sideload on HoloLens using Mobile Device Management

Please see here for tips on installing applications on HoloLens with MDM.

Sideload on PC - prerequisites

These are the steps for sideloading RemoteSpark on a Windows 10 PC/tablet.

IMPORTANT: ensure that your device has developer mode enabled.

On un-managed devices, this can be done by going to Settings > Update & Security > For Developers.

Set Developer Mode to ON.

*Note: Developer Mode can be turned OFF after the installation is complete. It only needs to be turned on for the duration of RemoteSpark’s installation.

On managed devices, this can be done by deploying an Enterprise Policy.

Sideload on PC using PowerShell

1. Extract (unzip) the RemoteSpark app package.
2. Right click on the Install file (PowerShell Script).
3. Select Run with PowerShell.
   
4. When the PowerShell window opens, follow prompts to run the installer.
   

Sideload using Windows App Installer

Tip: to install using Windows App Installer,  check to make sure it’s installed on your machine.

Import the Security Certificate

1. Double click the certificate (.cer file) to launch the Certificate Import Wizard.
   
2. Install the certificate in Local Machine – click Next.
   
   • A user Account Control window prompt will appear on-screen: “Do you want to allow this app to make changes to your computer?”
     
3. Click Yes. 
   • A 2nd Certificate Import Wizard window will appear on-screen.
4. Select Place all certificates in the following store – click Browse
   
5. Do not select Automatically select the certificate store based on the type of certificate.
6. A Select Certificate Store window will appear on-screen.
7. Select Trusted People – click OK.

Install Dependencies

Return to the File Explorer window with RemoteSpark.

1. Click the Dependencies folder.
   
2. Click (x86).
   
3. Click on each dependency to install.
4. Click Open.
5. Click Install.
   

Install RemoteSpark app package

Return to File Explorer window with all RemoteSpark files

1. Double click the RemoteSpark .appx file.
   
2. Click Open.
3. Click Install.