Cloud Software Group, Inc. EBX®
Documentation > Administration Guide > Installation & configuration
Navigation mode Documentation > Administration Guide > Installation & configuration

# Initialization and first-launch assistant

Deliverables can be found on TIBCO eDelivery (an account is mandatory in order to access eDelivery, please contact the support team to request one).

The TIBCO EBX® Configuration Assistant helps with the initial configuration of the EBX® repository. If EBX® does not have a repository installed upon startup and if the automatic installation is not enabled, the configuration assistant is launched automatically.

Before starting the configuration of the repository, make sure that EBX® is correctly deployed on the application server. See Jakarta EE deployment.

##### Note

The EBX® main configuration file must also be properly configured. See TIBCO EBX® main configuration file.

## Configuration steps

The EBX® configuration assistant guides you through the following steps:

1. Validating the license agreement.

2. Configuring the repository.

3. Defining users in the default user and roles directory (if a custom directory is not defined).

4. Validating the information entered.

5. Installing the EBX® repository.

### Validating the license agreement

In order to proceed with the configuration, you must read and accept the product license agreement.

### Configuring the repository

This page displays some of the properties defined in the EBX® main configuration file. You also define several basic properties of the repository in this step.

Id of the repository (`repositoryId`) | Must uniquely identify the repository (in the scope of the enterprise). The identifier is 48 bits (6 bytes) long and is usually represented as 12 hexadecimal digits. This information is used for generating the Universally Unique Identifiers (UUIDs) of entities created in the repository, and also of transactions logged in the history. This identifier acts as the "UUID node", as specified by RFC 4122.
Repository label | Defines a user-friendly label that indicates the purpose and context of the repository.

##### See also

- TIBCO EBX® main configuration file

### Defining users in the default directory

If a custom user and roles directory is not defined in the EBX® main configuration file, the configuration assistant allows to define default users for the default user and roles directory.

An administrator user must be defined. You may optionally create a second user.

##### See also

- Users and roles directory

### Validating the information entered

Before proceeding with the installation of the repository, you can review the configuration of the repository and the information entered on the 'Configuration Summary' page. If you need to modify information, you can return to the previous pages using the configuration assistant < Back button.

Once you have verified the configuration, click the button Install the repository > to proceed with the installation.

### Installing the EBX® repository

The repository installation is performed using the provided information. When the installation is complete, you are redirected to the repository login page.

Documentation > Administration Guide > Installation & configuration