Installing bitB

The bitB installer walks you through the installation process.  This help topic is supplemental.

Contents

• Preparation checklist
• Getting the installer
• Before you begin
• Running the installer
• Installation advice and tips (see page 4)
  • Error: CS364: Could not connect to the database (see page 4)

Preparation Checklist

• You are making a fresh bitB installation.
• You are a network engineer or system administrator.
• You have administrator Privileges or can run the installer with elevated privileges.
• You have reviewed the software and hardware information on General Software and Hardware Requirements (see page 3).

Getting the Installer

1. Open http://download.bradinthebox.net/bitBinstaller.exe
2. Download the installer
3. bitBinstaller is the full installation

Before you begin

Microsoft SQL Server must be installed and available before you can run bitB.  The bitBinstaller will install Microsoft SQL Server Express or use an existing local installation of Microsoft SQL Server or Microsoft SQL Server Express.

Running the installer

The installation wizard walks you through all steps in the correct order.

1. Exit all other programs before running the setup program.
2. Run the bitBinstaller.exe file.
3. The installer will start with the Welcome to the prerequisite's setup wizard screen.
4. If you have not obtained a license, do so before using the software.
5. Done.

Installation advice and tips

Error:  The selected instance "(local)\SQLEXPRESS" returned the following error, The selected instance "(local)\SQLEXPRESS" returned the following error, [DBNETLIB] ConnectionOpen (connect()).]  SQL Server does not exist or access denied.

A "SQL Server does not exist or access denied" message during installation indicates that SQL.  Server is not installed or SQL Server is not running locally on the system.  You will need to manually install bitB if the installer can't find an active local install of Microsoft SQL Server or if SQL Server or if SQL Server is installed remotely.

Database Connection Properties

Use the Add Database Connection Properties screen to define the SQL database connection properties.

1. Define the SQL database connection properties.
   
   bitB requires a database to store run-time data. You need to specify:
   
   Server Name:  Host\SQL_Instance:Port
   
   You may need to consult your database administrator to determine the correct values.
   
   If the database is on the local machine, you can enter (Local) in the Host field.
   
   For a remote server, set Host to the IP address.
   
   If you are using Microsoft SQL Server express, you can enter SQLEXPRESS in the [\instance] field.  If you are using Microsoft SQL   Server, you can enter MSSQLSERVER.
   
   
2. Log on to the server
   
   bitB can use Windows Authentication or SQL Server Authentication.
   
   
   1. Windows Authentication is used for a local Microsoft SQL Server or local Microsoft SQL Server Express installation.
      
      
   2. SQL Server Authentication can be sued for local or remote SQL Server databases.  Note:  SQL Server and Windows Authentication mode must be enabled on the system hosting the bitB database.
3. Enter the user name and password.
   
   
   1. For SQL Authentication, enter the username and password form the local or remote installation.
      
      
   2. No Username and Password is required for Windows Authentication.  The logged in user ID and password are used.
      
      
4. Initial catalog to use (Database Name)
   Enter the name you used to create the bitB database.  The default name is bitB.