LiveTiles Design v.4.0 Installation Guide
Version: 1.0
Page |1
Version History Version Number 0.1 1.0
Comments Initial draft Release version
Page |2
Contents Contents.......................................................................................................................................................................................... 3 1.1 2
Pre-requisites for installation ....................................................................................................................................... 4 Installation into Office 365 ................................................................................................................................................ 5
2.1
Turn on Custom Scripting for tenant (may already be turned on for your tenant) ................................ 5
2.2
Create App Catalog .................................................................................................................................................. 6
2.3
Upload the LiveTiles Design Manager App file ................................................................................................. 8
2.4
Install the apps into the target site collection .................................................................................................... 9
2.5
Register licence key ................................................................................................................................................. 10
Page |3
1 Overview Version 4 of LiveTiles Design is deployed using a dedicated app called LiveTiles Design Manager. The app handles the deployment of the LiveTiles subsite and associated assets into your chosen SharePoint site collection. The Manager app is also used to uninstall the solution from an environment. Once deployed most of the functionality of LiveTiles Design is delivered centrally from a content delivery network (CDN) minimising the need for app updates. This document details the steps required for installation of LiveTiles Design v.4.
1.1
Pre-requisites for installation
You will need the following in place in order to successfully install LiveTiles Design v.4:
User account with SharePoint tenant administrator permissions (required for app catalog set up only) Access to your Organisation App Catalog User account with Site Administrator permissions (for app installation and LiveTiles deployment). The LiveTiles Design Manager app file Your LiveTiles licence details.
Page |4
2 Installation into Office 365 Open and log into the Office 365 tenant using https://portal.office.com/admin/default.aspx#EAdminDefaultPage_AdminHomePageESKU_AdminDashboar dPage
2.1
Turn on Custom Scripting for tenant (may already be turned on for your tenant)
Check that the Custom Scripts option is turned on for your SharePoint tenant. Go to: https://-admin.sharepoint.com/_layouts/15/online/TenantSettings.aspx
If the settings are both set to Allow move to Section 2.2 below. If set to Prevent change them to Allow for both Custom Script options Click OK
This setting change can take up to 24 hours to apply. If you require it to have immediate effect you can the SharePoint Online Management Tool to change the setting: Use the SharePoint Online Management Tool to execute the following PowerShell commands to turn on Allow Custom Scripting for the tenant. (Download the Management tool at: https://www.microsoft.com/en-gb/download/details.aspx?id=35588) Connect-SPOService
Enter URL for the SharePoint admin site: https://-admin.sharepoint.com Page |5
Enter tenant admin username and password:
(note: the username is in the format
[email protected]) Set-SPOsite -DenyAddAndCustomizePages 0
You also need to make sure the custom scripting setting in the admin portal matches what you set using PowerShell or the site collection setting may be overridden again in the next 24 hours Open https://-admin.sharepoint.com/_layouts/15/online/TenantSettings.aspx
2.2 Create App Catalog The LiveTiles Design Manager app is deployed via the SharePoint organisation app catalog. If you do not already have an app catalog in your Office 365 tenant you will need to create one. Go to the SharePoint Admin centre using the link in the portal left hand menu:
Click the apps link:
Page |6
Click App catalog
Select “Create a new app catalog site” and click OK
Page |7
Configure the app catalog as you wish and click OK
2.3 Upload the LiveTiles Design Manager App file Locate your copy of the LiveTiles Design Manager App file Open the SharePoint App Catalog (e.g. https://.sharepoint.com/sites/apps/AppCatalog)
Click New Upload the LiveTiles Design Manager App file.
Page |8
2.4 Install the apps into the target site collection Open the SharePoint site collection you wish to use LiveTiles Design in (e.g. https://.sharepoint.com/) Go to Site Contents Click add an app Install the LiveTiles Design Manager app (you should see it under the Apps you can add section):
You will be prompted to Trust the app with its associated permissions. Once the installation process is completed you will see the app under Site Contents:
Launch the LiveTiles Design Manager App.
Click the pink Install button. The page will update with the successful installation
Page |9
Click the pink Go to LiveTiles Design
2.5 Register licence key You will be prompted that the product has not been registered.
Click OK
Enter your licence details into the registration form: Tick the End-User Agreement checkbox Click Register
P a g e | 10
Click OK You are now ready to start using LiveTiles Design v.4!
P a g e | 11