My Oracle Support Banner

File Upload/Download Failing with SDK Program on SSL Enabled Agile Instance (Doc ID 2068696.1)

Last updated on JULY 02, 2021

Applies to:

Oracle Agile PLM Framework - Version and later
Information in this document applies to any platform.


When attempting to retrieve file attachment through custom program using Agile SDK (Agile API) the following error occurs.
Internal File Manager Locator URL, File Server URL, Application Server URL is configured to use HTTPS/SSL. File Manager Configuration page shows that File Manager Connection and Application Server Connection is successful. File Manager is not down, and when retrieving file from Web Client or Java Client, no issue occurs. Issue only occurs through SDK.

com.agile.webfs.components.common.RepositoryException: The preferred file server : https://{server_name}.{domain_name}/Filemgr/services/FileServer for current user is down. Please contact the system administrator.
at com.agile.webfs.client.IFSLocator.pingFileManager(
at com.agile.webfs.client.IFSLocator.getConnection(
at com.agile.api.pc.EJBLookup.createFileSession(
at com.agile.api.pc.attachment.IFSInputStream.createFileSession(
at com.agile.api.pc.attachment.IFSInputStream.(
at com.agile.api.pc.RowAttachment$GetFileAction.doSdkAction(
at com.agile.api.common.WebLogicAuthenticator.doAs(
at com.agile.api.common.Security.doAs(
at com.agile.api.common.Security.doAs(
at com.agile.api.pc.RowAttachment.getFile(
at com.mdw.px.agile.attachment.renderer.StoreFile.readNStoreFile(
at com.mdw.px.agile.attachment.buslogic.RetrieveAndProcess.processAttachmentTable(Retrieve

In the environment where wildcard certificate is used, below error can be seen:
<Warning> <Security> <BEA-090504> <Certificate chain received from {server_name}.{domain_name} - failed hostname verification check. Certificate contained *.{domain_name} but check expected {server_name}.{domain_name}>
com.agile.webfs.components.common.RepositoryException: Current user's preferred file server https://{server_name}.{domain_name}:{port}/Filemgr/services/FileServer Crash. Please contact the system administrator.

The issue can be reproduced at will with the following steps:

  1. Enable SSL on Agile Application Server and File Manager
  2. Startup Application server and File Manager
  3. Execute SDK program to do the file operation (upload file/get file)



To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.