Skip to content
This repository was archived by the owner on Jan 4, 2022. It is now read-only.

Commit 8949bc6

Browse files
committed
updating readme with quick start instructions, created file-system precompile publishing profile
1 parent 2113d4f commit 8949bc6

File tree

4 files changed

+63
-2
lines changed

4 files changed

+63
-2
lines changed

README.md

+38-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Documenation
1414
===========
1515
Documentation can be found in the [TicketDesk GitHub Wiki](https://github.com/StephenRedd/TicketDesk/wiki)
1616

17-
Developer Notes:
17+
Project Status:
1818
===========
1919

2020
[TicketDesk 2.5 is in beta](https://github.com/StephenRedd/TicketDesk/releases/tag/td2-v2.5.0). We are on track for an August 1<sup>st</sup> stable release.
@@ -28,4 +28,41 @@ The current stable version is [TicektDesk 2.1](https://github.com/StephenRedd/Ti
2828

2929
- TicketDesk 2.1 requires Visual Studio 2012 or higher with .Net Framework 4.5
3030

31+
Getting started:
32+
===========
33+
34+
Development
35+
-----------
36+
37+
Getting started with TicketDesk development should be a "clone, open, and run" experience. You need Visual Studio 2013 with Update 4 or higher, SQL 2012 LocalDB, and Git.
38+
39+
- Clone the github repository
40+
- Switch to the desired branch (development has the latest version, master has latest release ready version)
41+
- Open the project in Visual Studio 2013 or higher
42+
- Hit F5 to run/debug the application
43+
- Code, Contribute, and Enjoy!
44+
45+
Install on Windows Server & IIS
46+
-----------
47+
48+
These are basic instructions for installing a [pre-compiled distribution](https://github.com/NullDesk/TicketDesk/releases) of TicketDesk 2.5 to a single Windows Server with IIS 8 or higher.
49+
For more detailed instructions, and information about other deployments scenarios, including Azure deployment, please see the [GitHub wiki](https://github.com/NullDesk/TicketDesk/wiki).
50+
51+
- Server Requirments:
52+
- Make sure IIS is installed with the options necessary sub-options needed to run Asp.Net MVC 5 applications
53+
- Make sure .Net Framework 4.5.2 is installed on the target server
54+
- Make sure you have access to SQL server 2008 or higher
55+
- The stock web.config is pre-set to use a locally installed instance of SQL Server 2012 LocalDB
56+
- For more information about SQL Server configuration and connection strings please refer to the [GitHub wiki](https://github.com/NullDesk/TicketDesk/wiki)
57+
- Create an IIS Site or right-click an existing site and select "Add Application" to create a new Virtual Directory
58+
- Select or Create an application pool that uses an integrated pipeline
59+
- Make sure the application pool is set for .Net Framework 4.0
60+
- Download the desired precompiled distribution from [GitHub releases](https://github.com/NullDesk/TicketDesk/releases)
61+
- Copy the contents of the zip file into the IIS site's physical folder
62+
- Make sure the application pool user has read access to the web site root folder and all sub-folders (if using the default applicaiton pool identity, just grant the '[machine]\users' group the necessary permissions)
63+
- Make sure the application pool user has write access to the /app_data folder
64+
- Open a web browser, and browse to the web site's root URL
65+
- The first-run-setup page should appear
66+
- Review the settings shown; make everything is accurate before continuing
67+
- Click the Create database button
3168

TicketDesk/TicketDesk.Web.Client/Models/SystemInfoViewModel.cs

+3
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,7 @@ private string GetSqlEdition(string connectionString)
7676
{
7777
var conn = GetMasterCatalogConnection(connectionString);
7878
var cmd = conn.CreateCommand();
79+
cmd.CommandTimeout = 5;
7980
cmd.CommandText = "SELECT SERVERPROPERTY('Edition')";
8081
conn.Open();
8182
edition = cmd.ExecuteScalar() as string;
@@ -93,6 +94,7 @@ private bool GetIsLocalDb(string connectionString)
9394
{
9495
var conn = GetMasterCatalogConnection(connectionString);
9596
var cmd = conn.CreateCommand();
97+
cmd.CommandTimeout = 5;
9698
cmd.CommandText = "SELECT SERVERPROPERTY('IsLocalDB')";
9799
conn.Open();
98100
var ldb = cmd.ExecuteScalar() as int?;
@@ -109,6 +111,7 @@ private SqlConnection GetMasterCatalogConnection(string connectionString)
109111
var builder = new SqlConnectionStringBuilder(connectionString);
110112
builder.AttachDBFilename = "";
111113
builder.InitialCatalog = "Master";
114+
builder.ConnectTimeout = 5;
112115
return new SqlConnection(builder.ToString());
113116
}
114117
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!--
3+
This file is used by the publish/package process of your Web project. You can customize the behavior of this process
4+
by editing this MSBuild file. In order to learn more about this please visit http://go.microsoft.com/fwlink/?LinkID=208121.
5+
-->
6+
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
7+
<PropertyGroup>
8+
<WebPublishMethod>FileSystem</WebPublishMethod>
9+
<LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
10+
<LastUsedPlatform>Any CPU</LastUsedPlatform>
11+
<SiteUrlToLaunchAfterPublish />
12+
<LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
13+
<PrecompileBeforePublish>True</PrecompileBeforePublish>
14+
<EnableUpdateable>True</EnableUpdateable>
15+
<DebugSymbols>False</DebugSymbols>
16+
<WDPMergeOption>DonotMerge</WDPMergeOption>
17+
<ExcludeApp_Data>False</ExcludeApp_Data>
18+
<publishUrl>c:\temp\ticketdesk\filesystem-precompiled-release</publishUrl>
19+
<DeleteExistingFiles>True</DeleteExistingFiles>
20+
</PropertyGroup>
21+
</Project>

TicketDesk/TicketDesk.Web.Client/TicketDesk.Web.Client.csproj

+1-1
Original file line numberDiff line numberDiff line change
@@ -349,6 +349,7 @@
349349
<Content Include="Scripts\dropzone\dropzone.js" />
350350
<Content Include="Scripts\dropzone\dropzone.min.css" />
351351
<Content Include="Scripts\dropzone\dropzone.min.js" />
352+
<None Include="Properties\PublishProfiles\filesystem-precompiled-release.pubxml" />
352353
<None Include="Scripts\jquery-2.1.4.intellisense.js" />
353354
<Content Include="Scripts\jquery-2.1.4.js" />
354355
<Content Include="Scripts\jquery-2.1.4.min.js" />
@@ -537,7 +538,6 @@
537538
<ItemGroup>
538539
<Folder Include="App_Data\" />
539540
<Folder Include="Infrastructure\Filters\" />
540-
<Folder Include="Properties\PublishProfiles\" />
541541
<Folder Include="Views\ProjectSelector\" />
542542
</ItemGroup>
543543
<ItemGroup>

0 commit comments

Comments
 (0)