Launching the BBj Enterprise Manager with Java Web Start

Description

In BBj 11.0 and higher, http://localhost:8888/basis/em.jnlp automatically opens the Enterprise Manager. If BBj is not installed locally, replace localhost with the name of the computer where BBj resides.

Prior to BBj 11.0, launching the Enterprise Manager via Java Web Start allows the administrator to update and install the files on a single server machine. As clients need access to the application, they simply click on a link on a Web page that launches the application using Java Web Start. To install a new version of the software, they simply replace the files on the server. The next time any user tries to launch the Enterprise Manager, they will get the updated files.

In BBj 13.0 and higher use the Browser EM shortcut or http://localhost:8888/bbjem/em. If BBj is not installed locally, replace localhost with the name of the computer where BBj resides.

To setup the Enterprise Manager to run using Web Start, follow the directions in Running BBj Thin Client with Java Web Start with the following exceptions:

  • Use the sample JNLP file below as a template.

  • Name the file bbj-em.jnlp (or change the href= part of the <jnlp> tag to the name of your file).

  • Change the codebase= part of the <jnlp> tag to the server where the JNLP file and JARs reside.

  • Be sure to copy and sign the appropriate JAR files listed below (see associated sample) and put these files in the appropriate place on the Web server:

BBj 9.0 and 10.0*

BBjEM.jar, BBjThinClient.jar, BBjUtil.jar, BBjBootstrap.jar, BBjIndex.jar

BBj 8.0

BBjEM.jar, BBjUtil.jar, BBjJDBC.jar, BBjSql.jar, BBjFilesystem.jar, HelpAll.jar

BBj 7.x

BBjEM.jar, BBjThinClient.jar, BBjUtil.jar, HelpAll.jar, BBjJDBC.jar, BBjFilesystem.jar

BBj 6.x and below

BBjEM.jar, BBjThinClient.jar, BBjXML.jar, ThirdParty.jar, b3odbc.jar

*BBj versions 9.x and higher include a built-in Jetty web server with built-in access to Enterprise Manager via Web start. The default address is:  http://localhost:8888/jnlp/em.jnlp.

Example

For BBj 9.0 and Higher

<?xml version="1.0" encoding="utf-8"?>

<!-- JNLP File for BBj Enterprise Manager -->

<jnlp

  spec="1.0"

  codebase="http://servername/"

  href="EM9.0+.jnlp">

<!-- General program information -->

  <information>

    <title>BBj Enterprise Manager 9.0+</title>

    <vendor>BASIS International Ltd.</vendor>

    <description>BBj 9.0+ Enterprise Manager JNLP</description>

  </information>

<!-- We need full access to the user's computer -->

  <security>

 <all-permissions/>

  </security>

<!-- Necessary JAR files for application. These can be found in the BBj lib directory -->

  <resources>

<j2se version="1.6+"/>

    <jar href="BBjEM.jar" download="eager" main="true"/>

    <jar href="BBjThinClient.jar"/>

    <jar href="BBjUtil.jar"/>

    <jar href="BBjBootstrap.jar"/>

    <jar href="BBjIndex.jar"/>

  </resources>

  <resources os="Windows">

     <nativelib href="webstart2166.jar"/>

  </resources>

 

  <resources os="Mac" >

     <nativelib href="webstart2120.jar"/>

  </resources>

 

    <resources os="Linux" >

     <nativelib href="webstart2145.jar" />

  </resources>

      

<!-- Main Java class that starts the application. -->

  <application-desc main-class="com.basis.admin.EnterpriseManager">

  </application-desc>

</jnlp>

For BBj 8.0

<?xml version="1.0" encoding="utf-8"?>

<!-- JNLP File for BBj Enterprise Manager -->

<jnlp

  spec="1.0+""

  codebase="http://localhost:8080/"servername/"

  href="bbj-emEM8.x.jnlp">

<!-- General program information -->

<information>

    <title>Basis BBj Enterprise Manager 8.x</title>

    <vendor>BasisBASIS International Ltd.</vendor>

    <description>Basis BBj 8.x Enterprise Manager</description>

<description kind="short">Administration tool used for configuring BBj components.</ JNLP</description>

</information>

<!-- We need full access to the user's computer -->

<security>

<all-permissions/>

</security>

<!-- Necessary JAR files for application. These can be found in the BBj lib directory -->

<resources>

<j2se version="1.5+"/>

     <jar href="BBjEM.jar"/>

    

    <jar href="BBjUtil.jar"/>

    

    <jar href="BBjJDBC.jar"/>

    

    <jar href="BBjSql.jar"/>

    

    <jar href="BBjFilesystem.jar"/>

    

    <jar href="HelpAll.jar"/>

  </resources>

<!--  <resources os="Windows">

     <nativelib href="webstart2166.jar"/>

  </resources>

 

  <resources os="Mac" >

     <nativelib href="webstart2120.jar"/>

  </resources>

 

    <resources os="Linux" >

     <nativelib href="webstart2145.jar" />

</resources>

<!-- Main Java class that starts the application. -->

  <application-desc main-class="com.basis.admin.EnterpriseManager" />">

  </application-desc>

</jnlp>

For BBj 7.x

 <?xml version="1.0" encoding="utf-8"?>
<!-- JNLP File for BBj Enterprise Manager -->
<jnlp spec="1.0+" codebase="http://localhost:8080/" href="bbj-em.jnlp">
<!-- General program information -->
<information>
<title>BASIS BBj Enterprise Manager</title>
<vendor>BASIS International Ltd.</vendor>
<description>BASIS BBj Enterprise Manager</description>
<description kind="short">Administration tool used for configuring BBj components.</description>
</information>

<!-- We need full access to the user's computer -->
<security>
<all-permissions/>
</security>

<!-- Necessary JAR files for application. These can be found in the BBj lib directory -->
<resources>
<j2se version="1.5+"/>
<jar href="BBjEM.jar"/>
<jar href="BBjThinClient.jar"/>
<jar href="BBjUtil.jar"/>
<jar href="HelpAll.jar"/>
<jar href="BBjJDBC.jar"/>
<jar href="BBjFilesystem.jar"/>
</resources>

<!-- Main Java class that starts the application. -->
<application-desc main-class="com.basis.admin.EnterpriseManager" />
</jnlp>

For BBj 6.x and Below

<?xml version="1.0" encoding="utf-8"?>

<!-- JNLP File for BBj Enterprise Manager -->

<jnlp spec="1.0+" codebase="http://localhost:8080/" href="bbj-em.jnlp">

    <!-- General program information -->

    <information>

        <title>Basis BBj Enterprise Manager</title>

        <vendor>Basis International Ltd.</vendor>

        <description>Basis BBj Enterprise Manager</description>

        <description kind="short">Administration tool used for configuring BBj components.</description>

    </information>

     

    <!-- We need full access to the user's computer -->

    <security>

        <all-permissions/>  

    </security>

     

    <!-- Necessary JAR files for application. These can be found in the BBj lib directory -->

    <resources>

        <j2se version="1.4+"/>

        <jar href="BBjEM.jar"/>

        <jar href="BBjThinClient.jar"/>

        <jar href="BBjXML.jar"/>

        <jar href="ThirdParty.jar"/>

        <jar href="b3odbc.jar"/>

    </resources>

    

    <!-- Main Java class that starts the application. -->

    <application-desc main-class="com.basis.admin.EnterpriseManager" />

</jnlp>