Previous Topic: How to Provision an ApplicationNext Topic: Starting an Application


Configuring an Application

You can configure an application using the Application Configuration property sheet in the GUI or using the app config command in the grid shell.

The Application Configuration property sheet allows you to configure the settings of the application. For a well-built application, these settings are the only configuration that you need to change when starting a new instance of the application. For example, if you made a copy of the application or moved the application from another system, you will need change the configuring, In addition to the application settings, this property sheet contains some additional elements, such as the application management panel and the protocol settings.

You can access the Application Configuration property sheet in the GUI or using the grid shell. For additional information on using the Application Configuration property sheet, refer to the Application Configuration section of the User Interface Reference.

GUI Access

Follow these steps:

  1. Access the gui, then open your application.

    The application displays in the Infrastructure Editor.

  2. In the Application menu, select Configure. The Application Configuration dialog displays the General, Resources, Property Values, Protocols, Notes, and Security tabs.
  3. Configure or modify the parameters, as needed.
  4. Click OK.

    The Infrastructure Editor displays.

Command Line Access

Follow these steps:

  1. Open your application and access the grid shell.
  2. Enter the app config command.
    app stop myapp
    app config myapp primary_ip=209.100.100.12 dns1=209.101.1.3
    app start myapp
    

Note: If you are changing resources and configuration properties, you can combine the reconfiguration with a single stop and restart. You can even combine properties and cpu/memory resources in the same app config command.

Examples of Creating and Modifying a SugarCRM Application

Follow these steps:

  1. Log in to the controller through the web shell.
  2. Execute the following command to see the available set of configuration parameters. SugarCRM_r1 is used as an example.
    app config "SugarCRM_r1" --boundary 
    
  3. Select the network configuration parameters, such as IP address, netmask, gateway, and DNS server, for your grid. These configuration parameters display on the dashboard.
  4. Provision the application using the app provision command. Upon completion of the app provision command, the application should be running.
    Example: 
    app provision SugarCRM_r1 mysugar 
    user_ip=209.100.100.11 admin_ip=209.100.100.12 
    netmask=255.255.255.0 gateway=209.100.100.1 
    dns1=209.101.1.2 dns=209.102.1.2 
    mail_server=mail@mycompany.com 
    config.size=256M logs.size=64M 
    .description="My SugarCRM application" 
    

    You will see the application instance volumes being created. This process runs only once and may take a while. On subsequent starts, startup skips the volume creation phase. After a short delay, you should see Starting application and a progress indicator. As appliances complete their startup, they will be reported. At the end, you should see Application started successfully.

  5. Point your browser to the IP address of the user gateway (the value of the usr_ip property you recorded in the app provision command).

    The SugarCRM home page displays.