MS SQL Server

Before installing the UrbanCode Release server, create an SQL Server database. Ideally the database will be installed on a machine other than the one where the server is located.

When you install UrbanCode Release, you will need the connection information, and a user account with table creation privileges.

To install the database

  1. Install the database using the following parameters:

    CREATE DATABASE UrbanCode Release;
    
    USE UrbanCode Release;
    CREATE LOGIN UrbanCode Release WITH PASSWORD = 'password';
    CREATE USER UrbanCode Release FOR LOGIN UrbanCode Release WITH DEFAULT_SCHEMA = UrbanCode Release;
    CREATE SCHEMA UrbanCode Release AUTHORIZATION UrbanCode Release;
    GRANT ALL TO UrbanCode Release;
  2. Obtain the SQL Server JDBC driver from the Microsoft site. The JDBC jar file is not included among the installation files.

    Copy the JDBC jar file to tomcat_directory\lib.

  3. Modify the following parameters in the server.properties file:

    	database.type=sqlserver
    	hibernate.connection.driver_class=
    		com.microsoft.sqlserver.jdbc.SQLServerDriver
    	hibernate.connection.username=urelease
    	hibernate.connection.password=urelease
    	hibernate.connection.url=
    		jdbc:sqlserver://[DB_URL]:[DB_PORT];databaseName=[DB_NAME]
    

    Important

    Database configuration is done by modifying parameters in the server.properties file located at user_home_directory/.urbancode/urelease/conf. On Unix, the user_home_directory is /home; on Windows it is determined by the user profile, which typically is \Users\current_user. Because UrbanCode Release is deployed as a Tomcat web application, the conf file will not be created until UrbanCode Release is deployed, which means that the configuration changes cannot be made until after initial deployment.

    A typical hibernate.connection.url might be:

    jdbc:sqlserver://localhost:1433;databaseName=UrbanCode Release

    Note

    Initially, the password contains an encrypted string. Overwrite the string with the new password. The first time the password is entered it will be plain text, but will be encrypted the next time UrbanCode Release starts.

  4. When you are fished, restart the Tomcat server.