1
/*******************************************************************************
2
* Copyright (c) 2009 Eucalyptus Systems, Inc.
4
* This program is free software: you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License as published by
6
* the Free Software Foundation, only version 3 of the License.
9
* This file is distributed in the hope that it will be useful, but WITHOUT
10
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14
* You should have received a copy of the GNU General Public License along
15
* with this program. If not, see <http://www.gnu.org/licenses/>.
17
* Please contact Eucalyptus Systems, Inc., 130 Castilian
18
* Dr., Goleta, CA 93101 USA or visit <http://www.eucalyptus.com/licenses/>
19
* if you need additional information or have any questions.
21
* This file may incorporate work covered under the following copyright and
24
* Software License Agreement (BSD License)
26
* Copyright (c) 2008, Regents of the University of California
27
* All rights reserved.
29
* Redistribution and use of this software in source and binary forms, with
30
* or without modification, are permitted provided that the following
33
* Redistributions of source code must retain the above copyright notice,
34
* this list of conditions and the following disclaimer.
36
* Redistributions in binary form must reproduce the above copyright
37
* notice, this list of conditions and the following disclaimer in the
38
* documentation and/or other materials provided with the distribution.
40
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
41
* IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
42
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
43
* PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
44
* OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
45
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
46
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
47
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
48
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
49
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
50
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. USERS OF
51
* THIS SOFTWARE ACKNOWLEDGE THE POSSIBLE PRESENCE OF OTHER OPEN SOURCE
52
* LICENSED MATERIAL, COPYRIGHTED MATERIAL OR PATENTED MATERIAL IN THIS
53
* SOFTWARE, AND IF ANY SUCH MATERIAL IS DISCOVERED THE PARTY DISCOVERING
54
* IT MAY INFORM DR. RICH WOLSKI AT THE UNIVERSITY OF CALIFORNIA, SANTA
55
* BARBARA WHO WILL THEN ASCERTAIN THE MOST APPROPRIATE REMEDY, WHICH IN
56
* THE REGENTS DISCRETION MAY INCLUDE, WITHOUT LIMITATION, REPLACEMENT
57
* OF THE CODE SO IDENTIFIED, LICENSING OF THE CODE SO IDENTIFIED, OR
58
* WITHDRAWAL OF THE CODE CAPABILITY TO THE EXTENT NEEDED TO COMPLY WITH
59
* ANY SUCH LICENSES OR RIGHTS.
60
*******************************************************************************
61
* @author chris grzegorczyk <grze@eucalyptus.com>
64
package com.eucalyptus.address;
66
import java.util.NoSuchElementException;
67
import javax.persistence.Column;
68
import javax.persistence.PersistenceContext;
69
import javax.persistence.PrePersist;
70
import javax.persistence.Table;
71
import javax.persistence.Transient;
72
import org.apache.log4j.Logger;
73
import org.hibernate.annotations.Cache;
74
import org.hibernate.annotations.CacheConcurrencyStrategy;
75
import org.hibernate.annotations.Entity;
76
import com.eucalyptus.configurable.ConfigurableClass;
77
import com.eucalyptus.configurable.ConfigurableField;
78
import com.eucalyptus.configurable.ConfigurableProperty;
79
import com.eucalyptus.configurable.ConfigurablePropertyException;
80
import com.eucalyptus.configurable.PropertyChangeListener;
81
import com.eucalyptus.configurable.PropertyChangeListeners;
82
import com.eucalyptus.entities.AbstractPersistent;
83
import com.eucalyptus.entities.EntityWrapper;
84
import com.eucalyptus.records.Logs;
87
@javax.persistence.Entity
88
@PersistenceContext( name = "eucalyptus_cloud" )
89
@Table( name = "cloud_address_configuration" )
90
@Cache( usage = CacheConcurrencyStrategy.TRANSACTIONAL )
91
@ConfigurableClass( root = "cloud.addresses",
92
description = "Configuration options controlling the handling of public/elastic addresses." )
93
public class AddressingConfiguration extends AbstractPersistent {
94
private static final long serialVersionUID = 1L;
97
private static Logger LOG = Logger.getLogger( AddressingConfiguration.class );
99
@ConfigurableField( displayName = "dynamic_public_addressing",
100
description = "Public addresses are assigned to instances by the system as available.",
101
changeListener = DynamicAddressingListener.class )
102
@Column( name = "config_addr_do_dynamic_public_addresses",
104
columnDefinition = "boolean default true" )
105
private Boolean doDynamicPublicAddresses;
107
@ConfigurableField( displayName = "static_address_pool",
108
changeListener = PropertyChangeListeners.IsPositiveInteger.class,
109
description = "Public addresses are assigned to instances by the system only from a pool of reserved instances whose size is determined by this value." )
110
@Column( name = "config_addr_reserved_public_addresses" )
111
private Integer systemReservedPublicAddresses;
113
@ConfigurableField( displayName = "address_orphan_count",
114
changeListener = PropertyChangeListeners.IsPositiveInteger.class,
115
description = "Number of times an orphaned address is reported by a cluster before it is reclaimed by the system." )
116
@Column( name = "config_addr_orphan_ticks", nullable = false )
117
private Integer maxKillOrphans;
119
@ConfigurableField( displayName = "address_orphan_grace",
120
changeListener = PropertyChangeListeners.IsPositiveInteger.class,
121
description = "Time after the last recorded state change where an orphaned address will not be modified by the system (minutes)." )
122
@Column( name = "config_addr_orphan_grace", nullable = false )
123
private Integer orphanGrace;
125
public static class DynamicAddressingListener implements PropertyChangeListener {
127
public void fireChange( ConfigurableProperty t, Object newValue ) throws ConfigurablePropertyException {
128
AddressingConfiguration.getInstance( ).doDynamicPublicAddresses = ( Boolean ) newValue;
132
public AddressingConfiguration( ) {
136
public static AddressingConfiguration getInstance( ) {
137
AddressingConfiguration ret = null;
139
ret = EntityWrapper.get( AddressingConfiguration.class ).lookupAndClose( new AddressingConfiguration( ) );
140
} catch ( final NoSuchElementException ex1 ) {
142
ret = EntityWrapper.get( AddressingConfiguration.class ).mergeAndCommit( new AddressingConfiguration( ) );
143
} catch ( final Exception ex ) {
144
Logs.extreme( ).error( ex, ex );
145
ret = new AddressingConfiguration( );
152
protected void initialize( ) {
153
if ( this.doDynamicPublicAddresses == null ) {
154
this.doDynamicPublicAddresses = Boolean.TRUE;
156
if ( this.systemReservedPublicAddresses == null ) {
157
this.systemReservedPublicAddresses = 0;
159
if ( this.maxKillOrphans == null ) {
160
this.maxKillOrphans = 360;
162
if ( this.orphanGrace == null ) {
163
this.orphanGrace = 360;
167
public Boolean getDoDynamicPublicAddresses( ) {
168
return this.doDynamicPublicAddresses;
171
public void setDoDynamicPublicAddresses( final Boolean doDynamicPublicAddresses ) {
172
this.doDynamicPublicAddresses = doDynamicPublicAddresses;
175
public Integer getSystemReservedPublicAddresses( ) {
176
return this.systemReservedPublicAddresses;
179
public void setSystemReservedPublicAddresses( final Integer systemReservedPublicAddresses ) {
180
this.systemReservedPublicAddresses = systemReservedPublicAddresses;
183
public Integer getMaxKillOrphans( ) {
184
return this.maxKillOrphans;
187
public void setMaxKillOrphans( Integer maxKillOrphans ) {
188
this.maxKillOrphans = maxKillOrphans;
191
public Integer getOrphanGrace( ) {
192
return this.orphanGrace;
195
public void setOrphanGrace( Integer orphanGrace ) {
196
this.orphanGrace = orphanGrace;