Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

    Page tree
    Skip to end of metadata
    Go to start of metadata
    Discover with BMC Discovery
    download

    This product can be discovered by any edition of BMC Discovery. Download our free Community Edition to try it out, or [see what else it can discover] !

    What is this?
    This is a product information page, containing details of the information that BMC Discovery gathers about a product and how it is obtained.
    Product Name
    JBoss Portal
    Publisher Page
    Red Hat
    Category
    Enterprise Portals
    Release
    TKU 2017-Sep-1
    Change History
    Red Hat JBoss Portal - Change History
    Reports & Attributes
    Red Hat JBoss Portal - Reports & Attributes
    Publisher Link
    Red Hat

    Product Description

    JBoss Enterprise Portal Platform provides an integrated open source platform for hosting and serving a portal's web interface, aggregating, publishing, and managing its content, and personalizing its experience.

    Known Versions

    • 2.2.1
    • 2.4.2
    • 2.6.4
    • 2.6.6
    • 2.7

    Software Pattern Summary

    Product ComponentOS TypeVersioningPattern Depth
    JBossPortalWindows, UNIXFile, PathInstance-based

    Platforms Supported by the Pattern

    The pattern supports both the Windows and UNIX platforms.

    Identification

    Software Instance Triggers

    PatternTrigger NodeAttributeConditionArgument
    JBossPortalDiscoveredProcesscmdmatchesregex '\bjava(?:\.exe)?$'
    argsmatchesregex 'org\.jboss\.Main'

    Avoiding false positives

    The trigger is the same trigger as Red Hat JBoss Application Server. To ensure the pattern only generated on a JBoss Portal instance the following additional checking as carried out before an SI is created.

    Obtaining the installation path

    The pattern first parses the trigger process arguments to pull out the classpath using the following regular expressions:

    • Windows
      • If the classpath is within quotes (contains spaces in the paths): (?i)-(?:cp|classpath)\s+"(.+?)"

      • If the classpath is not within quotes: (?i)-(?:cp|classpath)\s+(\S+)\s

    • UNIX platforms
      • If the classpath is within quotes (contains spaces in the paths): -(?:cp|classpath)\s+"(.+?)"

      • If the classpath is not within quotes: -(?:cp|classpath)\s+(\S+)\s

    The classpath has also the path separator characters normalized for the platform type

    The pattern then parses the classpath section by section (sections are separated by ':' on UNIX platforms and ';' on the Windows platform) to obtain the installation path using the following regular expressions:

    • Windows: (?i)^(\w:\\.+?)\\bin\\run\.jar

    • UNIX: ^(/\S+?)/bin/run\.jar

    If the installation path is not obtained the pattern will stop.
    If the installation path is found the pattern continues onto the second test to verify the presence of JBoss Portal.

    Checking for a file

    The pattern checks for the existence of a file <installation_path>/server/default/deploy/jboss-portal.sar/portal-aop.xml. If it cannot find this file it assumes it is not looking at a JBoss Portal instance so exits without creating an SI

    Software Instance Type Attributes Created

    The pattern in this module will set the following attribute:

    Pattern NameSI Type
    JBossPortalRed Hat JBoss Portal

    Versioning

    Versioning is attempted using file and path versioning.

    File versioning

    The pattern has already obtained details of the base directory when checking for false positives

    For file versioning, the pattern looks at the following file

    • <base directory>/docs/portal/quickstartGuide/eclipse/toc.xml

    The pattern then extracts the version information from the file using the following regular expression

    • <toc label="JBoss Portal (\d+(?:\.\d+)*)

    Path versioning

    The pattern has already obtained details of the base directory when checking for false positives

    If file versioning is unsuccessful the pattern attempts path versioning. It does this by parsing the base directory using the following regular expression:

    • (?i)jboss-portal-(\d+(?:\.\d+)*)

    Application Model Produced by Software Pattern

    Software Pattern Model

    Pattern Trigger

    The JBossPortal pattern triggers on the JBoss Application Server (java or java.exe with 'org.jboss.Main' in its arguments) process.

    SI Depth

    If a server is identified, the JBossPortal pattern creates an instance-based Software Instance, its key being based on server name, installation_path, type (i.e. Red Hat JBoss Portal) and host key.

    If no server is identified, the JBossPortal pattern creates a grouped instance-based Software Instance, its key being based on the installation path

    Relationship Creation

    If a server name has been identified, a dependency relationship is created between the Portal SI and the Application Server SI that share this server name.

    The Application Server SI is identified by using the following query:

    • *search Host traverse Host:HostedSoftware:RunningSoftware:SoftwareInstance where type = 'Red Hat JBoss Application Server' or type = "WildFly" and server_name = '%server_name%' *

    Subject Matter Expertise

    Subject Matter Expert input will be welcome on any other potential approaches not discussed to improving product versioning coverage and depth of Red Hat JBoss Portal.

    Testing

    Testing was performed against a live installation of JBoss Portal on both Windows and Linux

    Open Issues

    There are no known open issues with this pattern.


    Created by: Chris Blake 25 Sep 2008
    Updated by: Nikola Vukovljak 22 Jan 2013