FS Browser Bundle

The FS Browser Bundle enables framework administrators to browse the part of the file system, which represents the storage of the mBS working directory, on the machine that hosts the ProSyst mBS framework. This is realized through pluggable commands available in the fs command group. The Parser Service of the ProSyst Util Bundle manages these commands. The bundle functionality lays over the current file system realization in an independent manner.

Contents:

Bundle Information

Bundle JAR
Import
Export

Pluggable Commands
Console Commands
System Properties

Bundle Information

Bundle JAR

The JAR file of the FS Browser Bundle is fsbrowser.jar located in the bundles directory.

The fsbrowsermio.jar is for installation on the Connector Version of the framework.

Import

Package	Exporter	Description
`com.prosyst.mbs.services.permissionadmin`	System Bundle / ProSyst Util Full Bundle	Contains the ProSyst Permission Admin Service for managing bundle permission according to bundle locations.
`com.prosyst.util.hash`	System Bundle / ProSyst Util Full Bundle	Delivers hashtable utilities.
`com.prosyst.util.pcommands`	ProSyst Util Bundle / ProSyst Util Full Bundle	Maintains the API to plug commands into the command collection of the Parser Service.
`com.prosyst.util.ref`	ProSyst Util Bundle / ProSyst Util Full Bundle	Holds the log utility of the ProSyst Util Bundle which is used for storing log information.

Export

The FS Browser Bundle exports no packages.

Pluggable Commands

The FS Browser Bundle registers the com.prosyst.util.pcommands.PluggableCommands service which contains the commands for browsing the framework file system. The Parser Service of the ProSyst Util Bundle detects the PluggableCommands service and submits these commands to requesting bundles, such as the Console and Telnet bundles.

Console Commands

The FS Browser Bundle plugs a new command group called fs into the Parser Service. Server administrators can issue the commands in this group from the server runtime console and from a Telnet application.

The fs group commands allow one to explore the folders of the storage home directory. Therefore, you can examine the data related to a particular bundle.

When you are using the Connector Version of ProSyst mBS, the FS Browser bundle allows you to examine the storage file as a directory structure. In this case using the FS bundle and the HTTP File System Browser is the only way to view the files and directories in the server storage in a comprehensible way, when the storage is represented as a single file.

After you start the ProSyst mBS, from the server runtime console or from a Telnet application, type cd fs or fs/ to enter the command group of the FS Browser Bundle. The commands in the group are as follows:

Command Shortcut Description

pwd - Prints the working directory

home - Switches to the home directory, the storage one.

list <dir_name> ls, dir Lists the content of the working folder if no parameter is specified. The parameter is optional, if given, the specified directory is listed.

tree <dir_name> - Lists the files and directories in the working folder or in the specified one as a parameter, in the form of a tree.

cat <file_name>

-

Prints the content of the file with the specified name.

`-h, -H`	Prints the specified file in hexadecimal format.
`-d, -D`	If the file is printed in hexadecimal format, determines the offsets to be printed in decimal format.

chdir <dir_name> chd, cdir Switches to the directory with the specified name. The alias of the root directory is \.

find <file_name> - Searches for a file in the current directory and its subtree.

If you want to access the storage of the Log Bundle whose bundleID currently is 6 and the bundle was loaded once, the sequence of fs commands can be:

chdir 6/1/data/logs cat log.txt

Tip: Type help to receive information about fs group commands.

System Properties

The FS Browser Bundle uses the following system properties:

System Property	Description
`mbs.fsbrowser.debug.console`	Enables generation of debug information about the runtime operation of the FS Browser Bundle.
`mbs.fsbrowser.debug`	Enables printing generated debug in the framework console.

To use the above system properties successfully, you should specify them:

In the default.prs file prior to framework startup.
At framework runtime through the set console command or through the mConsole before the FS Browser Bundle is started. Otherwise, you have to restart it.

Utility Bundles