Entering content frame

Procedure documentation Creating a Database Instance Locate the document in its SAP Library structure

Use

You create a new database instance on a local or remote server. All the kernel variants (fast, quick und slow) are created. At the same time, you define the first DBM operator for this database instance.

If several versions of the database software are available on the database server, you have to specify the path to the one you want to assign to this database instance. To do so, use the option -R (installation directory of the database software) when you call the Database Manager CLI.

Prerequisites

You have the authorizations of an operating system user for the server on which the database instance is to be created.

As of version 7.5, to create a database instance on UNIX, you must be logged on as operating system user root, sdb, or as a member of the sdba operating system user group (see UNIX: Special Operating System Users and User Groups).

To create a database instance on a remote server running Microsoft Windows, you must also have administrator authorizations for the database server and the log on as batch job authorization. For information about administrating operating system users, see your operating system documentation.

Syntax

db_create [-a|-auto] <database_name> <dbm_user>,<dbm_user_password> [<os_user>,< os_user_password>]

-a | -auto

If you use this option, under Microsoft Windows NT the service entry Start-up-type in the Control Panel is set to automatic.

This parameter is ignored on UNIX operating systems.

<database_name>

Name of the database instance

Note the Conventions for Database Names. The database system automatically converts the database name into upper-case letters.

<dbm_user>

First Database Manager user (DBM operator)

Note the Conventions for User Names and Passwords. The database system automatically converts the user name into upper-case letters.

<dbm_user_password>

The DBM operator’s password.

The database system automatically converts the password into upper-case letters.

<os_user>

Operating system user

If you want to create the database instance on a remote server, you must also specify the operating system user for this server. If the logon to the operating system fails, the database instance cannot be installed.

<os_user_password>

The operating system user’s password

Note

After the new database instance has been created, the first DBM user (DBM operator) is initially the only person who can access the database instance. He or she can carry out administration tasks and create further DBM operators and database users.

For creating further DBM operators, see Creating DBM Operators.

For creating database users, see Executing an SQL Statement.

Example

On Microsoft Windows:

Logging on to the Database Manager CLI, creating a local database instance with the name HOTELDB, defining the first DBM operator DBM with the password DBM:
dbmcli db_create HOTELDB DBM,DBM

Logging on to the Database Manager CLI, creating a local database instance with the name HOTELDB using the software stored under C:\Program Files\SDB\7500, defining the first DBM operator DBM with the password DBM:

dbmcli -R "C:\Program Files\SDB\7500" db_create HOTELDB DBM,DBM

Logging on to the Database Manager CLI, creating a database instance with the name HOTELDB on the remote server GENUA, defining the first DBM operator DBM with the password DBM, logging on as operating system user ANNA with the password BLACK to the remote server:
dbmcli –n GENUA db_create HOTELDB DBM,DBM ANNA,BLACK

On UNIX:

Logging on to the Database Manager CLI, creating a local database instance with the name HOTELDB, defining the first DBM operator DBM with the password DBM, suppressing identification of the operating system user with the option –s

dbmcli -s db_create HOTELDB DBM,DBM

Reply

When the command has been executed successfully, the system displays an OK message.

In the event of errors, see Reply Format.

 

Example of How to Create a New Database Instance (db_create Command)

 

Leaving content frame