Enterprise Manager logo EM: Getting Started

Description

For an overview of the Enterprise Manager (EM) and instructions on launching the browser EM, see Enterprise Manager - Introduction. For the sake of simplicity, the steps below describe how to get started configuring a localhost BBjServices with a browser EM.

When prompted for an administrator username and password, enter a valid combination. The default administrator user is admin and default password is admin123. The browser image below shows a typical localhost display after logging in.

Toolbar

Button Function
Connects to selected configuration: Establishes a connection to the BBjServices running on the selected server using the specified configuration details. Enabled if the server selected in the Navigator is not currently connected.
Disconnects from selected configurations: Close the connection to the BBjServices running on the server that is currently selected in the EM Navigator. Enabled if the server selected in the Navigator is currently connected.
Add a new connection: Enter the information necessary to be able to create a new connection and then connect to that server. Always enabled.
Edit selected connection: Edit the information about the selected connection to a BBjServices server. Enabled if a server/connection is currently selected in the Navigator.
Remove selected connection(s): Delete the connection information for the selected server or servers. Enabled if one or more servers/connections are currently selected in the Navigator. With one or more connections selected, this dialog appears asking you to confirm the deletion:

The EM Navigator pane displays the options for managing the BBjServices running on “localhost”. In this image, BBj 26.10 is installed. The option tree is initially collapsed as shown above.

See the EM Navigator section below for information about each option.

Connect to a Remote BBjServices

If your enterprise has more than one BBjServices machine, you can manage multiple servers from a single Enterprise Manager. To have the EM list other servers along with localhost, simply add a connection to each remote BBjServices. To add a new connection, click Add a new connection at the top of the EM Navigator pane:

This opens an Add EM Connection dialog window:

  • Specify a name for the connection.
  • Specify the hostname and the Enterprise Manager port number there (usually 2002).
  • Click [OK].

Double-click the new connection (in this example, BBjServices Server A) to connect and manage that server:

Enter the username and password for that server. For the default administrator user and password, contact your system administrator or BASIS Technical Support at support@basis.cloud.

Click [OK]. Once you are successful, the connection will appear in the Browser Enterprise Manager each time you run it. You can connect to any BBjServices in the EM Navigator pane by double-clicking it.

To remove a connection from the list, select the connection and click at the top of the EM Navigator pane:

Menu (dropdown triangle next to “Remove selected connection(s)”): Show the options that are available for the currently selected server/connection. Always enabled, although the various menu items are enabled or disabled as appropriate based on the selection status.

The dropdown menu items offer the functionality described earlier for the corresponding toolbar buttons as well as the following menu items:

Shutdown BBjServices: Disconnect from the BBjServices running on the selected server after instructing it to shut down gracefully. Enabled if the server selected in the Navigator is currently connected and the user logged in there has permission for this action.

Shutdown To Admin Only Mode: Instruct the BBjServices running on the selected server to switch to “Admin Only” mode. This will shut down BBjServices and restart it where only the admin user can log in or issue commands (only the Admin Server, port 2002, is running). Enabled if the server selected in the Navigator is currently connected and the user logged in there has permission for this action.

Clear Caches/Unpin: Instructs the selected BBjServices server to open the Caches – localhost tab, where specific caches can be reviewed and cleared. Used for troubleshooting or recovering from configuration issues. Clearing caches may temporarily reduce performance until they are rebuilt. Enabled only when the server is connected and the user has the required permissions.

Dump JVM Threads: Instruct the BBjServices running on the selected server to generate a thread dump containing information about the threads and processes currently running. BBj writes the thread dump information to the Debug.log.[date].# log file. Enabled if the server selected in the Navigator is currently connected and the user logged in there has permission for this action.

Dump Heap: Instruct the BBjServices running on the selected server to perform a heap dump, which is useful for analyzing memory-related problems in the Java stack. The information is written to the <bbjhome>/log directory with a file name of: memoryDump<PID>.hprof

Dump Properties: Instruct the BBjServices running on the selected server to generate a list of all of the server-side properties and their values. The information is written to the <bbjhome>/log directory with a file name of BBjSystemDump.properties.

EM Navigator

For each connected server, the EM Navigator pane lists the available configuration settings organized into related groups: Support/Troubleshooting, BBjServices, Security, File System, Databases/SQL, and Web.

To expand a group and see its configuration entries, either click the small gray triangle to the left of the text or double-click that group. When you double-click a configuration entry, the EM will open a new window displaying that entry’s options. Below is a table listing the configuration entries by group, with a short description of each entry.

Support / Troubleshooting

  • Send Support Files - Send a troubleshooting report to BASIS support, or check on the progress of a previous report. Troubleshooting reports include log files and other files to help troubleshoot a problem.

    Note: Only do this when requested to do so by a BASIS team member.

BBjServices

  • Settings - Manage a number of BBjServices properties, and see the entries in the bbj.properties file.
  • Java Settings - Set Java Virtual Machine Settings.
  • Caches - Clear cache(s).
  • Metrics - Enable/Disable the metrics available at the determined Metrics Jetty Endpoint.
  • Licensing - Monitor information about licenses and the BLS Machine.
  • Processes - List of open processes.
  • Configuration History - Track, compare, and revert changes made to the BBjServices configuration.
  • Servers - List the BBj Servers such as Administration, Bridge, File System, and Web.
  • Log Files - Access all Log files.
  • Event Handlers - Manage system event handlers by specifying a BBj program and/or an email service.
  • Email Services - Configure outgoing SMTP clients to send emails from BBj or Java programs.
  • Scheduling - Manage schedules of tasks.
  • Memory Usage - View the graph of memory usage.

Security

  • Settings - Manage LDAP/Active Directory Authentication Settings, BBj Authentication Settings and General Authentication Settings.
  • 2-Factor Authentication - Set the 2FA method and enable which users it applies to.
  • Public/Private Keys - Generate and invalidate a public/private key pair.
  • Users - Manage user accounts and permissions.
  • Groups - Configure security groups.
  • Authentication Tokens - Manage active authentication tokens.

File System

  • Open Files - Displays a list of files that are currently open in BBjServices.
  • File Open Stats - View statistics gathered about all file OPEN calls.
  • Triggers - Create and manage triggers on data files and tables.
  • Replication Jobs - Create and manage replication jobs.
  • Online Copy Jobs - Create and manage online copy jobs.
  • Audit Logging Jobs - Create and manage audit logging jobs.
  • Asynchronous Trigger Jobs - Manage asynchronous trigger jobs, which execute specified BBj programs when write or remove operations occur on a file or a directory.
  • Document Indexes - Manage document indexes, which monitor directories for new or modified documents that match a set of filters.

Databases/SQL

  • Databases - Create and manage databases.
  • SQL/SELECT Connections - Create and manage SQL/SELECT connections.
  • Connection Pools - Create and manage connection pools.
  • Table Analysis Queue - Manage table analysis.
  • Index Builders - Monitor the progress or cancel the building of FULLTEXT indexes.

Web

  • App Deployment

    • Applications - Create and manage App Deployment applications for BBj (Desktop Deployment), BUI, and DWC.
    • Desktop App JREs - Configure the Java Runtime Environment (JRE) packages to include with Desktop Deployment applications.
    • Global Settings - Manage the application deployment settings.
    • Web App Resources - Manage the images and CSS files for application deployments.
    • Demos - Enable, disable, or edit the various application deployment demos.
  • SSL Configurations - Manage multiple SSL ports by configuring the SSL keystore(s).
  • Context Configuration - Configure contexts for the integrated Jetty web server.
  • SOAP Web Services Configuration - Configure SOAP web services.