Skip to content

Commit a291d1e

Browse files
Merge pull request #7033 from syncfusion-content/985454-UG
Updated the Blazor common UG documentation
2 parents 2e176e1 + 37c1975 commit a291d1e

26 files changed

+692
-698
lines changed

blazor/installation/common-installation-errors.md

Lines changed: 40 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
layout: post
3-
title: Installation Errors in Blazor - Syncfusion
4-
description: Learn here about the common installation errors and solution to those errors in Syncfusion Blazor Components installation.
3+
title: Common installation errors in Blazor | Syncfusion
4+
description: Understand common Syncfusion Blazor installer errors, their causes, and solutions including unlock key issues, license expiration, concurrent installers.
55
platform: Blazor
6-
component: Common
6+
control: Common
77
documentation: ug
88
---
99

10-
# Common Installation Errors
10+
# Common installation errors
1111

1212
This article describes the most common installation errors, as well as the causes and solutions to those errors.
1313

@@ -21,89 +21,90 @@ This article describes the most common installation errors, as well as the cause
2121

2222
**Error Message:** Sorry, the provided unlock key is a trial unlock key and cannot be used to unlock the licensed version of our Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor installer.
2323

24-
![Installation Unlock Error](images/installation-error-1.png)
24+
![Unlock key error when using a trial key with the licensed installer](images/installation-error-1.png)
2525

26-
**Reason** <br /> You are attempting to use a Trial unlock key to unlock the licensed installer.
26+
**Reason:** <br/> A trial unlock key is being used with the licensed installer.
2727

28-
**Suggested solution** <br /> Only a licensed unlock key can unlock a licensed installer. So, to unlock the Licensed installer, use the Licensed unlock key. To generate the licensed unlock key, refer to [this](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account) article.
28+
**Suggested solution:** Only a licensed unlock key can unlock a licensed installer. So, to unlock the Licensed installer, use the Licensed unlock key. To generate the licensed unlock key, refer to [this](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account) article.
2929

3030
## License has expired
3131

3232
**Error Message:** Your license for Syncfusion<sup style="font-size:70%">&reg;</sup> Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor has been expired since {date}. Renew your subscription and try again.
3333

34-
***Online Installer***
34+
***Online installer***
3535

36-
![Installation License Expired Error](images/installation-error-2.png)
36+
![License expired message in the web installer](images/installation-error-2.png)
3737

38-
**Reason** <br /> This error message will appear if your license has expired.
38+
**Reason:** This error message will appear if your license has expired.
3939

40-
**Suggested solution** <br /> You can choose from the options listed below.
40+
**Suggested solution:** Choose one of the following options.
4141

42-
1. You can renew your subscription [here](https://www.syncfusion.com/account/my-renewals).
43-
2. You can get a new license [here](https://www.syncfusion.com/sales/products).
44-
3. You can reach out to our sales team by emailing [[email protected]](mailto:[email protected]).
45-
4. You can also extend the 30-day trial period after your trial license has expired.
42+
1. Renew the subscription [here](https://www.syncfusion.com/account/my-renewals)
43+
2. Purchase a new license [here](https://www.syncfusion.com/sales/products)
44+
3. Contact sales: [email protected]
45+
4. If applicable, extend the 30day trial period.
4646

4747
## Unable to find a valid license or trial
4848

4949
**Error Message:** Sorry, we are unable to find a valid license or trial for Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor under your account.
5050

5151
***Offline installer***
5252

53-
![Installation Offline Installer Error](images/installation-error-3.png)
53+
![Account has no valid license or trial in the offline installer](images/installation-error-3.png)
5454

5555
***Online installer***
5656

57-
![Installation Online Installer Error](images/installation-error-4.png)
57+
![Account has no valid license or trial in the web installer](images/installation-error-4.png)
5858

59-
**Reason** <br /> The following are possible causes of this error:
59+
**Reason:** One of the following is true:
6060

61-
* When your trial period expired
62-
* When you don’t have a license or an active trial
63-
* You are not the license holder of your license
64-
* Your account administrator has not yet assigned you a license.
61+
* The 30‑day trial has expired
62+
* The account has no license or active trial
63+
* The user is not the license holder for the product
64+
* The account administrator has not assigned a license to the user
6565

66-
**Suggested solution** <br />
67-
1. You can get a new license [here](https://www.syncfusion.com/sales/products).
68-
2. Contact your account administrator.
69-
3. Send an email to [[email protected]](mailto:[email protected]) to request a license.
70-
4. You can reach out to our sales team by emailing [[email protected]](mailto:[email protected]).
66+
**Suggested solution:**
67+
1. Purchase a license: https://www.syncfusion.com/sales/products
68+
2. Ask the account administrator to assign a license in Syncfusion account portal
69+
3. Request assistance: [email protected]
70+
4. Contact sales: [email protected]
7171

7272
## Unable to install because of another installation
7373

7474
**Error Message:** Another installation is in progress. You cannot start this installation without completing all other currently active installations. Click cancel to end this installer or retry to attempt after currently active installation completed to install again.
7575

76-
![Installation Error Another MSI Running](images/installation-error-5.png)
76+
![Another installation in progress error dialog](images/installation-error-5.png)
77+
78+
**Reason:** You are trying to install when another installation is already running in your machine.
7779

78-
**Reason** <br /> You are trying to install when another installation is already running in your machine.
80+
**Suggested solution:** Open and kill the msiexec process in the task manager and then continue to install Syncfusion. If the problem is still present, restart the computer and try Syncfusion<sup style="font-size:70%">&reg;</sup> installer.
7981

80-
**Suggested solution** <br /> Open and kill the msiexec process in the task manager and then continue to install Syncfusion. If the problem is still present, restart the computer and try Syncfusion<sup style="font-size:70%">&reg;</sup> installer.
81-
1. Open the Windows Task Manager.
82+
1. Open Windows Task Manager.
8283
2. Browse the Details tab.
8384
3. Select the msiexec.exe and click **End task**.
8485

85-
![Installation Error MSIEXEC Kill](images/installation-error-6.png)
86+
![Windows Task Manager showing msiexec.exe to end task](images/installation-error-6.png)
8687

8788
## Unable to install due to controlled folder access
8889

8990
***Offline***
9091

91-
**Error Message:** Controlled folder access seems to be enabled in your machine. The provided install or samples location (e.g., Public Documents) is protected by the controlled folder access settings.
92+
**Error Message:** Controlled folder access seems to be enabled on this machine. The provided install or samples location (for example, Public Documents) is protected by controlled folder access settings.
9293

93-
![Installation Offline Installer Error Controlled Folder Access](images/installation-error-7.png)
94+
![Offline installer controlled folder access warning](images/installation-error-7.png)
9495

9596
***Online***
9697

97-
**Error Message:** Controlled folder access seems to be enabled in your machine. The provided install, samples, or download location (e.g., Public Documents) is protected by the controlled folder access settings.
98+
**Error Message:** Controlled folder access seems to be enabled on this machine. The provided install, samples, or download location (for example, Public Documents) is protected by controlled folder access settings.
9899

99-
![Installation Online Installer Error Controlled Folder Access](images/installation-error-8.png)
100+
![Web installer controlled folder access warning](images/installation-error-8.png)
100101

101-
**Reason** <br /> You have enabled controlled folder access settings on your computer.
102+
**Reason:** You have enabled controlled folder access settings on your computer.
102103

103-
***Suggested solution***
104+
**Suggested solution:**
104105

105106
**Suggestion 1:**
106-
* We will ship our demos in the public documents folder by default.
107+
* Syncfusion demos are installed to the Public Documents folder by default.
107108
* You have controlled folder access enabled on your machine, so our demos cannot be installed in the documents folder. If you need to install our demos in the Documents folder, follow the steps in this [link](https://support.microsoft.com/en-us/windows/allow-an-app-to-access-controlled-folders-b5b6627a-b008-2ca2-7931-7e51e912b034) and disable the controlled folder access.
108109
* You can enable this option after the installing our Syncfusion<sup style="font-size:70%">&reg;</sup> setup.
109110

blazor/installation/install-nuget-packages.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
layout: post
3-
title: Install Syncfusion Blazor NuGet packages - Syncfusion
4-
description: Learn here about the how to install Syncfusion Blazor NuGet packages from Package manager and NuGet manager.
3+
title: Install Syncfusion Blazor NuGet packages | Syncfusion
4+
description: Learn here about how to install Syncfusion Blazor NuGet packages using the Package Manager UI, .NET CLI, and Package Manager Console. Explore to more details.
55
platform: Blazor
6-
component: Common
6+
control: Common
77
documentation: ug
88
---
99

10-
# Install Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages
10+
# Install Syncfusion® Blazor NuGet packages
1111

1212
## Overview
1313

@@ -22,27 +22,27 @@ The NuGet **Package Manager UI** allows you to search, install, uninstall, and u
2222

2323
1. Right-click on the Blazor application or solution in the Solution Explorer, and choose **Manage NuGet Packages...**
2424

25-
![Manage NuGet Packages add-in](images/ManageNuGet.png)
25+
![Open Manage NuGet Packages from Solution Explorer](images/ManageNuGet.png)
2626

2727
As an alternative, after opening the Blazor application in Visual Studio, go to the **Tools** menu and after hovering **NuGet Package Manager**, select **Manage NuGet Packages for Solution...**
2828

2929
2. The Manage NuGet Packages window will open. Navigate to the **Browse** tab, then search for the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages using a term like **"Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor"** and select the appropriate Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package for your development.
3030

31-
N> The [nuget.org](https://api.nuget.org/v3/index.json) package source is selected by default in the Package source drop-down. If your Visual Studio does not have nuget.org configured, follow the instructions in the [Microsoft documents](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#package-sources) to set up the nuget.org feed URL.
31+
N> The [nuget.org](https://api.nuget.org/v3/index.json) package source is selected by default. If Visual Studio does not have nuget.org configured, follow the instructions in the [Microsoft documents](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#package-sources) to set up the nuget.org feed URL.
3232

33-
![Blazor NuGet Packages Search](images/NuGetsearch.png)
33+
![Search for Syncfusion Blazor packages in the Browse tab](images/NuGetsearch.png)
3434

3535
3. When you select a Blazor package, the right side panel will provide more information about it.
3636

3737
4. By default, the package is selected with the latest version. You can choose the required version and click the **Install** button and accept the license terms. The package will be added to your Blazor application.
3838

39-
![Blazor NuGet Packages Install](images/InstallNuGet.png)
39+
![Install a Syncfusion Blazor package from the Package Manager UI](images/InstallNuGet.png)
4040

4141
5. At this point, your application has all the required Syncfusion<sup style="font-size:70%">&reg;</sup> assemblies, and you will be ready to start building high-performance, responsive app with [Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components](https://www.syncfusion.com/blazor-components). Also, you can refer to the [Blazor help document](https://blazor.syncfusion.com/documentation/introduction) for development.
4242

4343
## Installation using Dotnet (.NET) CLI
4444

45-
The [dotnet Command Line Interface (CLI)](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli), allows you to add, restore, pack, publish, and manage packages without making any changes to your application files. [Dotnet add package](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-add-package?tabs=netcore2x) adds a package reference to the application file, then runs [dotnet restore](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-restore?tabs=netcore2x) to install the package.
45+
The [dotnet Command Line Interface (CLI)]((https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli)) lets you add, restore, pack, publish, and manage packages without making any changes to your application files. [Dotnet add package](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-add-package?tabs=netcore2x) adds a package reference to the application file, then runs [dotnet restore](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-restore?tabs=netcore2x) to install the package.
4646

4747
Follow the below instructions to use the dotnet CLI command to install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages.
4848

@@ -72,7 +72,7 @@ The **Package Manager Console** saves NuGet packages installation time since you
7272

7373
1. To show the Package Manager Console, open your Blazor application in Visual Studio and navigate to **Tools -> NuGet Package Manager -> Package Manager Console**.
7474

75-
![Package Manager Console ](images/console.png)
75+
![Package Manager Console in Visual Studio](images/console.png)
7676

7777
2. The **Package Manager Console** will be shown at the bottom of the screen. You can install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages by entering the following NuGet installation commands.
7878

@@ -84,21 +84,21 @@ The **Package Manager Console** saves NuGet packages installation time since you
8484

8585
**For example:** Install-Package Syncfusion.Blazor.Grid
8686

87-
N> You can find the list of Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages which are published in nuget.org from [here](https://www.nuget.org/packages?q=Tags%3A%22Blazor%22+syncfusion)
87+
N> Browse Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages on [NuGet.org](https://www.nuget.org/packages?q=Tags%3A%22Blazor%22+syncfusion).
8888

8989
***Install specified Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package in specified Blazor application***
9090

9191
The following command will install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package in the given Blazor application.
9292

93-
```Install-Package <Package Name> - ProjectName <Project Name>```
93+
```Install-Package <Package Name> -ProjectName <Project Name>```
9494

9595
**For example:** Install-Package Syncfusion.Blazor.Grid -ProjectName SyncfusionBlazorApp
9696

9797
3. By default, the package will be installed with latest version. You can give the required version with the -Version term like below to install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages in the appropriate version.
9898

9999
```Install-Package Syncfusion.Blazor.Grid -Version 19.2.0.44```
100100

101-
![Package Manager Console Output ](images/ConsoleInstallationOutput.png)
101+
![Package Manager Console output showing installed package](images/ConsoleInstallationOutput.png)
102102

103103
4. The NuGet package manager console will install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package as well as the dependencies it has. When the installation is complete, the console will show that your Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor package has been successfully added to the application.
104104

0 commit comments

Comments
 (0)