COMPOSITE APPLICATIONS - DESIGN AND MANAGEMENT


Using the Notes console to troubleshoot component loading
The IBMR LotusR NotesR console can be used for troubleshooting the component loading process. To use the console, add "-console" to the startup command for the Notes application shortcut.

To obtain help in the console, type "help" for a list of the console commands. The current list of commands displays as follows:

osgi> help

---Eclipse Runtime commands.---

        diag - Displays unsatisfied constraints for the specified bundle(s).

        active - Displays a list of all bundles currently in the ACTIVE state.

        getprop { name } - Displays the system properties with the given name,
       or all of them.

Valid commands:

---Controlling the OSGi framework---

        launch - start the OSGi Framework

        shutdown - shutdown the OSGi Framework

        close - shutdown and exit

        exit - exit immediately (System.exit)

        gc - perform a garbage collection

        init - uninstall all bundles

        setprop <key>=<value> - set the OSGi property

---Controlling Bundles---

        install - install and optionally start bundle from the given URL

        uninstall - uninstall the specified bundle(s)

        start - start the specified bundle(s)

        stop - stop the specified bundle(s)

        refresh - refresh the packages of the specified bundles

        update - update the specified bundle(s)

---Displaying Status---

        status - display installed bundles and registered services

        ss - display installed bundles (short status)

        services {filter} - display registered service details

        packages {<pkgname>|<id>|<location>} - display imported/exported package details

        bundles - display details for all installed bundles

        bundle (<id>|<location>) - display details for the specified bundle(s)

        headers (<id>|<location>) - print bundle headers

        log (<id>|<location>) - display log entries

---Extras---

        exec <command> - execute a command in a separate process and wait

        fork <command> - execute a command in a separate process

---Controlling Start Level---

        sl {(<id>|<location>)} - display the start level for the specified bundle, or for the framework if no bundle specified

        setfwsl <start level> - set the framework start level

        setbsl <start level> (<id>|<location>) - set the start level for the bundle(s)

        setibsl <start level> - set the initial bundle start level

------Controlling the Profiling------

        profilelog - Display & flush the profile log messages

---Provisioning Commands---

        prov e <id> <version> - Enables a feature

        prov d <id> <version> - Disables a feature

        prov u <id> <version> - Uninstalls a feature

        prov i <id> <version> <url> - Installs a feature

        prov ie <id> <version> <url> [ (perfect|compatible|equivalent|greaterOrEqual) [true|false] ] - Installs and enables a feature

        prov m <url> - Provisions via a manifest file

        prov lu - Lists features on the uninstall list

---Property Broker Commands---

        pbsh a - Show all Actions

        pbsh a <owner/expression> - Show all Actions for a specific owner

        pbsh aa - Show all Active Actions

        pbsh o - Show all owners

        pbsh p - Show all properties by owner

        pbsh p <owner/expression> - Show all properties for this owner (string owners only)

        pbsh w - Show all enabled wires

        pbsh w <owner/expression> - Show all wires for a specific owner

        pbsh aw - Show all wires

        pbsh ns - Show reqistered name spaces

        pbt <Property> - Trace the path for the specified property

        pbut <Property> - UnTrace the specified property, removes the trace

        pblt - Show a list of the currently traced Properties

---Topology Handler UI Commands---

        thuish desc - Show all Perspective Descriptors

        thuish del <perspective id> - Delete a Perspective Descriptor

        thuish lp Show all Launcher Item IDs

        thuish cd Show Current Perspective Descriptor

        thuish ea Show Current Enabled Activities

        thuish a <activity id> Show Activity State

---Topology Handler Commands---

        thsh n - Show all navigation elements

        thsh p - Show all Pages

        thsh l - Show all Labels

        thsh f - Show all topology files

        thsh apps - Show all application GUIDs

        thsh e <namespace> - Show all registered extensions under the given namespace

        thsh dp - Show all dirty pages

        thsh nattr <navigation id> - Show all navigation preferences

---Controlling the JSR47 Logger---

        setlogrlev <logger> (level) - set the logger to the specified level, defaults to FINEST

        getlogrlev <logger> - returns the current level of the logger specified

---Managed Settings Commands---

        ms_dump qualifier [key] - Dump out the settings with this qualifier.  If the key is specified, only that setting will be dumped.

        ms_state [input file name] - Dump the internal state information.  If no file is specified, all state information will be dumped.

---Controlling the Console---

        more - More prompt for console output

osgi>