Running the database creation utility

Topic 50336 | Creating the Log Database | Updated 22-Oct-2013


Applies To:	Websense Web Filter, Web Security, Web Security Gateway, and Web Security Gateway Anywhere, v7.7, 7.8

A database creation utility (createdbu) is installed with Websense Log Server. You can use this command-line utility to create or upgrade the Log Database manually.

To use the database creation utility, you must provide a database name and the IP address of the Microsoft SQL Server machine.

If the database is not found on the SQL Server machine, a new Log Database is created.

If the database name is found, the existing database is upgraded.

If the database name is found but the database does not require upgrade, the utility takes no action.

To run the database creation utility:

Open a command prompt (Start > Run > cmd) on the Log Server machine.

Navigate to the Websense SQL directory (C:\Program Files (x86)\Websense\Web Security\SQL, by default).

Enter the following command:

createdbu -ip <IP_address> -name <db_name> -user <user_name> -pass <password>

For example:

createdbu -ip 10.123.123.123 -name wslogdb70 -user sa -pass testpassword

This prompts the utility to create or upgrade the database "wslogdb70" on the SQL Server machine at 10.123.123.123. The SQL Server "sa" account is used, and the password is "testpassword."

Additional parameters can be used to customize database creation. See Database creation utility parameters.

Each parameter must be preceded by a dash (-) and followed by a space and value (argument).

There is no mandatory order for parameters.

Wait for the database to be created. This process can take several minutes.

The catalog database is created first, followed (after a few minutes) by the partition database, and then the threats partition.

If an error occurs, see Database creation utility errors.

If the process completes successfully, optionally use Microsoft SQL Server Management Studio to verify that the database and its jobs were created as expected. See Using SQL Server Management Studio to verify database creation.

Enter database connection information on the Settings > Reporting > Log Server page in the Web Security manager, then click OK and Save and Deploy.

Log Server creates the ODBC connection and provides connection information for the other reporting components.

If Log Server stopped because database problems, start the service.

(v7.7) Go to the Log Server machine and use the Windows Services dialog box to start Websense Log Server.

(v7.8) Use the Component List tab of the Status > Deployment page to start Log server.

Once Websense Web Security installation is complete and policy enforcement has started, data should begin to appear in the Web Security manager. Use Real-Time Monitor, dashboard charts, investigative reports, or presentation reports to verify that reporting data is being recorded. If no data or incomplete data appears in reporting tools, see Incorrect or missing data in Web Security reports.