Troubleshoot the user interface

Copilot server running but cannot connect to UI

After a successful installation you can start the Copilot server, but cannot connect to the user interface. Check the following:

Check task manage and verify that the copilot "copxxx" processes are running (as shown below on a Windows platform). For example, Coprestw.* must be running.

In the Transfer CFT installation, access the <install_directory>/runtime/run folder > and check the following files for errors or failed steps:

  • copmsg.out file
  • copui.trc file

Type of messages can include:

Certificate issues:

copsrestw[10986] CFT.REST.API [0] TRACE From restsslw_get_config_from_uconf (restsslw.c:457)

copsrestw[10986] CFT.REST.API [0] * Error: copilot.ssl.SslKeyFile is not set

copsrestw[10986] CFT.REST.APITCP[0] TRACE From rest_worker_server_grab_cb_dispatch (restwrk.c:2163)

copsrestw[10986] CFT.REST.APITCP[0] * Warning could not get Secure Configuration. Please check CG registration or copilot.ssl.* uconf parameters

Check:

Check for incorrect certificate.

If using a certificate that requires a private key, ensure that you have provided .

Incorrect path or name:

00000007 copsrestw[11468] CFT.REST.API [0] * Can't parse Certificate file /home/cftqa64/CFT/CFTQAuser.p12

00000008 copsrestw[11468] CFT.REST.API [0] * ===> Failed to open certificate file: fname=/home/cftqa64/CFT/CFTQAuser.p12, size=0, errno=2.

00000009 copsrestw[11468] CFT.REST.APITCP[0] TRACE From rest_worker_server_grab_cb_dispatch (restwrk.c:2163)

00000010 copsrestw[11468] CFT.REST.APITCP[0] * Warning could not get Secure Configuration. Please check CG registration or copilot.ssl.* uconf parameters

Check:

An error in the name or path to the certificate (in UNIX also check for case sensitivity).

Password issues:

00000006 copsrestw[12013] CFT.REST.API [0] TRACE From restsslw_get_config_from_uconf (restsslw.c:396)

00000007 copsrestw[12013] CFT.REST.API [0] * Can't parse Certificate file /home/cftqa64/CFT/CFTQAUSER.p12

00000008 copsrestw[12013] CFT.REST.API [0] * ===> PKCS12 parse error: error:23076071:PKCS12 routines:PKCS12_parse:mac verify failure.

00000009 copsrestw[12013] CFT.REST.APITCP[0] TRACE From rest_worker_server_grab_cb_dispatch (restwrk.c:2163)

00000010 copsrestw[12013] CFT.REST.APITCP[0] * Warning could not get Secure Configuration. Please check CG registration or copilot.ssl.* uconf pa

Check that the password is correct for the used certificate.

Certificate has expired:

00000006 copsrestw[14805] CFT.REST.API [0] TRACE From restsslw_get_config_from_uconf (restsslw.c:396)

00000007 copsrestw[14805] CFT.REST.API [0] * Can't parse Certificate file /home/cftqa64/cft36/runtime/XPP_Sample_User1.p12

+ 2020/06/11 18:09:19.048918 00000008 copsrestw[14805] CFT.REST.API [0] * ===> PKCS12 parse error: error:23076071:PKCS12 routines:PKCS12_parse:mac verify failure.

00000009 copsrestw[14805] CFT.REST.APITCP[0] TRACE From rest_worker_server_grab_cb_dispatch (restwrk.c:2163)

00000010 copsrestw[14805] CFT.REST.APITCP[0] * Warning could not get Secure Configuration. Please check CG registration or copilot.ssl.* uconf pa

Check the expiration date and replace as needed.

Other issues

If the sends an 404 not found reply when connecting to the URL, please check that the cftui alias parameters are set in UCONF as follows:

  • copilot.http.aliases.cftui.alias=/cft/ui
  • copilot.http.aliases.cftui.path=<installation_path>/Transfer_CFT/home/distrib/cftui

Check:

  • If the server sends an invalid credential reply, check that the UCONF copilot.restapi.authentication_method and am.type parameters are consistent with the REST API server authentication method diagram. Please see Authentication methods
  • If the server sends an insufficient rights reply, this indicates that access management is enabled (either Central Governance or internal AM) and that you do not have the CONNECT privilege on the SERVICE:UI resource.
  • If you are using the predefined filters and there seem to be missing transfers or messages, it is possible that they are not displaying due to a difference in time between the client and the server. This is because the predefined filters use the client time and not the server time.

 

Related Links