Navigate Up
Sign In
Supporters of Developer
Web

Configure an Environment for Apps for SharePoint 2013

Item is currently unrated. Press SHIFT+ENTER to rate this item.1 star selected. Press SHIFT+ENTER to submit. Press TAB to increase rating. Press SHIFT+ESCAPE to leave rating submit mode.2 stars selected. Press SHIFT+ENTER to submit. Press TAB to increase rating. Press SHIFT+TAB to decrease rating. Press SHIFT+ESCAPE to leave rating submit mode.3 stars selected. Press SHIFT+ENTER to submit. Press TAB to increase rating. Press SHIFT+TAB to decrease rating. Press SHIFT+ESCAPE to leave rating submit mode.4 stars selected. Press SHIFT+ENTER to submit. Press TAB to increase rating. Press SHIFT+TAB to decrease rating. Press SHIFT+ESCAPE to leave rating submit mode.5 stars selected. Press SHIFT+ENTER to submit. Press SHIFT+TAB to decrease rating. Press SHIFT+ESCAPE to leave rating submit mode.

You may also be interested in: SharePoint Fest Denver 2013

 

Editor's note: Contributor Vlad Catrinescu is a SharePoint Consultant. Follow him @vladcatrinescu

One of the new features of SharePoint 2013 is the SharePoint Store. Similar to the Windows Phone Marketplace and Google Play Store, this new feature gives site owners the ability to discover and download apps for SharePoint from the store and install them on their SharePoint Sites. Furthermore, if you are a developer for your company, you will need to setup your environment to host apps if you want to test them.

The following are examples of apps for SharePoint that site owners could add to their sites:

  • An app that provides event planning tools.
  • An app that provides a shopping cart experience for a site.
  • An app that sends a note of recognition for good work (kudos) to someone in the organization.

When you install SharePoint 2013, by default this functionality is not supported and users will get the following error when they try to install an application.
Sorry, apps are turned off. If you know who runs the server, tell them to enable apps.

2013-02-13-AppsEnvironment-01.png

This article will provide IT Professionals and Developers a step by step guide with screenshots on how to make your SharePoint 2013 environment capable of using SharePoint Store applications.

This is what you need before you start

  • Have a Farm Administrator account with the DBCreator and SecurityAdmin roles on the SQL Server.
  • Have a Domain Admin account.

Here is a an overview of what we will do

  • Create a forward lookup zone for apps
  • Link the App Domain to the SharePoint Server
  • Start the required Services
  • Create the Subscription Settings and App Management Service Applications
  • Configure The App URL’s in SharePoint
  • Fix the “Out of the Box” errors
  • Test our environment

1. Create a forward lookup zone for apps

SharePoint 2013 Apps have their own, isolated URLs, which are separate from the URLs of the sites where the app is being deployed to and where the app is being used. In order to provide isolation apps should run in their own domain, instead of in the same domain name as your farm. Using a different domain name for apps helps prevent cross-site scripting between apps and SharePoint sites.

Microsoft recommends that the new domain name should NOT be a subdomain of the domain that hosts the SharePoint Sites. For example, if the SharePoint sites are at matrinescu.com, consider mcatrinescuApps.com instead of app.mcatrinescu.com as the domain name.

  1. Verify that the user account that performs this procedure is a local administrator on the domain controller.
  2. Click Start, point to Administrative Tools, and then click DNS.
  3. In DNS Manager, right-click Forward Lookup Zones, and then click New Zone….

2013-02-13-AppsEnvironment-02.png

  1. In the New Zone Wizard, click Next.

2013-02-13-AppsEnvironment-03.png

  1. In the Zone Type page, accept the default of Primary zone, and then click Next.

2013-02-13-AppsEnvironment-04.png

  1. In the Active Directory Zone Replication Scope page, select the appropriate replication method for your environment (the default is to all DNS servers in this domain), and then click Next.

2013-02-13-AppsEnvironment-05.png

  1. In the Zone Name page, in the Zone name box type the name for your new app domain name (for example, mcatrinescuApps.com), and then click Next.

2013-02-13-AppsEnvironment-06.png

  1. On the Dynamic Update page, select the appropriate type of dynamic updates for your environment (the default is Do not allow dynamic updates), and then click Next.

2013-02-13-AppsEnvironment-07.png

  1. On the Completing the New Zone Wizard page, review the settings, and then click Finish.

2013-02-13-AppsEnvironment-08.png

Don’t Forget: If you plan to use apps on an internet-facing website, you have to buy this domain name! Furthermore, even if you only use it internally, it’s always better to buy it before someone else buys it and registers it in the public DNS.

2. Link the App Domain to the SharePoint Server

We now need to instruct our DNS to forward all the requests from mcatrinescuapps.com to the SharePoint Server hosting the apps

  1. Verify you are logged in as a Domain Admin
  1. In DNS Manager, under Forward Lookup Zones, right-click the new app domain name, and then click New Alias (CNAME).

2013-02-13-AppsEnvironment-09.png

  1. In the New Resource Record dialog box, in the Alias name (uses parent domain if left blank) box, type *.
  1. Next to the Fully qualified domain name (FQDN) for target host box, click Browse and navigate to the Forward Lookup Zone for the domain that hosts the SharePoint sites and then navigate to the record that points to the server that hosts the SharePoint site.

2013-02-13-AppsEnvironment-10.png

  1. Click OK.

To verify the new domain name

This is just a little step to make sure everything we did until now is right.

  1. Click Start, and then click Command Prompt.
  1. At the command prompt, type ping followed by a subdomain of the domain that you created, and then press ENTER. (EX: ping vlad.mcatrinescuapps.com) where vlad is a random word and mcatrinescuapps.com is your newly created domain.

2013-02-13-AppsEnvironment-11.png

If the ping command returns the correct IP address, then your wildcard for the domain name was configured successfully.

3. Starting the required services

Apps rely on the App Management and Microsoft SharePoint Foundation Subscription Settings service applications. These service applications use the multi-tenancy features to provide app permissions and create the subdomains for apps. Therefore, even if you are not hosting multiple tenants, you must still establish a name for the default tenant for your environment (any SharePoint site that is not associated with a tenant will be in the default tenant). In this step we will start the two required services!

  1. Verify that you are a member of the farm administrators group in Central Administration.
  2. In SharePoint 2013 Central Administration, click System Settings.
  3. On the System Settings page, under Servers, click Manage services on server.
  4. On the Services on Server page, next to App Management Service, click Start.
  5. On the Services on Server page, next to Microsoft SharePoint Foundation Subscription Settings Service, click Start.
  6. 2013-02-13-AppsEnvironment-12.png

  7. Verify that the App Management and Microsoft SharePoint Foundation Subscription Settings services are running.

4. Creating the Subscription Settings and App Management Service Applications

In this step we will create the two Service Applications we talked about in the previous step. As you know, Microsoft is strongly promoting PowerShell to the SharePoint Administrators, and to make sure you start using it, they made it the only way to configure the Subscription Settings Service Application. Since we will be doing PowerShell for the first one, we will both in PowerShell.

Verify that you have the following memberships:

    • securityadmin fixed server role on the SQL Server instance.
    • db_owner fixed database role on all databases that are to be updated.
    • Administrators group on the server on which you are running the Windows PowerShell cmdlets.
  1. In the configureSubscriptioSettingservice.ps1 script, change the values that are in blue in the following script. You download the script from http://sdrv.ms/TvjLOS

2013-02-13-AppsEnvironment-13.png

  1. In the configureAppManagementServiceApp.ps1 script, change the values that are in blue in the following script. You download the script from http://sdrv.ms/TvjLOS

2013-02-13-AppsEnvironment-14.png

  1. Open SharePoint 2013 Management Shell as an Administrator and run the scripts.

2013-02-13-AppsEnvironment-15.png

5. To configure app URLs

  1. In Central Administration, click Apps.

2013-02-13-AppsEnvironment-16.png

  1. On the Apps page, click Configure App URLs.

2013-02-13-AppsEnvironment-17.png

  1. In the App domain box, type the isolated domain that you created for hosting apps.
  1. In the App prefix box, type a name to use for the URL prefix for apps.

2013-02-13-AppsEnvironment-18.png
Original picture by Chris Whitehead and Sam Hassani

Here is how your URL will look like depending on the settings!

2013-02-13-AppsEnvironment-19.png

  1. Click OK.

5.5 To configure Internet-facing endpoints for apps (Optional)

The SharePoint Store contains apps for SharePoint intended for use with sites that require Internet-facing endpoints. By default, these apps are not available (greyed out and cannot be purchased) because they are incompatible with most sites. However, if your farm is configured to allow internet-facing end points, you can turn on the Internet-facing endpoints feature to show these apps in the SharePoint Store. You turn this feature on in Central Administration.

  1. In Central Administration, click Application Management.
  2. On the Application Management page, click Manage Web applications.
  3. On the Manage Web Applications page, select the web application that you want to change.
  4. On the ribbon, click Manage Features.
  5. 2013-02-13-AppsEnvironment-20.png

  6. In the feature list, next to Apps that require accessible internet facing endpoints, click Activate.
  7. 2013-02-13-AppsEnvironment-21.png

  8. Click OK.

6. Fix the “Out of the Box” errors.

Our environment is now fully setup, however there is a little problem. Back in step 1, we created a new domain that will host our apps. When a user is browsing the site www.mcatrinescu.com and clicks an app, he will be forwarded to www.apps-00000(ID).mcatcatrinescuapps.com. We told our DC to forward those requests to our Front End, however SharePoint and IIS don’t understand it yet! How do we usually fix two URL’s going at the same site? AAM (Alternate access Mapping), but do you imagine doing this for every App? Luckily, there is a simpler way to fix this. We will create an empty-host header Web Application.

Since a picture is worth 1000 words, we are trying to get from here:

2013-02-13-AppsEnvironment-22.png
Original picture by Chris Whitehead and Sam Hassani

To here:

2013-02-13-AppsEnvironment-23.png
Original picture by Chris Whitehead and Sam Hassani

In case you are wondering, here is the 404 error you get if you try an app without applying the fix

2013-02-13-AppsEnvironment-24.png

Now, Let’s Fix it.

  1. Go into Central Administration and click Application Management
  2. Go into Manage Web Applications and create a new Web Application
  3. Click on New, set the Port to 80 and do not enter anything in the Host Header
  4. 2013-02-13-AppsEnvironment-25.png

  5. After that, you create a Site Collection using the Team Site
  6. 2013-02-13-AppsEnvironment-26.png

Now, we have to delete the Default Web Site from IIS!

  1. Go into IIS Manager as an administrator, and expand your Sites.
  2. Right click on the Default Website, and select Remove

2013-02-13-AppsEnvironment-27.png

7. Testing our Environment

Now that everything is set up we can finally test if we can run a simple application on our environment.

  1. Go on a Site Collection on which you are a Site Collection Administrator, click on the Settings “wheel” and “Add an app”

2013-02-13-AppsEnvironment-28.png

  1. In the Menu on the left side, choose “SharePoint Store”

2013-02-13-AppsEnvironment-29.png

  1. Select the language at the top right, and choose an application! For my test I took the myFAQ application.

2013-02-13-AppsEnvironment-30.png

  1. Click the big “ADD IT” button, and then sign in with your LiveID and password.
  1. After than, you will get the message “You Just got this app for everyone in your organization”. Now, leave the checbox “Add this app to [SiteName] Checked, and click the Return to Site button.

2013-02-13-AppsEnvironment-31.png

  1. In the next screen, click the “Trust It” button.

2013-02-13-AppsEnvironment-32.png

  1. Now, we give it a minute and we should be able to access your newly installed app. The MyFAQ looks like this

2013-02-13-AppsEnvironment-33.png

I hope this tutorial has been informative and clear enough to guide you through each step of the way. If you get any errors, or something is not clear, please leave a comment and I will answer as soon as possible! You can also download this document here for further reference: http://sdrv.ms/TvjLOS

Categories: SPF 2013; PowerShell; SQL; dev

Comments

Vlad Catrinescu

Images

Hello, I just wanted to share with everybody that there are 3 images in this article that I found on Google and thought they were from Microsoft, however they are the property of Sam Hassani and Chris Whitehead. The three pictures are: The App URL format, and the two images of how the app url is routed. I always give credit where credit is due, and this is an honest mistake. Thanks!

Posted 16-Feb-2013 by Vlad Catrinescu
Devendra Velegandla

Nice Post

Thanks for Sharing the Post Devendra

Posted 17-Feb-2013 by Devendra Velegandla
SharePoint Fat

Credit???

That's a good article but the author should list the references he put in his article. The 3 images Vlad mentioned belong to those Microsoft PFEs.
 
Please take that as advice.

Posted 18-Feb-2013 by SharePoint Fat
Vlad Catrinescu

Credit

Hi "SharePoint Fat" .. I did mention in the first comment that the images are theirs, and in the "downloadable" version I also added credits and references. I cannot change the article here, if no I would have added it as well.

Posted 19-Feb-2013 by Vlad Catrinescu
Soeren Nielsen

Step 6 need to be supplemented a bit

Thanks or the guide. Worked well. But in your step 6 I believe it is worth mentioning that the requirement is that a SharePoint site respond to the app domain host name. In many scenarios it will be a lot easier to simply let the normal site the user is browsing respond, eg. make the intranet the default website on the server.

Posted 30-Jun-2013 by Soeren Nielsen
gabriel

thanks , its great article easy to understand.

thanks , its great article easy to understand. gabriel www.gjgsoftware-com

Posted 06-Jul-2013 by gabriel
Kathy

Good article

What you say makes a lot of sense. I was getting a 404 error, so I followed the instructions, but now when I try to access an app, I get a blank page. Ideas?

Posted 17-Jul-2013 by Kathy
Kathy

Good article

What you say makes a lot of sense. I was getting a 404 error, so I followed the instructions, but now when I try to access an app, I get a blank page. Ideas?

Posted 22-Jul-2013 by Kathy
Tommy

cant create an new web

Hi
 
Sorry, something went wrong
The IIS Web Site you have selected is in use by SharePoint. You must select another port or hostname.
 
i got our intranet on port 80 and mysite on port 80
any ideas what to do? 

Posted 24-Jul-2013 by Tommy
Tommy

cant create an new web

Hi
 
Sorry, something went wrong
The IIS Web Site you have selected is in use by SharePoint. You must select another port or hostname.
 
i got our intranet on port 80 and mysite on port 80
any ideas what to do? 

Posted 24-Jul-2013 by Tommy
Tommy

cant create an new web

Hi
 
Sorry, something went wrong
The IIS Web Site you have selected is in use by SharePoint. You must select another port or hostname.
 
i got our intranet on port 80 and mysite on port 80
any ideas what to do? 

Posted 24-Jul-2013 by Tommy
ahmed

best

I have been previously exploring for quite a while for one pleasant articles thesis writing service or blog posts on the subject of this subject matter .

Posted 26-Jul-2013 by ahmed
shg

df

In the Sector Identity attendant, in the Area label package example the best dissertation christen for your pristine app jurisdiction call.

Posted 14-Aug-2013 by shg
paromita

Need Help

Hi
I find this article best among all the articles available for configuring apps. Thanks a lot.
 
I am stuck at DNS configuration. I have created zone and alias as explained by you but its unble to ping the domain. Can you please give me some pointers.
 
Thanks
Paromita

Posted 06-Sep-2013 by paromita
Rodrigo

Rodrigo

Thank you! It was very informative and helpfull

Posted 25-Sep-2013 by Rodrigo
Jason

Question on the blank host header site...

What URL should you use for the new blank host header web application. I'm getting a blank page when rendering a locally hosted app (iframe and full screen). I think it might have to do with the URL. I chose to use the machine name. I have a web application for the main site and mysites, using host headers.

Posted 25-Sep-2013 by Jason
Alan C

App URL using SSL?

Is it OK to create the App web on an SSL site? I have other SSL SharePoint sites on the server (and will be exposing these sites through TMG), so was thinking of creating a separate IIS site, bound to a separate IP address and separate wildcard certificate. SharePoint won't allow me to create a new web application on port 443 (as it will see that other sites exist on this port).

Posted 12-Oct-2013 by Alan C
i:0e.t|liveid|0006bffd80802e4d@live.com

SharePoint Store inaccessible when App Pool is anything other than farm account

Hi, I've done all of the steps involved, but was finding that during testing, I was getting the message 'Sorry, we can't seem to connect to the SharePoint Store. Try again in a bit'. I noticed that I could get to the SharePoint store from Central Admin, so I changed my test site application pool identity to the farm account and did an IISRESET /noforce. After that, I was able to access the SharePoint store, install an application and use it. Any ideas as to why I might be getting that? I've done temporary things like making the app pool account a local administrator and giving it sysadmin rights to the database server, but that still doesn't fix the problem. In looking through the event log, when the App Pool account is not the farm account, it sends an invalid URL to office.com.
But when it uses the farm account as the app pool identity, it looks like:

desigual pas cher

desigual pas cher

La plupart des femmes les magasins d'accessoire de desigual pas cher et les détaillants sont la commercialisation de nombreuses variantes et versions dans les sacs à main imprimés d'animaux qui sont un must dans la collection de chaque femme. Si vous souhaitez individu un vetement desigual femme. Donc, comme beaucoup d'entre nous savons que de nombreuses jeunes filles adorent se mettre en œuvre ou sportives chics sac a main desigual de concepteur fabricant crinière. vetement desigual femme symbolisent classe et de statut d'une personne. Desigual, ainsi que sac à main sac souvent, voyant que l'esprit sera certainement Néanmoins, dans le sac guess où vous êtes seulement un acheteur de base plutôt que d'effectuer appuyant simplement sur tous les termes de vos nouveaux accoutrements ce genre de conditionner probablement depuis acceptable puisque chaque ajoutés dans accoutrements réutilisables dans l'existence. Vous êtes capable de l'utiliser en permanence sur la liberté de l'internet a permis à la tumeur de nombreux commerçants illégaux, et les textiles. Desigual fera probablement la plus bénéfique d'investir Nos desigual paris faits à la main grand designer se plaît accessoires inimitables pour la mode conscient. Vetement desigual femme ne sont pas. Ils sont les hautes qualités de marques connues qui comprend vente privee desigual, la conception et le haut. Vous pourrez même obtenir des Manteaux desigual sur ces sites Web La sélection du meilleur vetement desigual femme n'est pas vraiment limité à ce qui semble fantastique, mais comment une femme se sent sur ce sujet si elle est détendue avec lui ou pas. Ils commercialisent des écharpes et Manteaux desigual en cuir vogue et mordant qui ne pourrait jamais tenir dans la conception de votre imagination. Laissez-nous sept jours par semaine à tourner pour chaque jour de retour vetement desigual femme. En raison de son style chic, Manteaux desigual assez haut de gamme et c'est pourquoi les hommes et les femmes véritablement pensent beaucoup avant de les acheter. Ils avaient besoin pour se préparer à beaucoup de sa vie quotidienne avec plus de vetement desigual femme. Vous trouverez d'excellents détails à ceux qui ne disposent pas des fonds réels les bourses élevées supérieures et chic pour ne pas mentionner sac. L'objectif de son Manteaux desigual est ce qui va déterminer le type de contenu utilisé. Vous pouvez obtenir votre manteau desigual préféré à faible coût Donc vous pouvez obtenir votre Desigual sac préféré à faible coût aujourd'hui et savourer le sentiment tout nouveau. http://www.ronardboxers.com/

Posted 13-Mar-2014 by desigual pas cher
vipcustomwriting

DD

Always be grateful suitable for publishing the complete basically excellent content…I very best something for instance this…I recognized the goods quiet mixing, split program attorney at law altlanta ga, you could keep publishing most of these blogs….

Posted 21-Mar-2014 by vipcustomwriting
ASDHK

DJKAS

Now i'm fill to cross this particular incredible website. Penetrate it regarding establishing this astounding spectacle! I will be propitious which usually it's going to indecent. The feeling presents highly rated as well as loved connotation recitals which sovereignty be solely tremendous currently. freetrialsytropin.com

Posted 22-Mar-2014 by ASDHK
yitoyitoytyo

yitoyitoytyo

Acero inoxidable y modelos Relojes Especiales bicolor son conducidos por el calibre Omega coaxial 8602. Equipado con una espiral Replica de relojes de silicio Si14, certificada oficialmente este cronógrafo movimiento COSC goza de una garantía completa de cuatro Rolex Submariner años (al igual que en otros lugares el 8612). El cristal de zafiro transparente.

Posted 17-Apr-2014 by yitoyitoytyo

Notify me of comments to this article

E-mail:
   

Add Comment

Title:

 
Comment:
Email:

   


Name:

 
Url: