# Create a New Database

You can create a new database in the IDOL Content component by using one of the following methods:

- Send a `DRECREATEDBASE` index action to Content.

- Add a database to the IDOL Content component configuration file.

- Create a new database in IDOL Admin.

NOTE: The database name must not contain the following characters, which are syntax characters in other parameters that use database names:

- ampersand (&)
- plus sign (+)
- percent (%)
- comma (,)

In addition, Micro Focus strongly recommends that you do not use white space characters (including \t, \r, \n, and so on) in your database names.

## Send a DRECREATEDBASE Index Action

To create a new database by this method, send a `DRECREATEDBASE` action (case sensitive) from your Web browser:

    http://ContentHost:indexPort/DRECREATEDBASE?DREDbName=databaseName

where:

`ContentHost` | is the IP address or host name of the machine on which the IDOL Content component is installed.
`indexPort` | is the IDOL Content component index port (specified as `IndexPort` in the `[Server]` section of the IDOL Content component configuration file).
`databaseName` | is the name of the database that you want to create.

For example:

    http://12.3.4.56:20001/DRECREATEDBASE?DREDbName=Archive

This action uses port `20001` to create a new database named `Archive` on the IDOL Content component on the machine with the IP address `12.3.4.56`.

NOTE: This action does not complete if the configuration file is read-only.

For information about other available parameters, refer to the IDOL Server Reference.

## Add a Database to the IDOL Content component Configuration File

Use the following procedure to add a database to the IDOL Content component configuration file.

To add a new database to the IDOL Content component configuration file

1. Open the IDOL Content component configuration file in a text editor.

2. Find the `[Databases]` section. This section contains the `NumDBs` setting, which indicates how many databases Content currently contains. It also contains a section for each of these databases, with settings that apply to them. The names of the individual database sections use the format `DatabaseN`, where `N` numbers the databases in consecutive order, starting from 0 (zero).

   For example:

       [Databases]
       NumDBs=2

       [Database0]
       Name=News

       [Database1]
       Name=Archive

3. Increase the `NumDBs` setting by one.

   For example:

       [Databases]
       NumDBs=3

4. Create a section for the new database. The name of the section must use the format `DatabaseN`, where `N` numbers the databases in consecutive order, starting from 0 (zero).

   Use the `Name` parameter to specify a name for your new database.

   For example:

       [Databases]
       NumDBs=3

       [Database0]
       Name=News

       [Database1]
       Name=Archive

       [Database2]
       Name=myNewDatabase

5. Add any other optional parameters for the database. For more information, refer to the IDOL Server Reference.

6. Save and close the configuration file.

7. Restart the IDOL Content component for your changes to take effect.

## Create a new database in IDOL Admin

You can add a new database for the Content or Agentstore components, or IDOL Proxy, from the Databases page in the Control section of the IDOL Admin interface.

To add a new database to the IDOL Content component configuration file

1. Click + Add New Database.The Add New Database dialog box opens.
2. In the Database Name box, type a name for the database.
3. Select the Internal check box if you want the database to be internal, and therefore hidden.
4. Select the Read Only check box if you want to prevent documents being added to the database.
5. Select a priority for the index action. This determines how IDOL Server queues the action.

6. Click Create.

Related Topics

- Display Online Help

_FT_HTML5_bannerTitle.htm