Difference between revisions of "Installation"

From dbscript Online Help
Jump to: navigation, search
(Server Requirements)
(IIS Server)
Line 45: Line 45:
 
=== IIS Server ===
 
=== IIS Server ===
  
* Create a directory, virtual directory, or website in IIS Administrator
+
* Create a directory, virtual directory, and create an application; or create a website in IIS Administrator
* Extract web.zip into the directory
+
* Extract web.zip (dbs*webpub.zip) into the directory
* Copy web.config into the directory
+
* If the zip contains a file called web.publish.config, rename it to web.config
 +
* Otherwise, copy web.config into the directory
 
* Locate the connection string in web.config and adjust server name, catalog, username, and password.
 
* Locate the connection string in web.config and adjust server name, catalog, username, and password.
  

Revision as of 12:40, 15 September 2010

Server Requirements

Up to Version 1.02

From Version 1.03 on

  • IIS running on Windows XP or higher
  • .Net 3.5 Service Pack 1
  • SQL Server 2000 or higher
  • ODP.Net from Oracle Data Access Components 11g (only; required for Oracle connectivity)
  • Npgsql (optional; required for PostgreSql connectivity)

Installation

SQL Server

Open Enterprise Manager (SQL 2000) or SQL Management Studio (SQL 2005+)

  • Create a database (select a case-insensitive collation such as Latin1_General_CI_AS)
  • In the database, run the scripts:
  • Create.sql
  • Initialize Users.sql
  • Value Script.sql
  • Code Snippet.sql

(The names of the sql scripts are preceded by "dbs" plus the version number)

The Users table contains one record with the ID "Administrator". You can change the ID to your desired username to log in to the application.

SQL Server must allow SQL Server authorization.

Create a database login:

  • SQL Server authorization
  • no password policy
  • allow dbo access to the database.

IIS Server

  • Create a directory, virtual directory, and create an application; or create a website in IIS Administrator
  • Extract web.zip (dbs*webpub.zip) into the directory
  • If the zip contains a file called web.publish.config, rename it to web.config
  • Otherwise, copy web.config into the directory
  • Locate the connection string in web.config and adjust server name, catalog, username, and password.

The web.zip filename is preceded by "dbs" + date + version.

Upgrade

SQL Server

Open Enterprise Manager (SQL 2000) or SQL Management Studio (SQL 2005+) and locate the existing dbscript database.

  • Open a query window in the database and run the scripts
  • database upgrade script named "dbs" + new version + "from" + old version + ".sql"
  • Value Script.sql
  • Code Snippet.sql

IIS Server

Extract the contents of web.zip into the web application directory.

The web.zip filename is preceded by "dbs" + date + version.

Configuration

Update Notifications

dbscript 0.99 introduces Update Notifications. This feature fetches information about new versions of dbscript from update.devio.at.

By default, the information is fetched by client-side Javascript.

You can configure the update notification behavior by setting the UpdateMode column in the Configuration table to:

   0 ... client side fetch
   1 ... server side fetch (the IIS machine needs to have connection to the Internet)
   -1 .. disabled 

In Internet Explorer, client-side update fetch may lead to a security warning about accessing a different website from script.

To avoid the message, add update.devio.at to a zone that allows cross-domain access. See this MSDN KB entry for more information.

Register License

  • Start your webbrowser and navigate to the URL of your installation
  • Login using the selected username without password
  • Navigate to Settings, upload you license key file