Jump to: navigation, search

Difference between revisions of "WebService Diagnosis"

(→‎Diagnosis)
(→‎Diagnosis)
Line 44: Line 44:
  
 
==== {{UBIK}} Content Service ====
 
==== {{UBIK}} Content Service ====
 +
 +
{| class="wikitable sortable"
 +
|-
 +
! Test !! Type !! Description
 +
|-
 +
| rowspan="3" width="200" | Try to find the service end point|| Error || The service cannot be reached: Possible reason is an error in the web.config, which cannot be parsed. An other reason can be a faulty configuration of the service in IIS.
 +
|-
 +
| Warning || The service end point provides a non-secure connection ("http://"). A connection without transport security should only be used for testing or in internal networks in a trusted enviroment only. This is generally not recommended for a productive environment.
 +
|-
 +
| Warning || The service endpoint provides a secure connection ("https://") but has issues with the certificate provided: e.g. expired validity, non-trusted root authority etc. This means, a connection to the service will still be possible but it is not recommended to use in a productive environment.
 +
|-
 +
| Fetch a token || Error || The session management service is not configured to testing mode or does not have a valid test login configured in the {{UBIK}} database
 +
|-
 +
| Verify token || Error || The fetched token is not recognized as a valid token to be used with the content service. A possible reason is that the session management has a different database connection configured.
 +
|-
 +
| Verify if token gets invalid || Warning || The fetched token is always valid. The reason can be that the setting "TokenRestrictive" is switched off which is not recommended for productive use.
 +
|}
 +
 +
==== {{UBIK}} Push Service ====
  
  
Line 56: Line 75:
 
| Warning || see the section in the Session Management tests
 
| Warning || see the section in the Session Management tests
 
|-
 
|-
−
| Check database connection || Error || Database cannot be reached. Possible reason can be a faulty database connection string or the used database server cannot be reached or is blocked by the network configuration.
+
| Add push data || Error || Adding push data failed. The reason could be a miscofigured service access point for the push service.
 
|-
 
|-
−
| Upload a file || Error || The configured target file system in the database settings is not set correctly to a folder allowing to write data. The reason can be that the user running the {{UBIK}} web service does not have read/write access to the configured target folder.
+
| Fetch push data || Error || No push data received. If this error occurs even if adding the push data worked, the reason could be that the cached push data has been lost because the service had to be restarted or persisting the data in the background failed.
 
|-
 
|-
−
| Download a file || Error || The uploaded file (uploaded in the previous test) cannot be downloaded. Possible reasons could be a timeout which is set too restrictive to download the data in time.
+
| Reset push data || Error || see description of the possible error(s) described for "Fetch push data".
−
|-
+
−
| Write logs || Error || The log cannot be written. Possible reason is that the configured log folders do not exist or the user running the web service has no read/write access to the logging folder.
+
−
|-
+
−
| Check rights structure || Error || At least one of the configured target directories used to store data (e.g. uploaded photos) does not have the required read/write rights. See the details if there are issues with one of the configured folders.
+
 
|}
 
|}
−
 
−
==== {{UBIK}} Push Service ====
 
−
 
−
* Try to find the service end point
 
−
** (see the same section in the session management tests above)
 
−
* Add push data
 
−
** Error: Adding push data failed. The reason could be a miscofigured service access point for the push service.
 
−
* Fetch push data
 
−
** Error: No push data received. If this error occurs even if adding the push data worked, the reason could be that the cached push data has been lost because the service had to be restarted or persisting the data in the background failed.
 
−
* Reset push data
 
−
** Error: see description of the possible error(s) described for "Fetch push data".
 
  
 
== See also ==
 
== See also ==

Revision as of 10:36, 30 April 2015

WebService Diagnosis
WebService Diagnosis

The web service can be tested using the diagnosis function, which can run a diagnosis on the configured UBIK® web service to show possible problems and errors. Once the results are generated, they are presented via the web browser page.

Start Diagnosis

The diagnosis page can be accessed by adding "/Diag" to UBIK® web service path. For example, if the web service path is "https://myserver:777/UBIK/DEMO/UBIKContent.svc" the diagnosis can be run by entering "https://myserver:777/UBIK/DEMO/Diag" into the web browsers address bar.

Result Types

Icon Type Content
IC WebService Diagnosis Error.png Error The result of the diagnosis shows an error preventing the service from running as expected
IC WebService Diagnosis Warning.png Warning The result of the diagnosis showed that there is an issue the user has to be aware of (e.g. configuring an insecure service end point)
IC WebService Diagnosis Ok.png Message The diagnosis showed that the tested part runs without problems
IC WebService Diagnosis undefined.png Message The result of the test is not defined

Diagnosis

In the header section at the top, links to the available and connected services (Content, Session Management, and Push service) are shown. These can also be tested by the user by clicking onto the links manually, but the connections will also be tested automatically once the test runs.

The following tests are executed to check the functionality of the web services. The details of each test run can be shown by clicking on the "Details..." link in the results list.

Session Management

Test Type Description
Try to find the service end point Error The service cannot be reached: Possible reason is an error in the web.config, which cannot be parsed. An other reason can be a faulty configuration of the service in IIS.
Warning The service end point provides a non-secure connection ("http://"). A connection without transport security should only be used for testing or in internal networks in a trusted enviroment only. This is generally not recommended for a productive environment.
Warning The service endpoint provides a secure connection ("https://") but has issues with the certificate provided: e.g. expired validity, non-trusted root authority etc. This means, a connection to the service will still be possible but it is not recommended to use in a productive environment.
Fetch a token Error The session management service is not configured to testing mode or does not have a valid test login configured in the UBIK® database
Verify token Error The fetched token is not recognized as a valid token to be used with the content service. A possible reason is that the session management has a different database connection configured.
Verify if token gets invalid Warning The fetched token is always valid. The reason can be that the setting "TokenRestrictive" is switched off which is not recommended for productive use.

UBIK® Content Service

Test Type Description
Try to find the service end point Error The service cannot be reached: Possible reason is an error in the web.config, which cannot be parsed. An other reason can be a faulty configuration of the service in IIS.
Warning The service end point provides a non-secure connection ("http://"). A connection without transport security should only be used for testing or in internal networks in a trusted enviroment only. This is generally not recommended for a productive environment.
Warning The service endpoint provides a secure connection ("https://") but has issues with the certificate provided: e.g. expired validity, non-trusted root authority etc. This means, a connection to the service will still be possible but it is not recommended to use in a productive environment.
Fetch a token Error The session management service is not configured to testing mode or does not have a valid test login configured in the UBIK® database
Verify token Error The fetched token is not recognized as a valid token to be used with the content service. A possible reason is that the session management has a different database connection configured.
Verify if token gets invalid Warning The fetched token is always valid. The reason can be that the setting "TokenRestrictive" is switched off which is not recommended for productive use.

UBIK® Push Service

Test Type Description
Try to find the service end point Error see the section in the Session Management tests
Warning see the section in the Session Management tests
Warning see the section in the Session Management tests
Add push data Error Adding push data failed. The reason could be a miscofigured service access point for the push service.
Fetch push data Error No push data received. If this error occurs even if adding the push data worked, the reason could be that the cached push data has been lost because the service had to be restarted or persisting the data in the background failed.
Reset push data Error see description of the possible error(s) described for "Fetch push data".

See also

Retrieved from "https://wiki.augmensys.com/index.php?title=WebService_Diagnosis&oldid=14386"