|
| 1 | +--- |
| 2 | +title: "Provision a portal using the older portal add-on | MicrosoftDocs" |
| 3 | +description: "Instructions to provision a portal using the older portal add-on." |
| 4 | +author: sbmjais |
| 5 | +manager: shujoshi |
| 6 | +ms.service: powerapps |
| 7 | +ms.topic: conceptual |
| 8 | +ms.custom: |
| 9 | +ms.date: 11/04/2019 |
| 10 | +ms.author: shjais |
| 11 | +ms.reviewer: |
| 12 | +--- |
| 13 | + |
| 14 | +# Provision a portal using the older portal add-on |
| 15 | + |
| 16 | +If you have purchased an older portal add-on, and want to provision a portal using the add-on, you must go to the **Dynamics 365 Administration Center** page and provision the portal. |
| 17 | + |
| 18 | +> [!NOTE] |
| 19 | +> To provision a portal, you must be assigned either System Administrator or System Customizer role of the Common Data Service environment selected for the portal. You must also have the [required permissions](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal#required-permissions) to create and register an application in Azure AD. If you don't have the required permissions, contact the Global Administrator to update your permissions or ask the Global Administrator to provision the portal. |
| 20 | +
|
| 21 | +To provision a portal: |
| 22 | + |
| 23 | +1. Go to the **Dynamics 365 Administration Center** page, and then select the **Applications** tab. |
| 24 | + |
| 25 | +2. Select the application row titled **Portal Add-On**, and then select **Manage.** |
| 26 | + |
| 27 | +3. In the **General Settings** section, enter a **Name** for your portal. The **Name** will help to identify the portal and can be changed later. |
| 28 | + |
| 29 | +4. The **Type** field represents the type of portal subscription (Trial or Production). This is a system field, so it cannot be changed by the user. The value changes based on whether it is trial subscription or paid subscription. |
| 30 | + |
| 31 | +5. Optionally, in the **Portal development status** drop-down list, select one of the following development statuses for your portal: |
| 32 | + |
| 33 | + - Prototype |
| 34 | + - Development |
| 35 | + - Test |
| 36 | + - UAT |
| 37 | + - Live |
| 38 | + |
| 39 | + > [!NOTE] |
| 40 | + > - For existing provisioned portals, this drop-down list is available on the **Portal Details** tab and no status is selected by default. |
| 41 | + > - This drop-down list is available only for the portals of type production. |
| 42 | + > - This field is used by Microsoft to understand the usage pattern of this portal and does not affect any functionality. If you use different names for development lifecycle, please select the one which is closer in purpose. This can be changed at a later point of time once portal is provisioned. |
| 43 | +
|
| 44 | +5. In the **Portal URL** field, enter the subdomain name you want for your portal. You can only use alphanumeric characters or hyphens (-); other characters are not permitted. |
| 45 | + |
| 46 | + > [!NOTE] |
| 47 | + > - To change the URL of a portal after it is provisioned, see [change the base URL of a portal](admin/change-base-url.md). |
| 48 | + > - To link your portal to a custom domain, see [link your portal to a custom domain](admin/add-custom-domain.md). |
| 49 | +
|
| 50 | +6. In the **Dynamics 365 Instance** drop-down list, select the instance you want to link the portal to. This requires System Administrator or System Customizer role in the instance you pick to select it. |
| 51 | + |
| 52 | +7. In the **Select Portal Language** drop-down list, select the default language for your portal. The available languages will depend on the languages that are installed in your instance. |
| 53 | + |
| 54 | + > [!NOTE] |
| 55 | + > Sample data is only provided in one language, so choosing a default language will also decide how the sample data is translated. Arabic and Hebrew are not supported and will not appear in the list. |
| 56 | +
|
| 57 | +8. In the **Select Portal Administrator** drop-down list, select the user who will configure, customize, and maintain the portal. All users who have the System Administrator role in the organization will appear as options. |
| 58 | + |
| 59 | +9. In the **Portal Audience** section, choose the type of audience who will visit the new portal. This will determine what options of portals you will be given. You can choose: |
| 60 | + |
| 61 | + - Partner |
| 62 | + - Customer Self Service Portal |
| 63 | + - Custom Portal |
| 64 | + - Partner Portal |
| 65 | + - Partner Project Service (Optional, requires solutions installed) |
| 66 | + - Partner Field Service (Optional, requires solutions installed) |
| 67 | + - Community Portal |
| 68 | + |
| 69 | + - Customer |
| 70 | + - Customer Self Service Portal |
| 71 | + - Custom Portal |
| 72 | + - Community Portal |
| 73 | + |
| 74 | + - Employee |
| 75 | + - Employee Self Service Portal |
| 76 | + |
| 77 | +10. In the **Select portal to be deployed** section, choose what type of portal you want to create. The options you see are based on the audience you selected. |
| 78 | + |
| 79 | + > [!div class="mx-imgBorder"] |
| 80 | + >  |
| 81 | +
|
| 82 | +11. Select **Submit**, and accept the Terms of Service. |
| 83 | + > [!div class="mx-imgBorder"] |
| 84 | + >  |
| 85 | +
|
| 86 | +After you accept the Terms of Service, the portal will begin provisioning. Provisioning usually takes 30 minutes but can take a few hours depending on the system load. The *Name* of the portal on the Application tab will change to *Name*-Configuring while it is provisioning. Navigate back to the portal management page to check whether provisioning has succeeded. |
| 87 | + |
| 88 | +After the portal is provisioned, the **Portal Details** page is displayed with the required details. |
| 89 | + |
| 90 | +> [!div class="mx-imgBorder"] |
| 91 | +>  |
| 92 | +
|
| 93 | + |
| 94 | +> [!Note] |
| 95 | +> When a portal user signs in to the portal for the first time by using an Azure AD credential, a consent page is displayed to all users irrespective of the user or portal type. |
| 96 | +
|
| 97 | +The table below summarizes the features associated with each portal option: |
| 98 | + |
| 99 | +| Feature | Customer Self-Service Portal | Partner Portal | Employee Self-Service Portal | Community Portal | Custom Portal | |
| 100 | +|----------------------------------------|------------------------------|----------------|------------------------------|------------------|---------------| |
| 101 | +| World Ready | • | • | • | • | • | |
| 102 | +| Multi-Language Support | • | • | • | • | • | |
| 103 | +| Portal Administration | • | • | • | • | • | |
| 104 | +| Customization and Extensibility | • | • | • | • | • | |
| 105 | +| Theming | • | • | • | • | • | |
| 106 | +| Content Management | • | | • | • | | |
| 107 | +| Knowledge Management | • | • | • | • | | |
| 108 | +| Support/Case Management | • | | • | • | | |
| 109 | +| Forums | • | | • | • | | |
| 110 | +| Faceted Search | • | | • | | | |
| 111 | +| Profile Management | • | | • | | | |
| 112 | +| Subscribe to Forum Thread | • | | • | | | |
| 113 | +| Comments | • | | • | • | | |
| 114 | +| [!INCLUDE[pn-azure-shortest](../includes/pn-azure-shortest.md)] AD Authentication | | | • | | | |
| 115 | +| Ideas | | | | • | | |
| 116 | +| Blogs | | | | • | | |
| 117 | +| Project Service Automation Integration | | • | | | | |
| 118 | +| Field Service Integration | | • | | | | |
| 119 | +| Partner Onboarding | | • | | | | |
| 120 | +| Portal Base | • | • | • | • | • | |
| 121 | +| Portal Workflows | • | • | • | • | • | |
| 122 | +| Web Notifications | • | • | • | • | • | |
| 123 | +| [!INCLUDE[cc-microsoft](../includes/cc-microsoft.md)] Identity | • | • | • | • | • | |
| 124 | +| Identity Workflows | • | • | • | • | • | |
| 125 | +| Web Forms | • | • | • | • | • | |
| 126 | +| Feedback | • | • | • | • | • | |
| 127 | +|| |
| 128 | + |
| 129 | +## Troubleshoot provisioning |
| 130 | + |
| 131 | +Sometimes the package installation process or URL creation process can error out. In these cases, the processes can be restarted. |
| 132 | + |
| 133 | +If *Name*-Configuring changes to *Name*-Provisioning Failed, you need to restart the provisioning process. |
| 134 | + |
| 135 | +1. Go to the **Applications** page, and select the portal. |
| 136 | +2. Select the blue pencil button labeled **Manage**. |
| 137 | +3. Choose one of the following options: |
| 138 | + |
| 139 | + - **Restart Provisioning**: Restarts the installation process with the configuration that was previously defined. |
| 140 | + |
| 141 | + - **Change Values and Restart Provisioning**: Lets you change some of the values before restarting the provisioning process. |
| 142 | + |
| 143 | +If the package installation has failed, the portal administrator page will open without any issues, but navigating to the actual portal URL will show a message Getting set up. To confirm this: |
| 144 | + |
| 145 | +1. Go to the Solution Management page of the **Dynamics 365 Administration Center** page and check that the package status is **Install Failed**. |
| 146 | + |
| 147 | +2. If the package status is **Install Failed**, try retrying the installation from the solution page. Also, be sure to check that a system administrator is installing the solution with the default language in Common Data Service set to the language the portal should be installed in. |
| 148 | + |
| 149 | +> [!NOTE] |
| 150 | +> Some solutions have prerequisites for their installation, so an installation will fail if the prerequisites are not met. For example, to install the Partner Field Service for a partner portal, the Partner Portal and Field Service solutions must have already been installed. If you attempt to install the Partner Field Service first, the installation will fail and give you an error message. |
0 commit comments