Getting and Using Resources From a Real Path
In addition to the published resources, you can also use resources obtained from real paths on Logi JReport Server. The difference between real path resources and published resources lies in the way of managing them: published resources are managed on Logi JReport Server, while real path resources can be managed on both the server and the operating system. On 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. Real path resources can only be deleted by removing 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. If you do not want to add resources to the server using the Publish feature, set a real path instead.
By default, real path resources are disabled on Logi JReport Server. To enable using real path resources, administrators need to check the Enable Resources from Real Paths option in the server console > Administration > Configuration > Advanced page and then restart Logi JReport Server.
The following example shows using resources obtained from the real path of the Public Reports folder:
- In the Resources page of the server console, browse to the Public Reports folder, put the mouse pointer over the folder row and select the Properties button on the floating toolbar.
- In the General tab of the Folder Properties dialog, check Enable Resources from Real Paths, specify the real path for the virtual folder as
C:\JReport\Server\reportbak, then select OK to save the changes.
- Create the folder reportbak in
C:\JReport\Server\, and the sub folders report1 and report2 in it, then copy some reports and catalogs into them.
- In the server resource tree, open the virtual folder Public Reports. You can see the sub folders within it, including the reports and catalogs.
Now you 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.
- 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 in the server console 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 boxes 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 and add the following content in the file. For example: