Puppet Class: wakanda

Defined in:
manifests/init.pp

Overview

Class: wakanda

This class installs Wakanda server on the host, providing parameters to pass to the runtime.

Parameters

solution_path

The full pathname of the solution to open. The path should be expressed in the system syntax. If you do not pass this parameter, the default solution is opened.

admin_port

An optional parameter that sets the HTTP port number of the built-in ServerAdmin project. The ServerAdmin project is the default administration project. It is published on port 8080 by default. By setting a different value, you can publish this default project on another port, allowing you to launch several Wakanda Servers running the default administration project. The HTTP port that you set is used during the entire server session, even if another solution is opened.

If the opened solution already contains an administration project (project with key administrator=“true” in the myproject.waSettings file), the –admin-port parameter is ignored.

For more information about the Server Administration project, please refer to the Server Administration section.

admin_ssl_port

An optional parameter that sets the HTTPS port number of the built-in ServerAdmin project. It is published on port 4433 by default. By setting a different value, you can publish this default project on another port. The HTTPS port that you set is used during the entire server session, even if another solution is opened.

admin_password

An optional parameter that allows you to set a password to the default administrator user, automatically added to the default solution. By default, a user with the login “admin” and an empty password is created in this solution, and added to the “Admin” group. Once a password is set, the default solution and thus the ServerAdmin project, is protected. For security reasons, assigning a password to the default administrator user is highly recommended.

debugger

Allows you to define the debugger to launch at startup. The available values are:

"--debugger=remote": activate the Remote Web Debugger
"--debugger=wakanda": activate the Wakanda Debugger
"--debugger=none" or no "--debugger" argument: no debugger is activated at startup

Whatever the “–debugger” value, if debugging is disallowed using the “–debug-off” argument in the command line, the “–debugger” parameter is ignored.

debug_off

An optional parameter that disables Debugger features in Wakanda Server. When this parameter is passed, the debugging interface is not launched on the server side. This parameter is useful when the solution is used in a production environment.

channel

Defines which channel to use when installing Wakanda Server. The available values are:

"production": The current production release of Wakanda Server (default).
"stabilization": The current beta release of Wakanda Server.

Examples

class { wakanda:
  solution_path => '/usr/src/application/application Solution/application.waSolution',
  admin_port => 8080,
  admin_ssl_port => 4433,
  admin_password => 'password',
  debugger => 'wakanda',
  debug_off => false,
  channel => 'production'
}

Authors

Wakanda <wakanda@wakanda.org>

Copyright 2013 4D, unless otherwise noted.

Parameters:

  • solution_path (Any) (defaults to: undef)
  • admin_port (Any) (defaults to: undef)
  • admin_ssl_port (Any) (defaults to: undef)
  • admin_password (Any) (defaults to: undef)
  • debugger (Any) (defaults to: undef)
  • debug_off (Any) (defaults to: undef)
  • channel (Any) (defaults to: 'production') 


80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
 
# File 'manifests/init.pp', line 80

class wakanda (
    $solution_path = undef,
    $admin_port = undef,
    $admin_ssl_port = undef,
    $admin_password = undef,
    $debugger = undef,
    $debug_off = undef,
    $channel = 'production'
) {
    package {'wget':
        ensure => present
    }
    apt::source {'wakanda':
        require => Package['wget'],
        ensure => present,
        key => '91FBD148',
        key_source => 'http://apt.andrewshawcare.com/wakanda.key',
        location => 'http://apt.andrewshawcare.com/',
        repos => 'web',
        include_src => false
    }
    package {'wakanda':
        name => "wakanda-${channel}",
        require => Apt::Source['wakanda'],
        ensure => present
    }
    file {'/etc/wakanda':
        ensure => directory
    }
    file {'/etc/wakanda/wakanda.conf':
        ensure => file,
        content => template('wakanda/wakanda.conf.erb')
    }
    service {'wakanda':
        require => [Package['wakanda'], File['/etc/wakanda/wakanda.conf']],
        subscribe => File['/etc/wakanda/wakanda.conf'],
        ensure => running,
        enable => true,
        hasrestart => false,
        hasstatus => true
    }
}