Siebel Database Upgrade Guide > Overview of Siebel Database Environments >

About File Paths and Commands in Siebel Database Upgrade Topics

Environment variables and path placeholders for both Windows and UNIX paths are used throughout Siebel Database Upgrade Guide. Enter UNIX commands in a Korn shell. Enter Windows commands in a Windows Command Prompt window.

Windows Paths

The following path conventions specify file system locations in Siebel Database Upgrade Guide topics:

• SIEBEL_ROOT is the absolute path of the Siebel Server installation directory. When you install a Siebel Server, the installation program queries for the path to the installation directory. The installation program then installs the Siebel Server in a subdirectory of this path called siebsrvr. For example, if you specified C:\sba81 as the installation directory for Siebel CRM 8.1, then SIEBEL_ROOT is C:\sba81\siebsrvr.
• DBSRVR_ROOT is the absolute path to the Siebel Database Configuration Utilities on the Siebel Server. When you install the Siebel Database Server, the installation program queries for the path to the Siebel Server installation directory. The script then installs the Siebel Database Server files at the same level in a subdirectory called dbsrvr. For example, if SIEBEL_ROOT is C:\sba81\siebsrvr, then DBSRVR_ROOT is C:\sba81\dbsrvr. In this guide, many examples use the path C:\ and C:\sba81.
• SIEBEL_TOOLS_ROOT is the directory in which Siebel Tools is installed, on a developer computer running Microsoft Windows.

UNIX Paths

The following environment variables and path conventions specify file system locations in Siebel Database Upgrade Guide topics:

• SIEBEL_ROOT is the absolute path of the Siebel Server installation directory and also an environment variable that defines this path. When you install a Siebel Server, the installation script queries for the path to the installation directory. The script then installs the Siebel Server in a subdirectory of this path called siebsrvr. For example, if you specified /usr/siebel as the installation directory for Siebel CRM version 8.x, then $SIEBEL_ROOT is /usr/siebel/sba81/siebsrvr.

  SIEBEL_ROOT and other environment variables required for doing an upgrade are located in siebsrvr/siebenv.sh and siebsrvr/siebenv.csh. The Siebel Server installation script sets environment variable definitions in these shell scripts. Do not edit or delete these files.

  TIP:   Before performing command-line procedures in a shell window, you must source siebenv.csh for a C shell or source siebenv.sh for a Bourne shell. Doing this refreshes the environment variables required to run commands.

• DBSRVR_ROOT is a path convention used in the Siebel Database Upgrade Guide. It is not an environment variable and is not defined in siebenv.csh or siebenv.sh.

  DBSRVR_ROOT is the absolute path to the Siebel Database Server files on the Siebel Server. When you install the Siebel Database Server, the installation script queries for the Siebel Server installation directory. The script then installs the Siebel Database Server files at the same level in a subdirectory called dbsrvr. For example, if $SIEBEL_ROOT is /usr/siebel/sba8x/siebsrvr, then DBSRVR_ROOT is /usr/siebel/sba8x/dbsrvr. In this guide, many examples use the path /usr/siebel and /usr/siebel/sba8x.

• Run UNIX scripts in a C or Korn shell. Do not run .ksh scripts in a Bourne shell.

Path Navigation

Procedural steps that ask you to navigate to a specified directory must be performed as follows:

• Windows: Open a Command Prompt window and use the cd command to make the specified directory the current directory. Do not use the Windows File Explorer to navigate to the directory. For help with the cd command, enter the word help in the Command Prompt window and press Enter.
• UNIX: In a shell window, make the specified directory the current directory.

Executing Commands

Procedural steps that ask you to execute a command must be performed as follows, unless specified otherwise:

• Windows: In a Command Prompt window, verify the current directory is correct and enter the command. Do not run the command by entering it in the Run window in the Start Menu.
• UNIX: In a shell window, verify the current directory is correct, source the siebenv script, then enter the command.

Because all versions of the UNIX operating system are case-sensitive, if you are running your Siebel Business Applications on UNIX, then treat all file names, directory names, path names, parameters, flags, and command-line commands as lowercase, unless you are instructed otherwise in the product.

If your deployment currently runs on Microsoft Windows, but you might switch to a UNIX environment or deploy UNIX servers in the future, then follow this same practice to avoid having to rename everything later.