Web Server
Dev Hound comes with its own Web Server. The reason is that using an external web server such as IIS can be difficult to configure and is not available on all windows platforms. The web server in Dev Hound runs on Windows 95 and above and can be used as part of an intranet solution or across the internet.
Also note that you can use IIS and Dev Hound's web server concurrently by changing the port number (see below).
Starting the Web Server
When you install Dev Hound its web server will automatically startup when you log into Windows however if you need to shut it down or an error occurs you can restart it by:
Shutting down the Web Server
You can shutdown the web server by right clicking on its icon in the system tray and choosing Shutdown. For more information about hits on the web server just click on the icon in the system tray.
Web Server Options
By clicking on the Dev Hound Web Server icon in the system tray you will see the following dialog:
Also note that you can use IIS and Dev Hound's web server concurrently by changing the port number (see below).
Starting the Web Server
When you install Dev Hound its web server will automatically startup when you log into Windows however if you need to shut it down or an error occurs you can restart it by:
- Click on Start
- Click on Programs
- Click on Dev Hound
- Click on Web Server
- The web server icon will appear in the system tray
Shutting down the Web Server
You can shutdown the web server by right clicking on its icon in the system tray and choosing Shutdown. For more information about hits on the web server just click on the icon in the system tray.
Web Server Options
By clicking on the Dev Hound Web Server icon in the system tray you will see the following dialog:
- Log to File : Whenever someone accesses the web server an entry is added to the log. Click "View Log" to see the log
- Run as Service : This option will run the web server as a service rather than a regular application. This means that it will continue running even when logged off. It also allow you to configure recovery option in Control Panel : Adminstrative Tools : Services - where you can have the web server restarted automatically if it fails.
- Server Address : This is the address that will be used when accessing Dev Hound. For example if you have the web server PC exposed to the internet and its IP address is mapped to www.yourcompany.com then you can add www.yourcompany.com to the server address. This will affect the way cookies work which may resolve Dev Hound login problems.
- Port : This is the TCP/IP port used. By default all web servers use port 80. However if you would like to run Dev Hounds web server alongside IIS then you could change it to say 81. When accessing Dev Hound you would therefore use http://yourservername:81/devhound.dll
- Default Web Folder : This is the default folder for web access. It is usually set to c:\program files\dev hound\cgi however may be changed if desired.
Web Server Actions
The following buttons are available:
- Start : Starts the web server
- Stop : Stops the web server from serving requests. It also clears Dev Hound (and other web applications) from memory.
Virtual Folders
Virtual Folders allow you to have multiple installations of Dev Hound or other ISAPI web applications or web sites. For example if you have a second installation of Dev Hound in c:\program files\devhound2 then you could add a virtual folder called dh2 pointing to c:\program files\devhound2. To access this virtual folder you would enterhttp://yourservername/dh2/devhound.dll.
To add a virtual folder:
- Click the virtual folders tab
- Click the add button
- Type the name of the virtual folder
- Click the browse button and choose the real folder location of the web application/site
- Click Ok, Apply and then Close
- Click Yes to confirm changes to the virtual folder settings
- Click stop on the settings tab and click start to restart the web server
Dev Hound Web Server Options
There are some Dev Hound options that will affect the way the web server works. Go to Start - Programs - Dev Hound - Configuration. The following options are available:
- Web Folder : The directory where the web pages for Dev Hound are located.
- Relative Web Folder : The relative path used to reference images and other files. This is the path to the web directory relative to where the web server application resides. This is typically noted as /web where the web server resides in say d:\website and the web directory is in d:\website\web
IIS Installation Guide
Dev Hound gives you the option to install Dev Hound into IIS on installation however if you would like to do it manually you may use this guide.
Nexus Concepts recommends using the builtin Web Server on a different port number rather than using IIS as the built in web server is easier to configure and has features specific to Dev Hound
Nexus Concepts recommends using the builtin Web Server on a different port number rather than using IIS as the built in web server is easier to configure and has features specific to Dev Hound
- Click on Start -> Control Panel
- Double click Administrative Tools
- Double click Internet Information Services (as shown below)
- Open the + sign next to the local computer
- Open the + sign next to Web Sites
- Open the + sign next to Default Web Site
- Right click on Default Web Site, choose New, choose Virtual Directory (as shown below)
- Click the Next button on the first wizard screen
- Enter devhound in the alias edit box (this can be anything you like)
- Click on Next
- Click on the Browse button and choose c:\program files\devhound\cgi (note: this may be different depending on where you chose to install dev hound)
- Click the Ok button for the directory and Click on Next
- Check the option Execute (Such as ISAPI application or CGI)
- Click on Next and click on Finish
- Click on Start -> All Programs -> Dev Hound -> Configuration
- Enter /devhound/web in the relative web directory box where devhound is the IIS alias you defined
- Click on Apply and close configuration
- Open your web browser with http://localpcname/devhound/devhound.dll where localpcname is the computer name of this pc and devhound is the alias defined in IIS.
- NOTE: You will need to change the security on your data folder to modify permission for IUSR_SERVERNAME and execute permission on devhound.dll. Where SERVERNAME is the name of the server
Windows Server 2003 (IIS 6)
- Click on Start -> Administrator Tools -> IIS Manager
- Select "Web Service Extensions"
- Click "Add a new web service extension"
- Enter "Dev Hound" for the extension name
- Click "Add"
- Choose "DevHound.dll" from c:\program files\dev hound\cgi
- Click on "Ok"
- Click on the "Set extension status to Allowed" checkbox
- Click "Ok"
Read Only Database Error
This is a sharing problem. Internet Information services (IIS) runs all web applications under the user profile IUSR_MACHINENAME (where MACHINENAME is the computers name). Right click on the data subfolder of dev hound and click the security tab. Add IUSR_MACHINENAME to the list of user with read and write access. For devhound.dll or devhound.exe it should also have execute access.
Also, if you are using Windows XP you will need to turn off simple file sharing : open windows explorer, tools menu, folder options, view tab, scroll down and uncheck simple file sharing
SQL Server Notes
If you are using SQL Server and IIS you will need to make sure the user profile IUSR_MACHINENAME is granted access within SQL Server. Alternatively you may open IIS and change the properties of devhound.dll (and/or devhound.exe) and set the file security for anonymous access to a user profile that does have access to SQL server (such as administrator)
This is a sharing problem. Internet Information services (IIS) runs all web applications under the user profile IUSR_MACHINENAME (where MACHINENAME is the computers name). Right click on the data subfolder of dev hound and click the security tab. Add IUSR_MACHINENAME to the list of user with read and write access. For devhound.dll or devhound.exe it should also have execute access.
Also, if you are using Windows XP you will need to turn off simple file sharing : open windows explorer, tools menu, folder options, view tab, scroll down and uncheck simple file sharing
SQL Server Notes
If you are using SQL Server and IIS you will need to make sure the user profile IUSR_MACHINENAME is granted access within SQL Server. Alternatively you may open IIS and change the properties of devhound.dll (and/or devhound.exe) and set the file security for anonymous access to a user profile that does have access to SQL server (such as administrator)
Installing with Apache
Dev Hound can also be used with the Apache web server (http://httpd.apache.org/) instead of IIS or the built in web server/service. Note: Dev Hound does not run on Linux Apache servers, only windows ones.
After installing Apache web server you will need to edit httpd.conf (just use notepad to open it) and add the following lines:
AddHandler isapi-isa .dll
NameVirtualHost :80
ServerName YOURPCNAME
DocumentRoot "C:\Program Files\devhound\cgi"
Options ExecCGI
You MUST replace the word YOURPCNAME with the computer name of the Apache Server. Once you have done this you should be able to access Dev Hound using http://YOURPCNAME/devhound.dll For more information about this Apache feature see http://httpd.apache.org/docs/mod/mod_isapi.html
After installing Apache web server you will need to edit httpd.conf (just use notepad to open it) and add the following lines:
AddHandler isapi-isa .dll
NameVirtualHost :80
ServerName YOURPCNAME
DocumentRoot "C:\Program Files\devhound\cgi"
Options ExecCGI
You MUST replace the word YOURPCNAME with the computer name of the Apache Server. Once you have done this you should be able to access Dev Hound using http://YOURPCNAME/devhound.dll For more information about this Apache feature see http://httpd.apache.org/docs/mod/mod_isapi.html
External Hosting Installation
The following guide will be useful if you will be hosting Dev Hound on an external windows based hosting site.
Firstly, install Dev Hound on a local PC then you will need to upload files to your web server location. Be sure you know where you can put web applications such as the cgi-bin folder.
Permissions
You should also set permissions on your folders if possible. Use to following:
Optional CGI app
You may also download the cgi application version for Dev Hound from www.nexusconcepts.com , install it and upload the file devhound.exe to the cgi-bin folder. You use devhound.exe rather than devhound.dll when opening Dev Hound. The cgi application has the advantage of extra stability and the ability to upgrade without requiring a server restart, it is however considerably slower than the ISAPI dll.
Notes about IE
Internet Explorer hides useful error messages reported by Dev Hound (such as permission problems). To turn this off:
Firstly, install Dev Hound on a local PC then you will need to upload files to your web server location. Be sure you know where you can put web applications such as the cgi-bin folder.
- Upload to the cgi-bin folder: devhound.dll, standard.css
- Create a data folder and upload: devhound.tdbd, archive.tdbd
- Create a templates folder and upload the contents of the templates folder
- Create a web folder and upload the contents of the web folder (usually as a subfolder of cgi-bin folder)
- Open the file tsconfig.ini file (which may be located on your root c drive) and alter the directory for database, web, templates and relative (should be .\web) using absolute paths if possible
- Upload tsconfig.ini to the same place as devhound.dll
Permissions
You should also set permissions on your folders if possible. Use to following:
- cgi-bin - Executable
- web - read
- templates - read
- data - read write modify
Optional CGI app
You may also download the cgi application version for Dev Hound from www.nexusconcepts.com , install it and upload the file devhound.exe to the cgi-bin folder. You use devhound.exe rather than devhound.dll when opening Dev Hound. The cgi application has the advantage of extra stability and the ability to upgrade without requiring a server restart, it is however considerably slower than the ISAPI dll.
Notes about IE
Internet Explorer hides useful error messages reported by Dev Hound (such as permission problems). To turn this off:
- Open Control Panel
- Double click Internet Options
- Click the Advanced tab
- Uncheck the option "show friendly http error messages"
