Resolution

There are some things that may make application development easier, this is a hub article for such tips and tricks.

1. Not enough information on actions/errors or changing UI files on filesystem does not have effect, server serves cached pages:

   Enable 'APS development mode' in System > Settings > Core > System Properties in OA PCP.

   • find additional information in main log /var/log/poa.debug.log for OA 5.5 version, /var/log/poa.log for OA 6.0 onwards
   • find JSON-formatted requests sent to endpoints in /tmp
   • develop custom UI for packages on file-system, this option disables server-side caching

2. Browser session expired too quickly:

   OA 5.5

   Change session timeout for frequently used accounts (admin, main account used for testing) in System > Users > [choose user] > Session Timeout

   OA 6.x

   Change session timeout for all accounts in System > Settings > System Properties > User session timeout (minutes)

3. Too much time is spent on endpoint configuration after each sandbox reinstallation:

   Set up endpoint automatically using the automatic endpoint configuration script.

4. Too much time is spent on 'Introducing changes - Packaging - Uploading - Testing' cycle:

   • files in ui/ folder can be edited on management node
   • files in scripts/ folder can be edited on endpoint server

If it's needed to change navigation or schema for services application should be re-packaged.

1. Need to locate ui folder to edit the view directly on filesystem:

   • If you know application name, version and release:

     psql -t -Uplesk -h`hostname` -c "select content_root_uri from aps_package where name = 'NAME' and version = 'VERSION' and release = 'RELEASE'"
     

     Name, version and release can be found in provider's panel in Services > Applications

   • If you know package uid

     Package id is seen in web debugger in any request header, check Referer:

     Referer http://sandbox.apsdemo.ru:8080/aps/2/packages/PACKAGE_UID/ui/servers.htm

     Get the path to package by running following commands in shell on OA core:

     OA 5.5

     # psql -t -Uplesk -h`hostname` -c "select content_root_uri from aps_package where registry_object_id in (select id from aps_registry_object where uid = 'PACKAGE_UID')"
     

     OA 6.x

     # psql -t -Uplesk -h`hostname` -c "select content_root_uri from aps_package where id in (select package_id from aps_application where uid = 'PACKAGE_UID')"
     

     Note that APS development mode (see point 1 above) must be enabled if you wish to edit your custom UI directly on file system, otherwise you will have to restart OA UI for changes to take effect.

Internal content