Installing RemoteSpark via Sideload (2.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 Kognitiv Spark 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 Installation on HoloLens - 3 Options

Option #1: 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 (MSIXBUND 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.
      
11. Click Install.
    

Option #2: 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.
   • Pro-Tip: You can also use the voice command "What is my IP address", and HoloLens will provide the IP in your field of view.
     
     
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.
11. Click Install.
    

Option #3: 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/11 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.

Powershell: You will need to set an ExecutionPolicy to 'RemoteSigned' during the sideload process. Please ensure that changing the ExecutionPolicy is allowed in your group settings before proceeding.

You can check your ExecutionPolicy first by running Get-ExecutionPolicy.

If you change your ExecutionPolicy during the installation it is recommended that you change it back to its previous setting after the installation using Set-ExecutionPolicy.

Sideload Installation on PC - 2 Options

Option #1: 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.
   
   

Option #2: 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 MSIXBUNDLE file.
2. Click Open.
3. Click Install.

If you run into any issues during Sideload Installation on either the PC or HoloLens, please contact the Kognitiv Spark Support Team for help.