Deploying a new application

Goal

You developed a new service, compiled it, and are now ready to use it in your cluster. To use the new service, you need to deploy it to compute hosts and associate it with an application.

At a glance

  1. Create the service package

  2. Create the application

  3. Configure the client to run with the new application

Create the service package

Before you can deploy a service, you need to create a service package.

Packaging a Symphony application for deployment involves putting all service files and any dependent files associated with the service in a package.

Important:

Verify that all dependencies are either pre-installed or deployed with the service. For example, if your application is .NET, ensure that the .NET Framework is installed and that it is the correct version for your application.

Compress into a package:

  • Service executables

  • Additional files required for the services to work.

It is not required to use gzip as indicated in the example to package a service. You can use any supported format. If using a utility other than gzip, ensure the compression and uncompression utility is in your Path environment variable when using soamdeploy.

Supported package formats:

  • .zip

  • .tar

  • .taz

  • .tar.zip

  • .tar.Z

  • .tar.gz

  • .tgz

  • .jar

  • .gz

Create the service package for deployment on Windows

  1. Go to the directory in which the service is located.

    For example, %SOAM_HOME%\5.1\win32-vc7\samples

  2. Create an application package by compressing the service executable into a zip file:

    gzip SampleService.exe

    You have now created your first service package SampleService.exe.gz. Next, create the application.

Create the service package for deployment on Linux/UNIX

  1. Go to the directory in which the service is located.

    For example, $SOAM_HOME/5.1/linux2.4-glibc2.2-x86/samples

  2. Create an application package by compressing the service executable into a tar file:

    tar -cvf SampleService.tar SampleService

    gzip SampleService.tar

    You have now created your first service package SampleService.tar.gz. Next, create the application.

Create the application

Add the application with the Add Application Wizard. The Wizard creates a consumer for you with your application name, allocates resources, deploys your service package and registers your application. After completing the Wizard, your application should be ready to use.

You can also use commands to deploy a service package and register an application. See soamdeploy and soamreg in the Symphony Reference for more details.

  1. In the Platform Management Console, click Symphony Workload > Configure Applications.

    The Applications page displays.

  2. Select Global Actions > Add/Remove Applications.

    The Add/Remove Application page displays.

  3. Select Add an application, then click Continue.

    The Adding an Application page displays.

  4. Select Create new profile and add application wizard.
  5. Enter your application name, then click Continue.

    The Define the Service window displays.

  6. Enter service information, then click Continue.
    1. Change the Service name to the name you want to assign to your new service.
    2. In command to start this service, enter the command to run your service executable.

      For example, if in your service package you have the directory structure \myservice\myservice.exe, indicate myservice\myservice.exe in StartCmd.

    The Define session type window displays.

  7. If you have defined session types in your client application, select Define a custom session type, fill in the desired information, then select Continue.

    The Confirm application profile details window displays.

  8. Review your selections, then click Confirm.

    The window displays indicating progress. Your application is ready to use.

  9. Click Close.

    The window closes and you are now back in the Platform Management Console. Your new application is displayed as enabled.