Connecting to Your Net-Net ECB

By default, Oracle delivers the Oracle Enterprise Communications Broker (OECB) with no management IP address. You must set this address the first time you start the system. See the System Boot section.

You can connect to the OECB through a direct console connection or by creating a remote SSH session. Both methods provide a wide range of configuration, monitoring, and management options. IP-based management access, including SSH and the web GUI, requires an IP address for your management port. This address is specified in the ip address boot parameter.

Note:

The system displays the ip address parameter with different names, depending on the context:

The boot parameters wizard field name is also ip address.
The initial configuration wizard field name is Management interface ip address.
The ACLI show interfaces command field name is wancom0.

By default, SSH, SFTP, and web GUI connections to the OECB are enabled, but are only accessible by way of the ip address. You cannot use SSH, SFTP, or the web GUI until you set this address.

Depending on the platform, you may need to install the software installation upon first startup. You perform and monitor software installation by way of the console connection. The OECB requires most configuration by way of the web GUI. Procedures requiring the ACLI include:

Change default management interface IP address
Format hard drive
Set and change password
Set and change SIP Monitor and Trace filters

Local Connections and Time-outs

The ACLI is available through serial and SSH connections. Prior to software installation, you reach the ACLI through a local, serial connection.

When deploying the Oracle Enterprise Communications Broker (OECB) on a virtual machine, the virtual machine manager provides console access through a virtual serial connection. See documentation on your virtual machine to learn how to access the console. Working with the virtual machine console is the same as working on dedicated hardware.

When deploying on dedicated hardware, refer to the hardware documentation "Applicable Platforms" for instructions on connecting to the OECB console.

Plug one end of the cable into your terminal and the other end into the RJ-45 port, normally located on the back of your server.

To set up a console connection to the OECB:

Set the connection parameters for your terminal to the default boot settings:
- Baud rate: 115,200 bits/second
- Data bits: 8
- Parity: No
- Stop bit: 1
- Flow control: None
Use a serial cable to connect your PC to the OECB. Refer to your hardware documentation for the location of your server's serial port.
Power on the OECB.
The system boots. Upon successful boot, the system prompts you to log on.
```
Password:
```
Enter the appropriate password information when prompted to log into User mode of the ACLI. The default user mode password is acme.
The system displays the ACLI's user mode prompt :
```
ORACLE>
```
If necessary, enter Superuser mode by entering enable at the ACLI and pressing Enter.
The system ACLI prompts you for the superuser password:
```
ORACLE>enable
Password:
```
Enter the appropriate password information to log into Superuser mode of the ACLI. The default Superuser mode password is packet.
The system changes the ACLI prompt to:
```
ORACLE#
```
Proceed with system configuration or setup.

You can control the amount of time it takes for your console connection to time out by setting the console-timeout parameter in the system configuration. When your connection times out, the OECB displays the login sequence again and prompts you for your passwords. The default for this field is 0, which means that no time-out is being enforced.

SSH Connections and Time-outs

You can use SSH to connect to the Oracle Enterprise Communications Broker (OECB) and provision the OECB remotely through the management interface over IP. You configure the management interface IP during system setup, or by way of the OECB boot parameters.

The Oracle Enterprise Communications Broker can support up to five concurrent SSH and SFTP sessions. Note that only one user can carry out configuration tasks at a time.

To connect to the OECB, you need to know the IP address of its administrative interface (wancom0). You can find the OECB wancom0 IP address by using the ACLI to display the boot parameter value named IP Address.

You can manage the SSH connections to the OECB by setting certain ACLI parameters and by using certain commands:

To view the users who are currently logged into the system, use the show users command. You can see the ID, timestamp, connection source, and privilege level for active connections.
From Superuser mode in the ACLI, you can terminate the connections of other users to free up connections. Use the kill user command, with the corresponding connection ID.
When you reboot the OECB from an SSH session, you lose IP access and the connection.

Initiate SSH without Username and Password

Many SSH clients allow you to initiate an SSH connection without specifying a username. To initiate an SSH connection to the Oracle Enterprise Communications Broker (OECB) without specifying usernames and SSH user passwords:

Open your SSH client.
At the prompt in the SSH client, type the ssh command, a space, the IPv4 address of your Oracle Enterprise Communications Broker, and press Enter.

The SSH client prompts you for a password before connecting to the OECB. Enter the OECB User mode password. After authentication, an SSH session is initiated and you can continue with tasks in User mode or enable Superuser mode.

Note that some clients interpret SSH session initiation without a Username as a means of logging in with your system login name. The preceding procedure does not work for such clients.

Note:
You can also create connections to the OECB using additional Username and password options.

SSH with Username and Password

To initiate an SSH connection to the Oracle Enterprise Communications Broker with an SSH username and password:

In the ACLI at the Superuser prompt, type the ssh-password and press Enter. Enter the name of the user you want to establish. Then enter a password for that user when prompted. Passwords do not appear on your screen.
```
SYSTEM# ssh-password
SSH username [saved]: MJones
Enter new password: 95X-SD
Enter new password again: 95X-SD
```
Note:
After you configure ssh-password, the SSH login accepts the username and password you set, as well as the default SSH/SFTP usernames: User and admin.
Configure your SSH client to connect to your Oracle Enterprise Communications Broker’s management IPv4 address using the username you just created. The standard version of this command would be:
```
ssh -l MJones 10.0.1.57
```
Enter the SSH password you set in the ACLI.
```
MJones@10.0.2.54 password: 95X-SD
```
Enter your User password to work in User mode on the Oracle Enterprise Communications Broker. Enable Superuser mode and enter your password to work in Superuser mode.
An SSH session window opens and you can enter your password to use the ACLI.

GUI Access

To access theOracle Enterprise Communications Broker (OECB) for ongoing configuration and management, you must use the GUI. The system allows only a few user and provisioning procedures by way of the ACLI, such as setting the initial management IP address and changing GUI access passwords. The system does not allow disabling the GUI.

You can configure GUI access by way of HTTP or HTTPS at the configured management address, which you must set prior to attempting to log on.

When a user accesses the GUI, the OECB displays the log on screen. Upon successful log on, the system allows access to the System Administration and Service Provisioning controls.

Setting Your Login Banner

The Oracle Enterprise Communications Broker allows the user to create and edit the message displayed in the Login banner dialog, which appears upon successful login.

Click the Configuration tab.
The Oracle Enterprise Communications Broker displays the configuration panel.
Click the Wizards dropdown.
The Oracle Enterprise Communications Broker displays the widget menu panel.
Click the Set login banner link.
The Oracle Enterprise Communications Broker displays the Set login banner dialog, which includes a text box allowing the user to write a login message.
Type your banner text and click the Save button to set the banner.
The Oracle Enterprise Communications Broker sets the login banner.