Webswing Setup for the Logical View Editor

You can choose to enable Control-D/WebAccess Server to launch the Logical View Editor in your web browser using Webswing, instead of downloading a Java Network Launch Protocol (JNLP) file. For more information about the Logical View Editor, see Control-D/WebAccess Server Logical Views.

Webswing setup includes the following tasks:

  1. Installing Webswing

  2. Configuring Webswing for Control-D/WebAccess Server

  3. Configuring Control-D/WebAccess Server for Webswing

Installing Webswing

This procedure describes how to download Webswing and point it to the relevant Java installation.

Begin

  1. Download a ZIP-format Webswing installation package from the Webswing download site.

    The Webswing version that you download must support Java 8, 11, or 17.

  2. Extract the contents of the installation package to a directory on a server machine chosen by your IT administrator.

  3. Point Webswing to Java 8, 11, or 17 by doing the following:

    • Windows:

      1. Locate the webswing.bat file and open it for editing.

      2. Find the line that begins with the following string:

        java -jar server/webswing-jetty-launcher.jar

      3. Add %JAVA_HOME%\bin\ at the beginning of this line, so that it now begins with the following string:

        %JAVA_HOME%\bin\java -jar server/webswing-jetty-launcher.jar

      4. Add the following line immediately before the line that you edited in the previous step:

        set JAVA_HOME=<Java path>

    • UNIX:

      1. Locate the webswing.sh file and open it for editing.

      2. Find the following line:

        export JAVA_HOME=$JAVA_HOME

      3. Add the following line immediately before the line that you found in the previous step:

        JAVA_HOME=<Java path>

  4. Run the webswing.bat or webswing.sh script file.

Configuring Webswing for Control-D/WebAccess Server

This procedure describes how to configure Webswing to work with Control-D/WebAccess Server.

Begin

  1. Log in to the Webswing Admin Console through your browser using the following URL:

    http://localhost:8080

    Default credentials after installation are admin and pwd (username and password, respectively).

  2. Click Manage.

  3. Click the Applications tab.

  4. Click the + button and create a new application named walv.

  5. Click the walv application that you created.

  6. Click the Web Config button and then click 1. General.

  7. In the Name field, type WebAccess Server Logical View Editor and then click Apply.

  8. Click the App Config button and then click 2. Java.

  9. Click the + Class Path and then, in the Class Path field, type the following path, and then click Apply:

    • Windows: <WebAccess installation path>\bin\java\lv.jar

    • UNIX: <WebAccess installation path>/bin/java/lv.jar

    c:\Program Files\BMC Software\Control-D\wa\bin\java\lv.jar

  10. Click 2.1. Launcher Configuration.

  11. In the Main Class field, type the following value, and then click Apply:

    com.bmc.studio.lv.edit.main.LVSEditWS

  12. In the Main Arguments field, type ${customArgs}, and then click Apply.

  13. Click 3. Session.

  14. In the Session Timeout field, type 0, and then click Apply.

  15. Configure access to Webswing from additional machines, in addition to localhost, by doing the following:

    1. Stop the webswing.bat script (on Windows) or webswing.sh script (on Unix).

    2. Locate the jetty.properties file in the Webswing directory, and open it for editing.

    3. Change the value of the org.webswing.server.host property to your hostname.

    4. Locate the webswing-admin.properties file in the admin subdirectory, and open it for editing.

    5. Change the values of the following properties, as follows:

      • webswing.server.publicUrl = http://<your hostname>:8080

      • webswing.server.websocketUrl = ws://<your hostname>:8080

    6. Run the webswing.bat script (on Windows) or webswing.sh script (on Unix).

Configuring Control-D/WebAccess Server for Webswing

This procedure describes how to configure Control-D/WebAccess Server to work with Webswing.

Begin

  1. Open the Control-D/WebAccess Server Desktop application.

  2. From the Root directory, navigate to the following location:

    Definitions > WebAccess Server > WebAccess > WebAccess

  3. Double-click Application Features.

    The Application Features window appears.

  4. In the Application Features, locate the Logical View Editor settings and do the following:

    • Set Launch Type to Webswing.

    • In the Webswing URL field, type the URL for the Webswing application that you created for the Logical View Editor in the following format:

      http://<hostname>:8080/<application name>

      For a Webswing installation on the same machine as Control-D/WebAccess Server, with an application named walv (WebAccess Logical View):

      http://localhost:8080/walv

  5. Click OK.

  6. Restart Control-D/WebAccess Server.