The Web Gateway installation verification application

WebSphere® MQ File Transfer Edition provides a Web Gateway installation verification application. Use this application to view configuration values for your Web Gateway installation and test basic Web Gateway functions.

For information about how to access the installation verification application, see Verifying your Web Gateway installation. The application displays two types of information: configuration values for your Web Gateway installation, and the results of testing basic Web Gateway functions.

Configuration values

When you deploy the Web Gateway in an application server, you provide values for several initialization parameters. If you are using WebSphere Application Server Version 7.0, you provide these values using the Initialize parameters for servlets step in the administration console. If you are using WebSphere Application Server Community Edition, you set these values in the web.xml file.

Under the heading Web Gateway configuration information, the application lists the values for the following Web Gateway settings:
Servlet information
The name and version of the Web Gateway servlet that you have deployed.

Web Gateway name
The name of the Web Gateway that you deployed. You provided this value for the webGatewayName initialization parameter.

Context root
The context root that you defined for the Web Gateway application. In WebSphere Application Server Community Edition, this is the value of the <web:context-root> element in the WEB-INF/geronimo-web.xml file. In WebSphere Application Server Version 7.0, this value is set in the Map context roots for Web modules step when you install the Web Gateway application. The default value is wmqfte.

File space root directory
The root directory path for file spaces created and managed by the Web Gateway. You provided this value for the fileSpaceRoot initialization parameter.

Temporary file upload root directory
The directory path for the storage of temporary files related to Web Gateway-initiated transfers. You provided this value for the tempFileUploadDir initialization parameter.

Maximum size of temporary file upload directory
The maximum amount of space, in MB, that a user is allowed for storing temporary files related to Web Gateway-initiated transfers. You provided this value for the maxTempFileUploadSpace initialization parameter.

WMQFTE web agent name
The name of the WebSphere MQ File Transfer Edition agent that acts as the source for Web Gateway-initiated transfers. You provided this value for the agentName initialization parameter. This is the name that you specified for your web agent, using the -agentName parameter, when you ran the fteCreateWebAgent command.

Coordination queue manager name
The name of the coordination queue manager that is used by the Web Gateway for logging of transfer information. You provided this value for the coordinationQMgr initialization parameter.

Default MQMD user ID
The default WebSphere MQ Message Descriptor (MQMD) user ID to associate with a requesting user when there is no specific MQMD user ID defined for the user. You provided this value for the defaultMQMDUserID initialization parameter.

Application server information
The name and version of the application server hosting the Web Gateway application.

Web Gateway tests

Under the heading Results of Web Gateway tests, the installation verification application shows the results of several tests. If a test fails, a WebSphere MQ File Transfer Edition error code and message are displayed in the Information column. For more information about error messages, see Diagnostic messages. The following tests are listed:
Upload file to temporary storage

Tests the directory that is named in the Temporary file upload root directory field. The application tests that the directory exists and is readable and writeable, and that data written to the directory can be read back.

Upload file to file space storage

Tests the directory that is named in the File space root directory field. The application tests that the directory exists and is readable and writeable, and that data written to the directory can be read back.

Transfer history database access

Tests that the connection to the transfer history database exists. If you are using WebSphere Application Server Version 7, the application tests the data source that you configured when deploying the Web Gateway. For more information, see Preparing to deploy the Web Gateway with WebSphere Application Server Version 7.0. If you are using WebSphere Application Server Community Edition, the application tests the database pool that you configured when deploying the Web Gateway. For more information, see Preparing to deploy the Web Gateway with WebSphere Application Server Community Edition. The application checks that the database can be accessed using the credentials that you supplied when you set up the data source or database pool.

The application also checks that the required database tables exist. For more information, see Setting up a database for use with file spaces and Configuring the database logger for use with the Web Gateway.

The final part of the test checks that Java™ Persistence API (JPA) objects have been correctly defined.

File space information database access

Tests that the connection to the file space information database exists. If you are using WebSphere Application Server Version 7, the application tests the data source that you configured when deploying the Web Gateway. For more information, see Preparing to deploy the Web Gateway with WebSphere Application Server Version 7.0. If you are using WebSphere Application Server Community Edition, the application tests the database pool that you configured when deploying the Web Gateway. For more information, see Preparing to deploy the Web Gateway with WebSphere Application Server Community Edition. The application checks that the database can be accessed using the credentials that you supplied when you set up the data source or database pool.

The application also checks that the required database tables exist. For more information, see Setting up a database for use with file spaces and Configuring the database logger for use with the Web Gateway.

The final part of the test checks that Java Persistence API (JPA) objects have been correctly defined.


Concept Concept

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/web_ivt.htm