Expose resources to public

[Mirek]

Hi Guys,

generally speaking since FB 15 (not sure which version, probably 15.0) there have been some changes implemented to the /web folder, i.e. all the resources like css and js file are no longer taken from the /web/public folder but from the proper service folder under /web/work (like jetty-0.0.0.0-{PORT}-funnelback-publicui.war-...).

I would like to expose some resources to public (reports, CSV) and also allow the scripts (cgi) to be executed from the external sources (Magento) on FB >15. The solution works fine on 14.2 and my question is what would be the best way to achieve similar behaviour on >15.

We've noticed that on FB 15 there is a lack (probably intended) of one file - search-classic.xml which previously was present under /web/conf/contexts-http. That config file sets some kind of alias that can be reached, among the other things:

<Set name="contextPath">/search</Set>
<Set name="resourceBase"><SystemProperty name="funnelback.installdir"/>/web/public</Set>

Recreating that file on FB 15 under /web/conf/contexts-public, creating /public directory under /web and restarting Jetty basically helps but I am wondering if removing the previous concept was intended is there any other way of doing that so it can suit to how the FB 15 works with public resources?

Is putting all needed resources in the proper service folder under /work (/work/{service}/webapp/) in the same way as css and js files is a good idea?
Where can I find or set the Jetty settings to allow the particular folder to be exposed (in the same way it's done for /resources-global folder)?

Thanks,
Mirek

[plevan]

Hi Mirek,

Funnelback 15 deprecated the Classic UI which provided access to the /web/public path.

We would recommend that any web resources such as images and CSS/JS files are stored within a collection's web resources folder. This keeps all of the configuration for a collection together. This makes the server management easier because collection files are moved together and you are not left with orphan files once a collection is deleted. See: https://docs.funnelback.com/15.10/more/extra/web_resources_folder.html

Files like this within the collection's web resources folder can be accessed using a collection-relative path:

http://yourserver/s/resources/collectionname/profilename/yourfile.txt

The other shared resources that used to be stored in /web/public are now accessed using the global-resources path /s/resources-global/

e.g.

http://yourserver/s/resources-global/thirdparty/bootstrap-3.0.0/css/bootstrap.min.css

However anything related to the Classic UI has been removed.

I would recommend not trying to alter the Jetty configuration because this is likely to get overwritten if you upgrade the system.

I realise this doesn't fully answer your question and some of the other guys might chime in with additional info, but I hope it at least gives you some context.

[gtran]

Hi Marek,

I second Peter's comment on having resources stored with collections when possible. Files and resources stored elsewhere is not part of our designs and therefore could be lost or made non-functional during upgrades.

If you have no other options but to setup a new resource folder, you can try and use the following:

Under

$SEARCH_HOME/web/conf/contexts-https
$SEARCH_HOME/web/conf/contexts-http

Create a file something.xml and add this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure class="org.eclipse.jetty.server.handler.ContextHandler">
  <Set name="contextPath">your/url/path/</Set>
  <Set name="handler">
    <New class="org.eclipse.jetty.server.handler.ResourceHandler">
      <Set name="resourceBase"><SystemProperty name="funnelback.installdir" />your/directory/path/to/resources</Set>
      <Set name="directoriesListed">false</Set>
    </New>
  </Set>
</Configure>

e.g. The following setups a resource folder under https://SERVER/stencils/resources which points to resources under $SEARCH_HOME/share/stencils/resources

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure class="org.eclipse.jetty.server.handler.ContextHandler">
  <Set name="contextPath">/stencils/resources</Set>
  <Set name="handler">
    <New class="org.eclipse.jetty.server.handler.ResourceHandler">
      <Set name="resourceBase"><SystemProperty name="funnelback.installdir" />/share/stencils/resources</Set>
      <Set name="directoriesListed">false</Set>
    </New>
  </Set>
</Configure>