Changes between Version 6 and Version 7 of Documentation/Howto/SetupHiveServer

Timestamp:

09/06/11 17:12:03 (13 years ago)

Author:

ascheibe

Comment:

--

Documentation/Howto/SetupHiveServer

@@ -2 +2 @@
 This page gives you instructions about how to setup and run a Hive server.
 
-Certificate and Authentication:
+== Certificate and Authentication ==
  * Follow DevelopersHowtosDevelopServices
+ * Notes on using SQL Server 2008 R2: 
+     * In the connection string the `.\SQLEXPRESS` should be changed to `.` . For example in the command to create the ASP.NET authentication database:
+       `aspnet_regsql.exe -C "data source=.;Integrated Security=SSPI" -A all -d HeuristicLab.Authentication`.
+     * If the above mentioned command fails with a timeout, the error could be a compatibility problem between the 2005 and 2008R2 SQL Server versions. 
+       SQL Server Management Studio offers the option in the database properties to set the compatibility level to SQL Server 2005 and this should fix the problem. 
  * Goto Windows Services > start `Distributed Transaction Coordinator` service (needed to use transactions over multiple databases)
 
-Enable net.tcp protocols:
- * Control Panel > Programs & Features > Turn Windows features on or off
- * Expand Microsoft .NET Framework 3.x.x
- * Check the "Windows Communication Foundation Non-HTTP Activation" check box.
- * Open Visual Studio command prompt as administrator and run this command: `%windir%\Microsoft.NET\Framework\v4.xxxx\ServiceModelReg.exe" -r`
-
-Setup IIS:
+== Setup IIS ==
  * Open IIS Manager
  * Create an application pool (Hive-3.3, .net 4.x, integrated)
-  * Open advanced settings of the application pool and select `NetworkService` as identity (if you don't have your own identities for IIS AppPools)
+  * Open advanced settings of the application pool and select `NetworkService` as identity (if you don't have your own identities for IIS `AppPools`)
   * Set `Disable Overlapping Recycle` to true. This avoids that multiple `AppDomains` are created which causes problems in Hive-3.3.
  * Create a new website (or use an existing one)
  * Go to bindings of the website.
-  * Add a http-binding with port 9000.
-  * Add a net.tcp binding with `9001:*` in the binding information.
+  * Add a http-binding with port 80.
  * Create a new application within the website and call it Hive-3.3 and use the already created appPool Hive-3.3
- * Open advanced settings of the application and enter `http, net.tcp` as enabled protocols
+ * Open advanced settings of the application and enter `http` as enabled protocols
  * Grant the usergroup `IIS_IUSRS` read-permissions on the application directory
+ * Grant the `NetworkService` user read access to the certificate you created in DevelopersHowtosDevelopServices
 
 
-Problem:
+== Add groups and users to the authentication db ==
+ * Open the Hive Visual Studio solution
+ * Click on the Hive-3.3 Web project. In the solution explorer the ASP.NET Configuration button shows up. As mentioned in DevelopersHowtosDevelopServices this allows to configure users and groups. On the configuration website, first add the groups:
+   * Hive Administrator
+   * Hive Slave
+   * Hive User
+   * Hive `IsAllowedPrivileged`
+ * Users can now be added to the appropriate groups.
+ * A special user for hive slaves must be added. This user has to be in the `Hive Slave` group. The default configuration is 
+   * User: `hiveslave`
+   * Password: `hiveslave`
+
+== Webservice client setup ==
+ * All clients (slave, administration, experiment manager) have an `app.config` file which contains a `certificate` tag under `<identity>`.
+   To get this value for the local server execute `svcutil.exe http://localhost/Hive-3.4/HiveService.svc?wsdl`. This generates the client stub for the hive webservice. In the `output.config` file you will find the `certificate` tag with the right value. Replace all keys in the hive clients with this key of your machine.  
+
+
+== Problems and solutions ==
  * Exception `Could Not Load Type System.ServiceModel.Activation.HttpModule`
   * run `aspnet_regiis.exe -iru`