Connector Administration Cockpit

Definition

The connector administration cockpit is the entry point for the administration of Embedded Search. It provides an overview of the available search object connectors and allows the system administrator to monitor their status and schedule indexing runs. You can also access further administration and monitoring tools as well as the modeler, which you can use to define your own search object connector models.

Use

You use the following URL to launch the administration cockpit:

http:// <host_name> : <port_number> /sap/es/cockpit

In this case, <Host name> stands for the SAP NetWeaver host and <Port number> stands for the port that you use to reach the SAP NetWeaver system.

Alternatively, you can launch transaction ESH_COCKPIT from the SAP system.

Structure

The administration cockpit displays all search object connectors filtered by status.

Figure 1: Administration Cockpit Structure

Filtering Connectors

You can filter the search object connectors listed in the connector overview by the following status values:

Value	Explanation
All	Lists all search object connectors irrespective of status.
Active	Lists all search object connectors that are active, that is, that can be used for searching. This status is set by default after completion of indexing.
Inactive	You define a search object connector as inactive to exclude it from the search function. This status applies for all search object connector types.
New	Lists all new search object connectors that have not been prepared.
Preparing	Lists all search object connectors for which the preparation is in process. During the preparation, the physical indexes and join indexes are created in the indexing layer.
Prepared	Lists all search object connectors for which the preparation has finished. The indexing can now be scheduled or started immediately for these search object connectors.
Scheduled for Update	Status of the search object connectors after you have chosen the Update function. This status is retained until the asynchronous scheduled background job for the update starts.
Scheduled for Deletion	Status of the search object connectors after you have chosen the Delete function. This status is retained until the asynchronous scheduled background job for deletion starts.
Is Being Deleted	Status of the search object connectors while they are being deleted.
Scheduled für Indexing	Lists all search object connectors for which indexing is scheduled.
Indexing	Lists all search object connectors for which indexing is in process.
With Errors	Lists all search object connectors with errors.
Not Defined	This status appears if the system cannot determine any other status.

Connector Overview Area

The connector overview contains the following information for the individual search object connectors:

Column	Explanation
Search Object Connector	Displays the name and ID of the individual search object connectors.
Search Provider	Shows the connectivity data for the connection to the search provider, for example, the RFC destination of the back-end system containing the business objects for which the search object connector was defined.
Changed	Specifies that the model used to created this search object connector has been changed in the modeler. To update the search object connector accordingly, select it and choose ActionsUpdate .
Searchable	Specifies whether or not the search object connector can be used for the search. In this context, you should note the relationships to the status of the search object connector: Status Inactive or Prepared : Not searchable Status With Errors after delta indexing: Already indexed objects are still searchable
Status	The current status of the search object connector.
Index ID	The index ID in the indexing layer (TREX) of Embedded Search.
Last Indexing	Date and time of the last indexing (initial indexing and index update).
Optimized	Number of files or business objects that have been processed and indexed.
With Errors	Number of search objects for which indexing was not completed because an error occurred.
In Process	Number of search objects in the queue that are still to be processed.

Connector Details Area

When you select a search object connector in the connector overview, the details of this connector appear here. This includes the scheduling data for the indexing runs, for example.

Tab Page	Description
General	Display detailled information about the search object connector or its nodes.
Scheduling	Display the time of the first scheduled indexing. If you have set up recurring indexing, the interval is also shown here. You can choose Delete Schedule to delete all scheduled indexing runs.
Job Log	You can see here the log information for the job that is assigned for the selected object. In the dropdown list, you can call up the logs for the available technical objects. The log information corresponds to the information that you can also call up for a specific job from the job overview in the Related Links section.
Categories	In addition to the categories specified in a model, you can create and manage other categories here. Note Note that categories created here are not maintained in the model. You cannot delete categories that originate from the model here. More information: Managing Search Categories

Control Bar

This section contains the pushbuttons for performing actions for the search object connector that is selected in the connector overview.

Note

You can choose more than one search object connector and thus perform an action on more than one search object connector at the same time. To do this, hold down the Ctrl key and select the required entries.

Actions are displayed as inactive if an action cannot be executed for the search object connector. In the case of multiple selection, all selected entries must support the chosen action. If an action is not possible for any one of the search object connectors, it appears as inactive. In such cases, correct your selection.

Pushbutton/Command	Function
Status Selection	Filters by the required status.
Update	Refreshes the list of search object connectors and their respective status.
Create	This takes you to a dialog box, with which you can create search object connectors from predefined models. You choose the required model from the required software component and choose Create Connector , then the system creates a new connector in the background. You should note that further search object connectors are implicitly created if fields in the response or requests of the search object connector being created are referenced by other search object connectors.
Delete	Deletes the selected search object connector. A message informs you whether the deletion process takes place in the background or not.
Actions	Lists the actions that are available for the selected search object connector. You can find a list of the actions in the table below.
System Settings	This pushbutton takes you to the following system settings: Maintain UI Technologies For more information, see Maintaining UI Technologies . Control Indexing in Real Time For more information, see Controlling Real-Time Indexing .
Edit Model	Takes you to the modeler, in which you can edit the selected search object connector.
Search and Analytics Modeler	The link takes you to the modeler, in which you can define your own search object connector models. More information: Search and Analytics Modeler

The following commands are available through the Actions pushbutton:

Action	Description
Activate	Activates the selected search object connector.
Deactivate	Deactivates the selected search object connector.
Update	Updates the selected search object connector so that it reflects the changes made to the underlying model. If an underlying model has been changed, the checkbox in the Changed column is activated for the search object connector in question. The update is processed in the background.
Reset	Resets the selected search object connector to its newly-created status. The preparation is triggered automatically.
Prepare Indexing	Starts the preparation of the search object connectors for which automatic preparation ended with errors.
Scheduling Indexing	Schedules indexing for the selected search object connectors.
Continue Indexing	Continues the indexing run at the point at which it was stopped due to an error. You can identify indexing runs with errors by filtering by search object connectors with the status `With Errors` . You can then trigger indexing for these runs again.
Consistency Check	You can use the consistency check to solve errors in search object connectors. Select the search object connectors that have an error status and start the consistency check. The system performs a sequence of tests to establish the cause of the error. You receive the check results with details of the individual tests. Read the error messages to receive more detailed information about the cause of the error. Example If no search request is defined for a search object connector, the system cannot perform a search and the consistency check reports an error. Define a search request to solve the error.