Skip to content

Commit 7292cf1

Browse files
committed
Deployment and General Information articles fixes
1 parent 96bc620 commit 7292cf1

File tree

43 files changed

+1982
-2262
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+1982
-2262
lines changed

deployment/deploying-a-telerik-enabled-webapplication.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,11 @@ Deploying an application that uses the Telerik UI for ASP.NET AJAX controls is d
1818

1919
To ensure a successful deployment, you need to check the following items:
2020

21-
* For the controls to be recognized by the server, the application must properly reference the Telerik.Web.UI.dll assembly.The [Included Assemblies]({%slug introduction/installation/included-assemblies%}) help article explains where you can find thefile(s) that you need.
21+
* For the controls to be recognized by the server, the application must properly reference the Telerik.Web.UI.dll assembly.The [Included Assemblies]({%slug introduction/installation/included-assemblies%}) help article explains where you can find the file(s) that you need.
2222

23-
* Make sure that the needed assemblies are copied over to the production server. This often involves setting the *CopyLocal*property of the WebApplication reference to *true*. In case you are deploying the assemblies in the GAC, examine the[Working with Assemblies in the GAC](http://blogs.telerik.com/aspnet-ajax/posts/13-09-19/working-with-assemblies-in-the-global-assembly-cache)blog post.
23+
* Make sure that the needed assemblies are copied over to the production server. This often involves setting the *CopyLocal* property of the WebApplication reference to *true*. In case you are deploying the assemblies in the GAC, examine the [Working with Assemblies in the GAC](http://blogs.telerik.com/aspnet-ajax/posts/13-09-19/working-with-assemblies-in-the-global-assembly-cache) blog post.
2424

2525
* Make sure that the needed additions are made to the web.config on the production server. The[web.config Settings Overview]({%slug general-information/web-config-settings-overview%}) article lists them.
2626

27-
* Make sure that the MS AJAX extensions are installed on the production server. You can find more information about them at[http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx](http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx).
27+
* Make sure that the MS AJAX extensions are installed on the production server. You can find more information about them at [http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx](http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx).
28+

deployment/deploying-on-shared-hosting.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,19 +30,19 @@ All Telerik controls are server controls and have to be installed on the web ser
3030

3131
1. Remember the application name and click OK.
3232

33-
1. Give full permissions to the __ASPNET__ user (if you are using IIS5) or to the __Network Service__ account (using IIS6 or IIS7, Windows Server 2003, Windows Vista/Longhorn) on the application folder. Again, before doing this step, consult with your hosting provider on how this is to be accomplished. If the provider offers thorough instructions, use them instead of the ones below. Otherwise, contact your provider to set the permissions for you.
33+
1. Give full permissions to the **ASPNET** user (if you are using IIS5) or to the **Network Service** account (using IIS6 or IIS7, Windows Server 2003, Windows Vista/Longhorn) on the application folder. Again, before doing this step, consult with your hosting provider on how this is to be accomplished. If the provider offers thorough instructions, use them instead of the ones below. Otherwise, contact your provider to set the permissions for you.
3434

3535
1. Run the project.
3636

3737
## If you plan to deploy the controls directly on the shared hosting
3838

39-
1. Log into your [Telerik account](http://www.telerik.com/account/default.aspx) and click on __Manage products__ from the top menu.
39+
1. Log into your [Telerik account](http://www.telerik.com/account/default.aspx) and click on **Manage products** from the top menu.
4040

41-
1. In the dropdown that appears choose from your purchased products or trial downloads the Telerik UI for ASP.NET AJAX, and click on it. If you have purchased a collection you would need to click on it and the trial downloads page will show all trial downlads directly.
41+
1. In the dropdown that appears choose from your purchased products or trial downloads the Telerik UI for ASP.NET AJAX, and click on it. If you have purchased a collection you would need to click on it and the trial downloads page will show all trial downloads directly.
4242

43-
1. Click on __Download Installer and other resources__ (the Download link next to the suite if you are a trial user). You need to choose the Telerik UI for ASP.NET AJAX suite if you have purchased the collection and click its Browse all product files button.
43+
1. Click on **Download Installer and other resources** (the Download link next to the suite if you are a trial user). You need to choose the Telerik UI for ASP.NET AJAX suite if you have purchased the collection and click its Browse all product files button.
4444

45-
1. Download the __Manual installation__ (__ZIP__) file.
45+
1. Download the **Manual installation** (**ZIP**) file.
4646

4747
1. On the server, create a "Telerik" folder in your "inetpub/wwwroot" folder on the server.
4848

deployment/deploying-to-azure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Deploying a project that uses the Telerik UI for ASP.NET AJAX to Windows Azure i
2424

2525
## Common Issues
2626

27-
__WebResource requests are not returned, which results in missing CSS files and/or scripts.__
27+
**WebResource requests are not returned, which results in missing CSS files and/or scripts.**
2828

2929
This can often seem like an intermittent problem - i.e. after some deployment attempts the Telerik controls will work, after some - they will not.
3030

deployment/protecting-the-telerik-asp.net-ajax-assembly.md

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -14,60 +14,60 @@ position: 4
1414

1515
##
1616

17-
__Technical guidelines for protecting Telerik UI for ASP.NET AJAX binaries when redistributed with other applications__
17+
**Technical guidelines for protecting Telerik UI for ASP.NET AJAX binaries when redistributed with other applications**
1818

1919

2020

2121

2222

2323
We are providing the following suggestions to protect our IP (Intellectual Property) when redistribute our assemblies as a part of shrink-wrapped software (packaged products).
2424

25-
__Prerequisites__
25+
**Prerequisites**
2626

27-
Protecting *Telerik UI for ASP.NET Ajax* requires the *Telerik.Web.UI* assembliy to be built from source code (due to modifications applied to the source files). The source code of Telerik UI for ASP.NET AJAX is distributed separately and is bundled with build instructions. Please read the source code building instructions beforehand.
27+
Protecting *Telerik UI for ASP.NET Ajax* requires the *Telerik.Web.UI* assembly to be built from source code (due to modifications applied to the source files). The source code of Telerik UI for ASP.NET AJAX is distributed separately and is bundled with build instructions. Please read the source code building instructions beforehand.
2828

2929
For brevity this document assumes that the source distribution ZIP file is extracted in C:\TelerikControlsAjaxSource.
3030

3131

3232

33-
__Instructions__
33+
**Instructions**
3434

35-
1. Open C:\TelerikControlsAjaxSource\Telerik.Web.UI\Common\AssemblyProtection.cs in a text editor (notepad, Visual Studio etc)
35+
1. Open *C:\TelerikControlsAjaxSource\Telerik.Web.UI\Common\AssemblyProtection.cs* in a text editor (notepad, Visual Studio etc)
3636

3737
1. Uncomment the following line:
3838

3939
````C#
40-
public static void Validate()
41-
{
42-
//Uncomment the following line
43-
//ValidatePassPhrase();
44-
}
40+
public static void Validate()
41+
{
42+
//Uncomment the following line
43+
//ValidatePassPhrase();
44+
}
4545
````
4646

4747

4848

4949
````C#
50-
public static void Validate()
51-
{
52-
//Uncomment the following line
53-
ValidatePassPhrase();
54-
}
50+
public static void Validate()
51+
{
52+
//Uncomment the following line
53+
ValidatePassPhrase();
54+
}
5555
````
5656

5757

5858

59-
1. Change the value of the *__ApplicationName__* constant to match the name of your application:
59+
1. Change the value of the ***ApplicationName*** constant to match the name of your application:
6060

6161
````C#
62-
//Modify to match your application name
63-
private const string ApplicationName = "MyApp";
62+
//Modify to match your application name
63+
private const string ApplicationName = "MyApp";
6464
````
6565

6666

6767

6868
````C#
69-
//Modify to match your application name
70-
private const string ApplicationName = "Sample Application Name v2.0 (tm)";
69+
//Modify to match your application name
70+
private const string ApplicationName = "Sample Application Name v2.0 (tm)";
7171
````
7272

7373

@@ -77,14 +77,12 @@ __Instructions__
7777
1. In your application replace the existing reference to Telerik.Web.UI.dll with the one built from source code.
7878

7979
1. If you run your application now you should see the following error message (“Sample Application Name v2.0 (tm)” will be replaced with the name of your application set in step 3):
80-
>caption
81-
8280
![](images/introduction-applicationisnotlicensed.jpg)
8381

84-
1. Add the following code in the Page_Load method of your page codebehind class.
82+
1. Add the following code in the Page_Load method of your page code-behind class.
8583

8684
````C#
87-
Application["Telerik.Web.UI.Key"] = "Sample Application Name v2.0 (tm)";
85+
Application["Telerik.Web.UI.Key"] = "Sample Application Name v2.0 (tm)";
8886
````
8987

9088

deployment/using-the-global-assembly-cache.md

Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ position: 1
1212

1313

1414

15-
This article explains the basics on using the[Global Assembly Cache (GAC)](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)with the Telerik Controls.
15+
This article explains the basics on using the [Global Assembly Cache (GAC)](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)with the Telerik Controls.
1616

1717
While this article can be used as a tutorial on working with the GAC and referencing assemblies in your project, the best source of information is the official MSDN site:
1818

@@ -30,7 +30,7 @@ While this article can be used as a tutorial on working with the GAC and referen
3030

3131
The [Telerik UI for ASP.NET AJAX assemblies]({%slug introduction/installation/included-assemblies%}) are standard .NET assemblies, so all generic rules apply to them as well.
3232

33-
What we advise is that you __keep the Telerik.Web.Design.dll assembly in the GAC on your development machine (it is not needed in production)__(our installation wizard will put it there) in order to have access to the design-time mode of the controls, and __reference the other assemblies (Telerik.Web.UI.dll and Telerik.Web.UI.Skins.dll) from the BIN folder__.
33+
What we advise is that you **keep the Telerik.Web.Design.dll assembly in the GAC on your development machine (it is not needed in production)**(our installation wizard will put it there) in order to have access to the design-time mode of the controls, and **reference the other assemblies (Telerik.Web.UI.dll and Telerik.Web.UI.Skins.dll) from the BIN folder**.
3434

3535
This article contains the following sections:
3636

@@ -70,9 +70,9 @@ GAC is the short version of "Global Assembly Cache". It is a common place in the
7070

7171
## Where is the GAC
7272

73-
Up __until .NET 3.5__ the GAC is located in__C:\Windows\Assembly\__
73+
Up **until .NET 3.5** the GAC is located in **C:\Windows\Assembly\**
7474

75-
__Since .NET 4.0__ it is in __C:\Windows\Microsoft.Net\Assembly\GAC_MSIL\__and also the shell integration was removed, so you can no longer drag-and-drop an assembly in the folder and have it registered.
75+
**Since .NET 4.0** it is in **C:\Windows\Microsoft.Net\Assembly\GAC_MSIL\** and also the shell integration was removed, so you can no longer drag-and-drop an assembly in the folder and have it registered.
7676

7777
## Pros and Cons
7878

@@ -100,7 +100,7 @@ And one that can go in either category:
100100

101101
## Add, Remove and View Assemblies in the GAC
102102

103-
First, you are going to need a tool from the .NET SDK that comes with Visual Studio – [gacutil.exe](http://msdn.microsoft.com/en-us/library/ex0ss12c%28v=VS.100%29.aspx). To run it go to-> All Programs -> Visual Studio <version> -> Visual Studio Tools -> run the [Visual Studio Command Prompt](http://msdn.microsoft.com/en-us/library/ms229859.aspx) (or Developer Command prompt, depending on the VS version you use.
103+
First, you are going to need a tool from the .NET SDK that comes with Visual Studio – [gacutil.exe](http://msdn.microsoft.com/en-us/library/ex0ss12c%28v=VS.100%29.aspx). To run it go to -> All Programs -> Visual Studio <version> -> Visual Studio Tools -> run the [Visual Studio Command Prompt](http://msdn.microsoft.com/en-us/library/ms229859.aspx) (or Developer Command prompt, depending on the VS version you use.
104104

105105
### View the Assemblies in the GAC
106106

@@ -138,7 +138,7 @@ Here is an example that removes the Q3 2014 Telerik.Web.UI.dll assembly to the G
138138

139139
`gacutil /u Telerik.Web.UI, Version=2014.3.1209.45, Culture=neutral, PublicKeyToken=121fae165ba3d4`
140140

141-
You can read more on the subject in the[How to Uninstall an Assembly from the GAC](http://msdn.microsoft.com/en-us/library/aa559881.aspx) MSDN article.
141+
You can read more on the subject in the [How to Uninstall an Assembly from the GAC](http://msdn.microsoft.com/en-us/library/aa559881.aspx) MSDN article.
142142

143143
>tip If an assembly has been added to the GAC by an automated installer, to remove it from the GAC, you must first uninstall the program that added it. The Telerik UI for ASP.NET AJAX installer adds the Telerik.Web.UI.Design.dll assembly to the GAC.
144144
>
@@ -150,27 +150,27 @@ You can read more on the subject in the[How to Uninstall an Assembly from the GA
150150

151151
### In a WebSite Type of Project
152152

153-
In a __Web Site type of project__, the __Property Pages__ dialog can show you whether the references are from the GAC:
153+
In a **Web Site type of project**, the **Property Pages** dialog can show you whether the references are from the GAC:
154154
>caption Figure 1: GAC references to Telerik assemblies in a WebSite project
155155
156156
![website gac reference](images/website_gac_reference.png)
157157

158-
You can also see the references in the __web.config__. They will have fully qualified assembly names. For example:
158+
You can also see the references in the **web.config**. They will have fully qualified assembly names. For example:
159159

160160
````XML
161-
<compilation debug="true" targetframework="4.0">
162-
<assemblies>
163-
<add assembly="Telerik.Web.UI, Version=2012.3.1016.40, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />
164-
<add assembly="Telerik.Web.UI.Skins, Version=2012.3.1016.40, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />
165-
</assemblies>
166-
</compilation>
161+
<compilation debug="true" targetframework="4.0">
162+
<assemblies>
163+
<add assembly="Telerik.Web.UI, Version=2012.3.1016.40, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />
164+
<add assembly="Telerik.Web.UI.Skins, Version=2012.3.1016.40, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />
165+
</assemblies>
166+
</compilation>
167167
````
168168

169169

170170

171171
### In a WebApplication Type of Project
172172

173-
In a __WebApplication type of project__, you have to examinethe __reference Properties__ under the __References__node in the __Project__ tree. You will see how it is not a local copy of the assembly and that the path points to the GAC:
173+
In a **WebApplication type of project**, you have to examine the **reference Properties** under the **References** node in the **Project** tree. You will see how it is not a local copy of the assembly and that the path points to the GAC:
174174
>caption Figure 2: GAC references to Telerik assemblies in a WebApplication project
175175
176176
![webapplication gac reference](images/webapplication_gac_reference.png)
@@ -181,49 +181,43 @@ In a __WebApplication type of project__, you have to examinethe __reference Prop
181181

182182
An alternative to the GUI approach below, you can simply add a few lines to theweb.config, as shown in the [How GAC References Look](#how-gac-references-look) section.
183183

184-
1. Open the __Property Pages__ dialog, go to the__References__ tab and click __Add__:
184+
1. Open the **Property Pages** dialog, go to the **References** tab and click **Add**:
185185
>caption Figure 3: Open the Property Pages and add a reference.
186-
187186
![add-gac-reference-website-1 site property pages](images/add-gac-reference-website-1_site_property_pages.png)
188187

189188
1. Browse to the GAC to select assembly:
190189
>caption Figure 4: Browse to the GAC and select an assembly to reference.
191-
192190
![add-gac-reference-website-2 browse to gac](images/add-gac-reference-website-2_browse_to_gac.png)
193191

194192
1. Confirm the reference properties when you make sure they are correct:
195193
>caption Figure 5: Examine the references and close the Property Pages dialog.
196-
197194
![add-gac-reference-website-3 site confirm properties](images/add-gac-reference-website-3_site_confirm_properties.png)
198195

199196
### In a WebApplication Type of Project
200197

201-
1. Open the __Add Reference__ dialog:
198+
1. Open the **Add Reference** dialog:
202199
>caption Figure 6: Open the Add Reference dialog.
203-
204200
![add-gac-reference-webapp-1 app add reference](images/add-gac-reference-webapp-1_app_add_reference.png)
205201

206202
1. Browse to the GAC to select assembly:
207203
>caption Figure 7: Browse to the GAC and select an assembly to reference.
208-
209204
![add-gac-reference-webapp-2 browse to gac](images/add-gac-reference-webapp-2_browse_to_gac.png)
210205

211206
1. Confirm the reference properties and you make sure they are correct:
212207
>caption Figure 8: Examine the references.
213-
214208
![add-gac-reference-webapp-3 app confirm properties](images/add-gac-reference-webapp-3_app_confirm_properties.png)
215209

216210
### Troubleshooting GAC References
217211

218212
The first problem you may encounter is that the .NET tab of the Add Reference dialog box in VS will not show custom assemblies you have added to the GAC, you either need a third party plugin for your IDE, or a registry key so that it can know about this third-party assembly. Manually browsing to the desired folder is an easy resolution.
219213

220-
Make sure to always __reference the same versions of all Telerik assemblies__ used in the project.
214+
Make sure to always **reference the same versions of all Telerik assemblies** used in the project.
221215

222-
If you get the __"Could not load file or assembly…"__ error. It means the reference is typed in wrongly or the assembly is not actually in the GAC of the machine. This can also be caused by wrong version numbers (e.g. Register directives left over in old user controls). You can consider using a *bindingRedirect* element to redirect all old references to the current one you need. This is useful for SharePoint and Sitefinity scenarios.
216+
If you get the **"Could not load file or assembly…"** error. It means the reference is typed in wrongly or the assembly is not actually in the GAC of the machine. This can also be caused by wrong version numbers (e.g. Register directives left over in old user controls). You can consider using a *bindingRedirect* element to redirect all old references to the current one you need. This is useful for SharePoint and Sitefinity scenarios.
223217

224-
__"CS0433: The type '<RadControl class>' exists in both '<assembly in the GAC>' and '<Temporary ASP.NET Files for the site>"__—this means there is a duplicate reference to our assembly – one that points to the GAC and one that points to a file somewhere else on the machine. To fix this, makes sure the project references are correct and clear the ASP cache.
218+
**"CS0433: The type `<RadControl class>` exists in both `<assembly in the GAC>` and `<Temporary ASP.NET Files for the site>`"** —this means there is a duplicate reference to our assembly – one that points to the GAC and one that points to a file somewhere else on the machine. To fix this, makes sure the project references are correct and clear the ASP cache.
225219

226-
# See Also
220+
## See Also
227221

228222
* [MSDN: Global Assembly Cache](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)
229223

0 commit comments

Comments
 (0)