Setup the SharePoint server for harmon.ie Mobile

harmon.ie Mobile Knowledge Base - Enterprise Edition

This article describes how to setup the SharePoint server for harmon.ie Mobile, in all SharePoint versions and Office 365.

This setup is required in order to activate the harmon.ie Mobile app.

Follow these steps to setup, upgrade, or remove the SharePoint configuration for harmon.ie.

Setup the SharePoint server for harmon.ie Mobile:

Follow these steps:

  1. Create harmonieFiles directory library on the SharePoint server.
  2. Create harmon.ie users list, to track who is using harmon.ie (optional). This feature applies to SharePoint on-premise only.
  3. Copy the license file to the SharePoint server. This is required to activate the app.
  4. Copy the provisioning file to the SharePoint server, to set startup values for all users (optional).

Create harmonieFiles directory library:

This procedure applies to all SharePoint versions and to Office 365.

Note: If you are working with SharePoint on-premise and you decided to track who is using harmon.ie, skip to create harmon.ie users list.

If you are working with Office 365:

  1. Download the PowerShell script file and extract it to a local folder.
  2. Open the SharePoint Online Management Shell, and launch the CreateHarmonieLibrary.ps1 script.
  3. Follow the on-screen instructions to create the harmonieFiles document library in your site.
    If the SharePoint Management Shell is not installed or in case running PowerShell scripts is prohibited, the document library can be created manually, and it must be named harmonieFiles.

If you are working with SharePoint on-premise:

Create a document library called harmonieFiles in your site.

Create harmon.ie users list:

This procedure applies to SharePoint on-premise (2010 and 2013).

  1. Ask harmon.ie support for the Server Component that matches your SharePoint version.
  2. Open a Command Prompt and run the following commands to install and activate the harmon.ie Enterprise solution and harmon.ie Enterprise Mobile Users feature, which creates a list called harmon.ie Mobile Users and a document library called harmonieFiles in the root of the selected SharePoint server.
    1
    2
    3
     
    4
    5
    cd %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\{15|14}\BIN
    stsadm -o addsolution -filename <full path>\harmonieEnterprise{2013|2010}.wsp
    stsadm -o deploysolution -name harmonieEnterprise{2013|2010}.wsp -immediate -allowGacDeployment
    -url <site URL>
    stsadm -o installfeature -name "HarmonieEnterpriseMobileUsers" -force
    stsadm -o activatefeature -name "HarmonieEnterpriseMobileUsers" -url <site URL>

Notes:

  • Replace <site URL> with the site or site collection URL on which you want to install the harmon.ie Enterprise solution.
  • Change the number in the paths above according to your SharePoint Server version (15 for SharePoint 2013, 14 for SharePoint 2010).
  • harmon.ie solution adds a new permission level called Add Only. This permission is used by the harmon.ie Mobile user list. For more information, read Manage harmon.ie Mobile Enterprise users.

Limitation: It is not possible to install and activate a feature on a sub-site which is set to use unique permissions.

Copy license file to the SharePoint server:

  1. Login to the download area with the user name and password you received in the harmon.ie Order Fulfillment email.
  2. Click the Mobile / App for Office button to download the harmon.ie Mobile license file.
  3. Extract the downloaded zip file and copy the license file to the harmonieFiles library which was created on the SharePoint server in the previous step.
    Note: The file must be named harmon.ie.lic when uploaded to the document library.

Copy provisioning file to the SharePoint server:

Note: This step is optional.

Copy the provisioning file to the harmonieFiles library. It is recommended to sign the provisioning file prior to uploading it to the library, to prevent making changes to it inadvertently, and to assure the users that the provisioning file is originated from your company's administrator.
Note: The file must be named ios.provisioning.harmonie, android.provisioning.harmonie, or provisioning.harmonie when uploaded to the document library. harmon.ie first looks for a platform-specific provisioning file. If such is not found, then provisioning.harmonie is taken.

Upgrade the SharePoint configuration:

  1. If your license file has expired, or is about to expire: obtain a new license file from sales@harmon.ie. Copy the license file to the harmon.ieFiles document library.
    Note: The file must be named HarmonieEnterpriseEdition.lic when uploaded to the document library.
  2. Follow this procedure to replace the provisioning file.
  3. Follow this procedure to upgrade the Enterprise solution which manages the users list.

Upgrade the Enterprise solution and users list:

Open a Command Prompt and run the following commands to upgrade the harmon.ie Enterprise solution.

1
 
2
3
stsadm -o upgradesolution -name harmonieEnterprise{2013|2010}.wsp -filename <full path>\harmonieEnterprise{2013|2010}.wsp -immediate -allowGacDeployment
stsadm -o deactivatefeature -name "HarmonieEnterpriseMobileUsers" -url <site URL>
stsadm -o activatefeature -name "HarmonieEnterpriseMobileUsers" -url <site URL> -force

Notes: Replace <site URL> with the site or site collection URL on which you want to upgrade the harmon.ie Enterprise solution.

To force upgrading the Enterprise solution immediately, run the following commands:

1
2
3
4
stsadm -o execadmsvcjobs
net stop SPAdminV4
Start-SPAdminJob
net start SPAdminV4

Remove the setup configuration for harmon.ie:

  1. To remove the provisioning and licensing, delete the harmonieFiles document library and its content.
  2. Follow these directions to remove the Enterprise solution and users list.

Remove the Enterprise solution and users list:

Open a Command Prompt and run the following commands:

1
2
3
4
5
cd %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\{15|14}\BIN
stsadm -o deactivatefeature -name "HarmonieEnterpriseMobileUsers" -url <site URL>
stsadm -o uninstallfeature -name "HarmonieEnterpriseMobileUsers" -force
stsadm -o retractsolution -name harmonieEnterprise{2013|2010}.wsp -immediate -allcontenturls
stsadm -o deletesolution -name harmonieEnterprise{2013|2010}.wsp

Notes:

  • Change the number in the paths above according to your SharePoint Server version (15 for SharePoint 2013, 14 for SharePoint 2010).
  • Replace <site URL> with the site or site collection URL on which you installed the harmon.ie Enterprise solution.

In addition:

  1. Delete the harmon.ie Mobile Users list.
  2. Delete the Add Only permission level from the Site Settings.

Troubleshooting

If users are experiencing intermittent "License not found" errors in harmon.ie Mobile, after the server component was deployed, try one of the options described in this MSDN article Error: "The sandboxed code execution request was refused because the Sandboxed Code Host Service was too busy to handle the request" (Ricky Kirkham).