Hosts Configuration

- Create an entry in your hosts file (C:\WINDOWS\system32\drivers\etc\hosts on XP, I think) that maps storagedev.ngenplatform.com to localhost. This is what my hosts file looks like:

127.0.0.1 localhost

127.0.0.1 userdev.ngenplatform.com

127.0.0.1 provisiondev.ngenplatform.com

127.0.0.1 storagedev.ngenplatform.com

127.0.0.1 simulationdev.ngenplatform.com

127.0.0.1 javatoolkitdev.ngenplatform.com

127.0.0.1 utilsdev.ngenplatform.com

Apache Configuration

- Perform a local install of Apache 2.2

- Edit %APACHE_HOME%\conf\httpd.conf and add this to the bottom (use an actual asterisk please):

Include conf/sites-enabled/<asterisk>.vhost

- Edit %APACHE_HOME%\conf\httpd.conf and make sure the following modules are being loaded:

LoadModule auth_basic_module modules/mod_auth_basic.so

LoadModule auth_digest_module modules/mod_auth_digest.so

LoadModule authn_file_module modules/mod_authn_file.so

LoadModule authn_alias_module modules/mod_authn_alias.so

LoadModule authn_anon_module modules/mod_authn_anon.so

LoadModule authn_dbm_module modules/mod_authn_dbm.so

LoadModule authn_default_module modules/mod_authn_default.so

LoadModule authz_host_module modules/mod_authz_host.so

LoadModule authz_user_module modules/mod_authz_user.so

LoadModule authz_owner_module modules/mod_authz_owner.so

LoadModule authz_groupfile_module modules/mod_authz_groupfile.so

LoadModule authz_dbm_module modules/mod_authz_dbm.so

LoadModule authz_default_module modules/mod_authz_default.so

LoadModule ldap_module modules/mod_ldap.so

LoadModule authnz_ldap_module modules/mod_authnz_ldap.so

LoadModule include_module modules/mod_include.so

LoadModule log_config_module modules/mod_log_config.so

LoadModule logio_module modules/mod_logio.so

LoadModule env_module modules/mod_env.so

LoadModule ext_filter_module modules/mod_ext_filter.so

LoadModule mime_magic_module modules/mod_mime_magic.so

LoadModule expires_module modules/mod_expires.so

LoadModule deflate_module modules/mod_deflate.so

LoadModule headers_module modules/mod_headers.so

LoadModule usertrack_module modules/mod_usertrack.so

LoadModule setenvif_module modules/mod_setenvif.so

LoadModule mime_module modules/mod_mime.so

LoadModule dav_module modules/mod_dav.so

LoadModule status_module modules/mod_status.so

LoadModule autoindex_module modules/mod_autoindex.so

LoadModule info_module modules/mod_info.so

LoadModule dav_fs_module modules/mod_dav_fs.so

LoadModule vhost_alias_module modules/mod_vhost_alias.so

LoadModule negotiation_module modules/mod_negotiation.so

LoadModule dir_module modules/mod_dir.so

LoadModule actions_module modules/mod_actions.so

LoadModule speling_module modules/mod_speling.so

LoadModule userdir_module modules/mod_userdir.so

LoadModule alias_module modules/mod_alias.so

LoadModule rewrite_module modules/mod_rewrite.so

LoadModule proxy_module modules/mod_proxy.so

LoadModule proxy_balancer_module modules/mod_proxy_balancer.so

LoadModule proxy_ftp_module modules/mod_proxy_ftp.so

LoadModule proxy_http_module modules/mod_proxy_http.so

LoadModule proxy_connect_module modules/mod_proxy_connect.so

LoadModule cache_module modules/mod_cache.so

LoadModule suexec_module modules/mod_suexec.so

LoadModule disk_cache_module modules/mod_disk_cache.so

LoadModule file_cache_module modules/mod_file_cache.so

LoadModule mem_cache_module modules/mod_mem_cache.so

LoadModule cgi_module modules/mod_cgi.so

LoadModule ssl_module modules/mod_ssl.so

- In %APACHE_HOME%\conf, create folders called sites-enabled and sites-available

- In conf/sites-enabled create a virtual host file called 001-service-storage.vhost and make it look like the attached vhost file. This is where you'll change the port if you're not using the default Tomcat port (8080).

- Restart apache. Verify that it starts cleanly.

Tomcat Configuration

Read this to learn about tomcat virtual hosts

- Delete the ROOT app that comes with tomcat (I actually delete all of the apps that come with Tomcat, but that isn't strictly necessary)

- Add a virtual host section to the bottom of %TOMCAT_HOME%/conf/server.xml:

<Host name="storagedev.ngenplatform.com" debug="5" appBase="webapps/storage" unpackWARs="true" autoDeploy="true" xmlValidation="false" xmlNamespaceAware="false">

<Logger className="org.apache.catalina.logger.FileLogger" directory="logs" prefix="storage\_log." suffix=".txt" timestamp="true"/>

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="storage_access_log." suffix=".txt"  pattern="common" resolveHosts="false"/>

</Host>

- In %TOMCAT_HOME%\conf\Catalina, create a new directory called storagedev.ngenplatform.com. Create ROOT.xml in this new directory that looks something like this:

<?xml version='1.0' encoding='utf-8'?>

<Context displayName="storage" docBase="" path="" workDir="work/Catalina/storage/_"/>

- Start Tomcat. Verify that it starts cleanly.

Storage Service Configuration - Derby (Default)

- get service_storage.auth.war and service_storage.noauth.war from svn at service_storage\trunk\deploy

- create two virtual hosts in tomcat:

• storagedev.ngenplatform.com
• storageauthdev.ngenplatform.com
  

- create two entries in \system32\drivers\etc\hosts:

• 127.0.0.1 storagedev.ngenplatform.com
• 127.0.0.1 storageauthdev.ngenplatform.com

- cp service_storage.auth.war %TOMCAT_HOME%\webapps\storageauth\ROOT.war

- cp service_storage.noauth.war %TOMCAT_HOME%\webapps\storage\ROOT.war

- By default, the two storage service instances will look for the provision service at http://localhost:3003 - if you've moved it, edit web.xml in each instance and point the parameter provisioning-endpoint to the correct value and restart tomcat.

- Test that the instances are operational  by hitting the webdav interface on each:

• http://storagedev.ngenplatform.com:8080/repository/default (credentials admin / <blank>)
• http://storageauthdev.ngenplatform.com:8080/repository/default (credentials admin / <blank>)

- Use apache to forward requests to tomcat to run on port 80 (optional)

- Make sure your applications are provisioned correctly for your storage service endpoints.

Storage Service Configuration - S3

- Find service_storage.war in the storage service build (C:\dev\service_storage\trunk\deploy on my box)

- In %TOMCAT_HOME%\webapps create a directory called storage

- Rename service_storage.war to ROOT.war and drop it into the new storage folder

- The WAR should autodeploy. Allow it to autodeploy and then shut tomcat down.

- Edit %TOMCAT_HOME%\webapps\storage\ROOT\WEB-INF\s3.properties and make sure that the dev values are uncommented. Change the namespace to a personal one (i.e. mschriftman). This will protect everyone from file system conflicts on s3.

- Edit %TOMCAT_HOME%\webapps\storage\ROOT\WEB-INF\web.xml and set the address of your provision service. Find the provisioning-endpoint parameter and change it to the appropriate endpoint (i.e. localhost:3000, provisiondev.ngenplatform.com, etc...)

- Restart tomcat again. There will be errors in the log the first two times your start it up, so restart tomcat twice. Verify that it comes up cleanly.

- Go to this link to hit the webDAV interface and view your repository: http://storagedev.ngenplatform.com/repository/default/ (assuming that you set up your hosts file - http://localhost:8080/repository/default should also work.)

002-service-storage.vhost