Connecting to Your Net-Net ECB

Connecting to The Oracle Enterprise Communications Broker

By default, Oracle delivers the Oracle Enterprise Communications Broker (ECB) 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 ECB 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 field name is IP Address.
The initial configuration wancom0 address field name is Management Interface IP Address.
The ACLI Show Interfaces command field name is wancom0.

By default, Oracle enables SSH, SFTP, and web GUI connections to the ECB. The connections are only accessible by way of the IP Address. You cannot use SSH, SFTP, or the web GUI until you set the IP address.

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

Change the default management interface IP address.
Format the hard drive.
Set and change the password.
Set and change the 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 (ECB) on a virtual machine, the virtual machine manager provides console access through a virtual serial connection. See the documentation for 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 "Applicable Platforms" in the hardware documentation for instructions on connecting to the ECB console.

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

To set up a console connection to the ECB:

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
Connect your PC to the ECB with a serial cable. Refer to your hardware documentation for the location of your server's serial port.
Power on the ECB.
The system boots. Upon successful boot, the system prompts you to log on.
```
Password:
```
Enter acme when prompted to log into User mode of the ACLI.
The system displays the ACLI's user mode prompt :
```
ORACLE>
```
If necessary, enter Superuser mode by typing enable at the ACLI prompt, and press Enter.
The system ACLI prompts you for the superuser password:
```
ORACLE>enable
Password:
```
Enter packet to log into Superuser mode of the ACLI.
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. Default: 0, which means no time out enforcement. When your connection times out, the ECB displays the login sequence again and prompts you for the passwords.

SSH Connections and Time-outs

You can use SSH to connect to the Oracle Enterprise Communications Broker (ECB) and provision the ECB remotely through the management interface over IP. You configure the management interface IP during system setup, or by way of the ECB 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 ECB, you need to know the IP address of its administrative interface (wancom0). You can find the ECB wancom0 IP address by using the ACLI to display the boot parameter value named IP Address.

You can manage the SSH connections to the ECB 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 ECB 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 (ECB) 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 ECB. Enter the ECB 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 ECB 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 (ECB) 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 ECB 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 System tab.
The Oracle Enterprise Communications Broker displays the system panel.
Open the System Operations Link.
The Oracle Enterprise Communications Broker lists the Systems Operations commands.
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 save.
The Oracle Enterprise Communications Broker sets the login banner.