Getting and Using Resources From a Real Path
Not only can you use the published resources described in section Publishing Resources, but also those resources obtained from a real path. The difference between real path resources and published resources lies in the way of managing them. Published resources are managed in Logi JReport Server. Real path resources are managed in both the server and the operating system. In the server, when accessing a resource node which is linked with a real path, the local resources in the real path are loaded to the node and displayed together with other server resources (including the published resources) in the node. You cannot delete the real path resources directly from the server UI, but can only achieve it by removing the resources from the local disk.
To use real path resources, you should specify a real path for a virtual folder. You can then add or remove resources into or from Logi JReport Server by adding or removing them into or from the real path. Also, if you do not want to publish resources to the server by using the publish feature, you can set a real path instead.
The following example uses the resources in the folder Public Reports obtained from the real path:
- On the Logi JReport Administration page, select Configuration on the system toolbar, then select Advanced from the drop-down menu.
- On the Configuration - Advanced page, check the Enable Resources from Real Paths option, save the changes and then restart the server.
- On the Logi JReport Console page, open the Properties dialog of the folder /Public Reports by putting the mouse pointer over the folder row and selecting the Properties button on the floating toolbar, check Enable Resources from Real Paths, specify a real path for the demo virtual folder as
C:\Logi JReport\Server\reportbak, then select OK to save the changes.
- In the Windows directory
C:\Logi JReport\Server\reportbak, create three sub directories report1, report2, and report3, and then copy some reports and catalogs into them.
- On starting Logi JReport Server, select the virtual folder /Public Reports. You will then see the three sub folders: report1, report2, and report3 within it, including their reports and catalogs.
Now end users can perform operations on the real path resources, including viewing versions, setting properties, and report based operations such as running, advanced running, and scheduling.
- You cannot publish resources to a folder that comes from a real path.
- You cannot use a real path resource as an archive location.
- Real path resources themselves can only have one version in the server resource tree, so they do not support the Archive Policy feature for managing multiple versions.
- The relationships of folder real paths do not need to be consistent with that of the resource tree folders. That is, they are independent of each other. For example, in the resource tree, the folder ABC, whose real path is
C:\FolderABC, has a sub folder DEF. The real path of DEF need not necessarily be a folder in
C:\FolderABC. It can be any folder. However, if you put DEF under FolderABC it will be visible as published.
- After using the real path resources, under certain special conditions some invalid nodes will be generated in the server databases. In order to delete the invalid nodes, administrators can perform the corresponding option on the Logi JReport Administration page to clear invalid nodes from the internal Logi JReport Server database. For details, see Clearing Invalid Nodes from the Realm Database.
Setting Default Real Paths for the Public Reports and Public Components Folders Before Server Starts
Logi JReport Server enables setting the default real paths for the Public Reports and Public Components folders without having to log onto the server. There are two ways to achieve this goal: setting the real path during or after installation.
- Setting during installation
- When installing Logi JReport Server using the Installation Wizard, select the installation type Custom Installation for Standalone Server. The Configure System Environment screen is then available.
- In the screen, select Advanced from the left panel.
- Check the Enable Resources from Real Paths option, and then type in the paths separately in the Public Reports Real Path and Public Components Real Path text fields or specify the paths using the Browse button.
- Upon completion of the installation, an install.server.properties file will be created in the
<install_root>\bindirectory. When the server starts, it retrieves the file contents, and then sets the real path for the Public Reports and Public Components folders. Note that the file is deleted after the server has loaded the file contents.
- Setting after installation
If you want to set the default real paths for the Public Reports and Public Components folders after installation, you can create an install.server.properties file in the
<install_root>\bindirectory manually. Specify the content in the file as follows: