Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Running Applications in Separate Server Instances

 

Junos Space enables you to deploy an application to a separate instance within an application server so that you can allocate resources to each application. You can individually shut down an instance without affecting other instances that are running other applications.

Junos Space Release 13.3R1 and later versions run on JBoss EAP 6, which supports the concept of a managed domain. A domain comprises one or more server groups and each server group comprises one or more server instances. A domain is controlled by a domain controller, which ensures that each server is configured according to the management policy of the domain. With this feature, you can deploy each application to a separate server instance, if needed. You can also shut down individual instances without affecting other instances that are running other applications.

Before you install Junos Space Network Management Platform, it is necessary that you set up the infrastructure of server groups and add servers to the server groups so that you can install an application such as Security Director on a specific server instance. After the setup is ready, add the application from the Junos Space UI (see Adding a Junos Space Application).

Note

Service Now and Service Insight should be run in the same server group of a JBoss EAP domain as the Junos Space Network Management Platform. Operating Service Now, Service Insight, and Junos Space Network Management Platform in different server groups is not supported.

Instructions to set up, start, stop, or remove a server instance are in the following topics:

Adding a Server Group

A server group comprises one or more server instances that are managed and configured as one. All servers (server instances) of the same server group perform the same tasks because they share the same profile configuration and deployed content.

To add a server group:

  1. Launch the management CLI in Linux by typing the following text at the command prompt:
    EAP_HOME/bin/jboss-cli.sh
  2. Type the following text:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/server-group=<SERVER_GROUP_NAME>:add(profile=full-ha,socket-binding-group=full-ha-sockets)”

    In this text:

    • DOMAIN_CONTROLLER_HOST is the hostname of the server that runs Junos Space Network Management Platform.

    • SERVER_GROUP_NAME is the name of the server group that you want to add.

    Note

    Refer to the JBoss version 6 documentation set for more information about configuring the profile and socket-binding-group parameters.

    The configuration in this topic provides you with full clustering capabilities because you have used the profile=full-ha parameter at the command prompt.

For the newly added server group to appear in the Junos Space GUI:

  1. From the shell console, enter /var/cache/jboss/jmp/payloads/.
  2. Navigate to the directory in which you have installed the application. For example, /var/cache/jboss/jmp/payloads/ICEAAA.xxxxx/.
  3. Open the swIndex.txt file and add the following text:
    IsOnlyDeployedWithPlatform=false.

Adding a Server to a Server Group

You should add a new server to a server group so that you can run an application separately on this server. However, when you install Junos Space Network Management Platform, by default a platform server group is created and all the applications are added to this server group automatically.

To add a server to a server group:

  1. Launch the management CLI in Linux by typing the following text at the command prompt:
    EAP_HOME/bin/jboss-cli.sh
  2. Type the following text:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/host=<HOSTNAME>//server-config=<SERVER_NAME>:add(auto-start=true, group=<SERVER_GROUP_NAME>, socket-binding-port-offset=100)”

    In this text:

    • DOMAIN_CONTROLLER_HOST is the hostname of the server that run the Junos Space Network Management Platform.

    • HOSTNAME is defined in host.xml in the /usr/local/jboss/domain/configuration directory.

    • SERVER_NAME is the name of the server that you want to add.

    • SERVER_GROUP_NAME is the name of the server group to which you want to add the new server.

    Note

    Refer to the JBoss version 6 documentation set for more information about configuring the auto-start and socket-binding-port-offset parameters.

Note

After you have successfully added a server to a server group (for example, consider you have added a server group called as firstServerGrp), log in to the domain controller and perform the following action:
/server-group= firstServerGrp/jvm= firstServerGrp/:add(max-heap-size=1024m,max-permgen-size=256m,heap-size=64m)

Starting Servers in a Server Group

You need to start a server in a server group before you deploy an application to this server instance.

To start a server in a server group:

  1. Launch the management CLI in Linux by typing the following text in a command line:
    EAP_HOME/bin/jboss-cli.sh
  2. Type the following text:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/server-group=application/:start-servers”.
    In this text, DOMAIN_CONTROLLER_HOST is the hostname of the server that runs Junos Space Network Management Platform.

    This command starts all servers in a server group.

    To start a specific server, use the following command:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/host=<HOSTNAME>server-config=<SERVER_NAME>/:start(server=<SERVER_NAME>,blocking=false)”

Stopping Servers in a Server Group

You may want to stop the servers within a server group when you no longer need them—for example, in situations where no applications are running on these servers.

To stop a server in a server group:

  1. Launch the management CLI in Linux by typing the following text in a command line:
    EAP_HOME/bin/jboss-cli.sh
  2. Type the following text:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/server-group=application/:stop-servers”
    In this text, DOMAIN_CONTROLLER_HOST is the hostname of the server that runs Junos Space Network Management Platform.

    This command stops all the servers in a server group.

    To stop a specific server, use the following command:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/host=<HOSTNAME>server-config=<SERVER_NAME>/:stop(server=<SERVER_NAME>,blocking=false)”

Removing a Server Group

You may want to remove a server group when you no longer need it—for example, in situations where no applications are running on these server groups.

To remove a server group:

  1. Launch the management CLI in Linux by typing the following text in a command line:
    EAP_HOME/bin/jboss-cli.sh
  2. Type the following text:
    $sh jboss-cli.sh --connect --controller=<DOMAIN_CONTROLLER_HOST> “/server-group=<SERVER_GROUP_NAME>:remove”

    In this text:

    • DOMAIN_CONTROLLER_HOST is the hostname of the server that runs Junos Space Network Management Platform.

    • SERVER_GROUP_NAME is the name of the server group that you want to remove.

Moving an Application to a Different Server Group

You can move an application from the current server group to a different server group, if needed, by using the moveApplication.pl script under the /var/www/cgi-bin directory.

Note

Before moving an application to another server group (for example, to secondServerGrp), log in to the domain controller and perform the following action:
/server-group= secondServerGrp/jvm= secondServerGrp/:add(max-heap-size=1024m,max-permgen-size=256m,heap-size=64m)

To move an application from the current server group to another server group:

  1. From the shell console, enter /var/www/cgi-bin.
  2. Type the following text:
    $perl moveApplication.pl -s <SOURCE_SERVER_GROUP> -d <DESTINATION_SERVER_GROUP> -a <APPLICATION_NAME>
    • SOURCE_SERVER_GROUP is the name of the server group from which you want to remove the application.

    • DESTINATION_SERVER_GROUP is the server group that want to move the application to.

    • APPLICATION_NAME is the name of the application that want to move from the current server group to another server group.

    For example, to move the ICEAAA application from firstServerGrp to secondServerGrp, type the following text:
    moveApplication.pl -s firstServerGrp -d secondServerGrp -a ICEAAA