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

Commit

Permalink
updating readme with quick start instructions, created file-system pr…
Browse files Browse the repository at this point in the history
…ecompile publishing profile
  • Loading branch information
StephenRedd committed Jul 2, 2015
1 parent 2113d4f commit 8949bc6
Show file tree
Hide file tree
Showing 4 changed files with 63 additions and 2 deletions.
39 changes: 38 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Documenation
===========
Documentation can be found in the [TicketDesk GitHub Wiki](https://github.com/StephenRedd/TicketDesk/wiki)

Developer Notes:
Project Status:
===========

[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.
Expand All @@ -28,4 +28,41 @@ The current stable version is [TicektDesk 2.1](https://github.com/StephenRedd/Ti

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

Getting started:
===========

Development
-----------

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.

- Clone the github repository
- Switch to the desired branch (development has the latest version, master has latest release ready version)
- Open the project in Visual Studio 2013 or higher
- Hit F5 to run/debug the application
- Code, Contribute, and Enjoy!

Install on Windows Server & IIS
-----------

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.
For more detailed instructions, and information about other deployments scenarios, including Azure deployment, please see the [GitHub wiki](https://github.com/NullDesk/TicketDesk/wiki).

- Server Requirments:
- Make sure IIS is installed with the options necessary sub-options needed to run Asp.Net MVC 5 applications
- Make sure .Net Framework 4.5.2 is installed on the target server
- Make sure you have access to SQL server 2008 or higher
- The stock web.config is pre-set to use a locally installed instance of SQL Server 2012 LocalDB
- For more information about SQL Server configuration and connection strings please refer to the [GitHub wiki](https://github.com/NullDesk/TicketDesk/wiki)
- Create an IIS Site or right-click an existing site and select "Add Application" to create a new Virtual Directory
- Select or Create an application pool that uses an integrated pipeline
- Make sure the application pool is set for .Net Framework 4.0
- Download the desired precompiled distribution from [GitHub releases](https://github.com/NullDesk/TicketDesk/releases)
- Copy the contents of the zip file into the IIS site's physical folder
- 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)
- Make sure the application pool user has write access to the /app_data folder
- Open a web browser, and browse to the web site's root URL
- The first-run-setup page should appear
- Review the settings shown; make everything is accurate before continuing
- Click the Create database button

Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ private string GetSqlEdition(string connectionString)
{
var conn = GetMasterCatalogConnection(connectionString);
var cmd = conn.CreateCommand();
cmd.CommandTimeout = 5;
cmd.CommandText = "SELECT SERVERPROPERTY('Edition')";
conn.Open();
edition = cmd.ExecuteScalar() as string;
Expand All @@ -93,6 +94,7 @@ private bool GetIsLocalDb(string connectionString)
{
var conn = GetMasterCatalogConnection(connectionString);
var cmd = conn.CreateCommand();
cmd.CommandTimeout = 5;
cmd.CommandText = "SELECT SERVERPROPERTY('IsLocalDB')";
conn.Open();
var ldb = cmd.ExecuteScalar() as int?;
Expand All @@ -109,6 +111,7 @@ private SqlConnection GetMasterCatalogConnection(string connectionString)
var builder = new SqlConnectionStringBuilder(connectionString);
builder.AttachDBFilename = "";
builder.InitialCatalog = "Master";
builder.ConnectTimeout = 5;
return new SqlConnection(builder.ToString());
}
}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
<?xml version="1.0" encoding="utf-8"?>
<!--
This file is used by the publish/package process of your Web project. You can customize the behavior of this process
by editing this MSBuild file. In order to learn more about this please visit http://go.microsoft.com/fwlink/?LinkID=208121.
-->
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<WebPublishMethod>FileSystem</WebPublishMethod>
<LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
<LastUsedPlatform>Any CPU</LastUsedPlatform>
<SiteUrlToLaunchAfterPublish />
<LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
<PrecompileBeforePublish>True</PrecompileBeforePublish>
<EnableUpdateable>True</EnableUpdateable>
<DebugSymbols>False</DebugSymbols>
<WDPMergeOption>DonotMerge</WDPMergeOption>
<ExcludeApp_Data>False</ExcludeApp_Data>
<publishUrl>c:\temp\ticketdesk\filesystem-precompiled-release</publishUrl>
<DeleteExistingFiles>True</DeleteExistingFiles>
</PropertyGroup>
</Project>
Original file line number Diff line number Diff line change
Expand Up @@ -349,6 +349,7 @@
<Content Include="Scripts\dropzone\dropzone.js" />
<Content Include="Scripts\dropzone\dropzone.min.css" />
<Content Include="Scripts\dropzone\dropzone.min.js" />
<None Include="Properties\PublishProfiles\filesystem-precompiled-release.pubxml" />
<None Include="Scripts\jquery-2.1.4.intellisense.js" />
<Content Include="Scripts\jquery-2.1.4.js" />
<Content Include="Scripts\jquery-2.1.4.min.js" />
Expand Down Expand Up @@ -537,7 +538,6 @@
<ItemGroup>
<Folder Include="App_Data\" />
<Folder Include="Infrastructure\Filters\" />
<Folder Include="Properties\PublishProfiles\" />
<Folder Include="Views\ProjectSelector\" />
</ItemGroup>
<ItemGroup>
Expand Down

0 comments on commit 8949bc6

Please sign in to comment.