IBM Smart Business Integration Points

 

All capitalized terms defined in the IBM Smart Business Marketing and Support Agreement (‘Agreement’) which are used in the IBM Smart Business Integration Points set forth herein without further definition shall have the meanings ascribed to them in the Agreement.

 

The following tables list the current enablement instrumentation areas in which Vendor can integrate Vendor Products to IBM Smart Business and identifies which integration points Vendor is required to comply with, including identification of the integration points Vendor must achieve through its Vendor Integration Code.

 

 

Vendor should comply with the required integration points which IBM may modify over time as the parties move forward with the integration of Vendor Software and newer versions of the Smart Business Software Pack.

 

 

V2.1 Integration Points for Vendor Products supported on SUSE Linux Enterprise Server, v11

Integration Points

Customer Life Cycle

Description

Marketplace Listing

Identify and
Evaluate

Vendor shall provide to IBM the information about Vendor Product and Vendor’s company, including useful information for customers investigating, evaluating, or shopping for Vendor Product and helps to position Vendor Product. Vendor shall enter this information into the IBM Smart Market using the IBM Smart Business Listing Package Tool.

REQUIRED

Sizing/Pricing

Vendor shall provide to IBM the Vendor Product configuration information describing the system resources the Vendor Software will require on the IBM Smart Cube system so that the Smart Market listing can recommend the proper sized system to customers for running a Vendor Product. Vendor shall enter this information into the IBM Smart Market by using the IBM Smart Business Listing Package Tool.

REQUIRED

Transaction/Proof Of
Entitlement (POE)

Acquire

Vendor shall use IBM Smart Business Sales and Licensing Portal to provide IBM information necessary for IBM to determine whether customer is entitled to Vendor Software.

REQUIRED

License Key

Vendor provides URL to allow customer to initiate license or entitlement activation. Vendor uses IBM Smart Business Sales and Licensing Portal to provide customers' product license keys to IBM . Vendor also provides a script that is executed on the IBM Smart Cube to install their license key. The license key will be transferred to the customers' IBM Smart Cubes and installed using the provided script.

NOT REQUIRED

Product

Download

Vendor shall upload Vendor Software which was successfully packaged with the IBM Smart Business Developers’ Kit into the IBM Smart Business Repository using the IBM Smart Business Listing Package Tool.

REQUIRED

Package Deployment

Install

Vendor Software including integration points and scripts must be successfully packaged with the IBM Smart Business Developers’ Kit.

REQUIRED

License Acceptance

Configure

Vendor shall ensure that Vendor Products display license agreement for Vendor Software and confirm customers’ acceptance of the agreement. Vendor Software must provide a set of translated license or terms of use agreements as text files.

REQUIRED

Application Details

Vendor shall provide to IBM basic information about the Vendor Software (product name, product version, icon used to identify the application, brief description for the application to be displayed in the IBM Smart Business Control Center and description for the Vendor Software to be displayed during installation). Prompt for or retrieve Vendor Software specific configuration information needed to finalize setup.

REQUIRED

Network Resources

Identify network resources (interfaces, ports, protocols, binding type) to support Vendor Software requirements so a Smart Cube can mitigate any conflicts.

NOT REQUIRED

Application Client Download

Operate

Package Vendor Software client code in the IBM Smart Business Developers' Kit for download to workstation.

REQUIRED for Rich Clients

Application Client Install

Provide an installation program for installation of Vendor Software client code on workstation.

REQUIRED for any client

Application Client Launch

Launch Vendor Software client code on workstation.

REQUIRED for any client

Problem Monitoring and Diagnostics

Monitor for problems and provide recommended actions that help customers with few or no technical skills identify and resolve or work around some common problems that might arise with Vendor Software. Using the IBM Smart Business Developers’ Kit, Vendor Software provides one or more of the following:

  • One or more manual checks that the administrator can perform on the server during a user reported problem investigation. Vendor Software provides a problem definition with one or more recommendations (text steps) and a special annotation to indicate that the diagnostic test should be added to the server checklist displayed in the control center to aid in troubleshooting a problem with the application.
  • One or more manual checks that the administrator can perform on the user’s workstation during a user reported problem investigation. Vendor Software provides a problem definition with one or more recommendations (text steps) and a special annotation to indicate that the diagnostic test should be added to the workstation checklist displayed in the control center to aid in troubleshooting a problem with the application.
  • One or more scripts that perform automated diagnostic tests on the server during a user reported problem investigation. Vendor Software provides a problem definition that points to an action file that has one script step for each target action to be executed. The script should return success or failure, and if failure, an error message. For any error messages returned, the Vendor Software should also include a problem definition that matches that error message and contains the action that will help the user “fix this problem”.
  • One or more problem definitions for an already monitored
  • resource (e.g. WebSphere Application Server Log)
  • One or more problem definitions for a custom log, and provide the description of monitored log profile information, a Generic Log Adapter (GLA) to describe format of each custom log file, and a symptom catalog with resolutions.

REQURIED

Problem Reporting

Define a list of configuration files, logs and error files to be passed to support engineers when reporting a problem.

REQURIED

Server Actions

Manage

Start, stop, restart, and get status of Vendor Software.

For Vendor Software running in IBM supplied containers (Domino, WebSphere Application Server, Apache), predefined server actions are provided by IBM Smart Business.

REQUIRED

Advanced Administration

Provide access to Web based advanced administration utilities provided by Vendor Software.

NOT REQUIRED

Fix Management

Using the IBM Smart Business Developers’ Kit, Vendor packages Error Corrections for its Vendor Software as an IBM Smart Business Fix Project. Vendor tests and validates these Error Correction IBM Smart Business Fix Projects, and then uploads and publishes them to the IBM Smart Business Repository.

REQUIRED

People Integration

 

Vendor specifies Vendor Software-specific user information to be gathered when enrolling a Person in the Vendor Software or to be modified when viewing a Person. Vendor Software subscribes to user events by providing a script for each available user event that will be invoked by the Application Integration framework when a user event occurs for a person enrolled in the Vendor Software. Available user events are: add, modify, get, remove, change password and reset password.

NOT REQUIRED

Remote Server Application

 

Vendor adds to the Vendor Software package a remote server application entry for each remote server application installer to be installed on a non-IBM Smart Cube system. Vendor will include platforms and operating system versions supported. It is the vendor’s responsibility to ensure that the customer has a valid license to the remote server application. When the Vendor's Software package is deployed in a Smart Cube, the remote server application is available for download by administrators. The Smart Cube administrator then downloads the remote server package to the non-Smart Cube system and launches the installation.

NOT REQUIRED

 

 

V2.1 Integration Points for Vendor Products supported on Windows 2008 Standard R2

 

 

Integration Point

Customer Life Cycle

Description

1.  Marketplace Listing

Identify and
Evaluate

Vendor shall provide to IBM the information about Vendor Product and Vendor’s company, including useful information for customers investigating, evaluating, or shopping for Vendor Product and helps to position Vendor Product. Vendor shall enter this information into the IBM Smart Market using the IBM Smart Business Listing Package Tool.

REQUIRED

2.  Sizing/Pricing

Vendor shall provide to IBM the Vendor Product configuration information describing the system resources the Vendor Software will require on the IBM Smart Cube system so that the Smart Market listing can recommend the proper sized system to customers for running a Vendor Product. Vendor shall enter this information into the IBM Smart Market by using the IBM Smart Business Listing Package Tool.

REQUIRED

3.  Transaction/Proof Of

Entitlement (POE)

Acquire

Vendor shall use IBM Smart Business Sales and Licensing Portal to provide IBM information necessary for IBM to determine whether customer is entitled to Vendor Software.

REQUIRED

4.  License Key

Vendor provides URL to allow customer to initiate license or entitlement activation. Vendor uses IBM Smart Business Sales and Licensing Portal to provide customers' product license keys to IBM . Vendor also provides a script that is executed on the IBM Smart Cube to install their license key. The license key will be transferred to the customers' IBM Smart Cubes and installed using the provided script.

NOT REQUIRED

5.  Product Download

Vendor shall upload Vendor Software which was successfully packaged with the IBM Smart Business Developers’ Kit into the IBM Smart Business Repository using the IBM Smart Business Listing Package Tool.

REQUIRED

6.  Package Deployment

Install

Vendor Software including integration points and scripts must be successfully packaged with the IBM Smart Business Developers’ Kit.

REQUIRED

7.   License Acceptance

Configure

Vendor shall ensure that Vendor Products display license agreement for Vendor Software and confirm customers’ acceptance of the agreement. Vendor Software must provide a set of translated license or terms of use agreements as text files.

REQUIRED

8.   Application Details

Vendor shall provide to IBM basic information about the Vendor Software (product name, product version, icon used to identify the application, brief description for the application to be displayed in the IBM Smart Business Control Center and description for the Vendor Software to be displayed during installation). Prompt for or retrieve Vendor Software specific configuration information needed to finalize setup.

REQUIRED

9.  Network Resources

Identify network resources (interfaces, ports, protocols, binding type) to support Vendor Software requirements so a Smart Cube can mitigate any conflicts.

NOT REQUIRED

10.  Application Client

D     Download 

 

 

Do

Operate

Package Vendor Software client code in the IBM Smart Business Developers' Kit for download to workstation.

REQUIRED for Rich Clients

 Application Client

 Install

 

Provide an installation program for installation of Vendor Software client code on workstation.

REQUIRED for any client

·1  Application Client

·L   Launch

Launch Vendor Software client code on workstation.

REQUIRED for any client

1. Problem Diagnostics

Di

Provide recommended actions that help customers with few or no technical skills identify and resolve or work around some common problems that might arise with Vendor Software. Using the IBM Smart Business Developers’ Kit, Vendor Software provides one or more of the following:

  • One or more manual checks that the administrator can perform on the server during a user reported problem investigation. Vendor Software provides a problem definition with one or more recommendations (text steps) and a special annotation to indicate that the diagnostic test should be added to the server checklist displayed in the control center to aid in troubleshooting a problem with the application.
  • One or more manual checks that the administrator can perform on the user’s workstation during a user reported problem investigation. Vendor Software provides a problem definition with one or more recommendations (text steps) and a special annotation to indicate that the diagnostic test should be added to the workstation checklist displayed in the control center to aid in troubleshooting a problem with the application.

 

REQUIRED

    Problem Reporting

 

None; intentionally left blank

·1  Server Actions

Manage

Start, stop, restart, and get status of Vendor Software.

For Vendor Software running in IBM supplied containers (Domino, WebSphere Application Server, Apache), predefined server actions are provided by IBM Smart Business.

REQUIRED

·1 Advanced

·Administration

Provide access to Web based advanced administration utilities provided by Vendor Software.

NOT REQUIRED

·1  Fix Management

· 

Vendor packages and delivers Error Corrections for its Vendor Software using the Vendors usual practices. This includes any fixes to integration scripts provided as part of the Vendor's application.

 

Using the IBM Smart Business Developers’ Kit, Vendor packages Error Corrections for the integration point information provided during packaging as an IBM Smart Business Fix Project. This includes corrections to the read me file, application details, etc. Vendor tests and validates these Error Corrections and then uploads and publishes them to the IBM Smart Business Repository.

REQUIRED

 

·1  People Integration

 

Vendor specifies Vendor Software-specific user information to be gathered when enrolling a Person in the Vendor Software or to be modified when viewing a Person. Vendor Software subscribes to user events by providing a script for each available user event that will be invoked by the Application Integration framework when a user event occurs for a person enrolled in the Vendor Software. Available user events are: add, modify, get, remove, change password and reset password.

NOT REQUIRED