vas 0.3.0

data/lib/vas/gemfire/disk_stores.rb

@@ -0,0 +1,63 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  class DiskStores < Shared::MutableCollection
+
+    def initialize(location, client)
+      super(location, client, 'disk-stores', DiskStore)
+    end
+
+  end
+
+  class DiskStore < Shared::Resource
+
+    # The last modified time of the disk store
+    attr_reader :last_modified
+
+    # The name of the disk store
+    attr_reader :name
+
+    # The size of the disk store
+    attr_reader :size
+
+    # The disk store's cache server node instance
+    attr_reader :instance
+
+    def initialize(location, client)
+      super(location, client)
+
+      @last_modified = details['last-modified']
+      @name = details['name']
+      @size = details['size']
+      @instance = CacheServerNodeInstance.new(Util::LinkUtils.get_link_href(details, 'cache-server-node-instance'), client)
+      @content_location = Util::LinkUtils.get_link_href(details, 'content')
+    end
+
+    # Retrieves the disk store's content and passes it to the +block+
+    def content(&block)
+      client.get_stream(@content_location, &block)
+    end
+
+    def to_s
+      "#<#{self.class} name='#@name'>"
+    end
+
+  end
+
+end

data/lib/vas/gemfire/gemfire.rb

@@ -0,0 +1,47 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+  
+  # The entry point to the API for administering GemFire
+  class Gemfire
+
+    # The GemFire groups
+    attr_reader :groups
+
+    # The GemFire installation images
+    attr_reader :installation_images
+
+    # The GemFire nodes
+    attr_reader :nodes
+
+    # The GemFire application code images
+    attr_reader :application_code_images
+    
+    def initialize(location, client) #:nodoc:
+
+      json = client.get(location)
+      
+      @groups = Groups.new(Util::LinkUtils.get_link_href(json, "groups"), client)
+      @installation_images = InstallationImages.new(Util::LinkUtils.get_link_href(json, "installation-images"), client)
+      @nodes = Nodes.new(Util::LinkUtils.get_link_href(json, "nodes"), client)
+      @application_code_images = ApplicationCodeImages.new(Util::LinkUtils.get_link_href(json, "application-code-images"), client)
+
+    end
+    
+  end
+end

data/lib/vas/gemfire/groups.rb

@@ -0,0 +1,50 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate, create, and delete GemFire groups.
+  class Groups < Shared::Groups
+
+    def initialize(location, client) #:nodoc:#
+      super(location, client, Group)
+    end
+
+  end
+
+  # A tc Server group
+  class Group < Shared::MutableGroup
+
+    # The group's agent instances
+    attr_reader :agent_instances
+
+    # The group's cache server instances
+    attr_reader :cache_server_instances
+
+    # The group's locator instances
+    attr_reader :locator_instances
+
+    def initialize(location, client) #:nodoc:#
+      super(location, client, Node, Installations)
+      @agent_instances = AgentInstances.new(Util::LinkUtils.get_link_href(details, "agent-group-instances"), client)
+      @cache_server_instances = CacheServerInstances.new(Util::LinkUtils.get_link_href(details, "cache-server-group-instances"), client)
+      @locator_instances = LocatorInstances.new(Util::LinkUtils.get_link_href(details, "locator-group-instances"), client)
+    end
+
+  end
+
+end

data/lib/vas/gemfire/installation_images.rb

@@ -0,0 +1,38 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate, create, and delete GemFire installation images.
+  class InstallationImages < Shared::InstallationImages
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, InstallationImage)
+    end
+
+  end
+  
+  # A GemFire installation image
+  class InstallationImage < Shared::InstallationImage
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Installation)
+    end
+
+  end
+
+end

data/lib/vas/gemfire/installations.rb

@@ -0,0 +1,53 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate, create, and delete GemFire installations.
+  class Installations < Shared::Installations
+    
+    def initialize(location, client) #:nodoc:
+      super(location, client, Installation)
+    end
+    
+  end
+  
+  # A GemFire installation
+  class Installation < Shared::Installation
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, InstallationImage, Group)
+    end
+
+    # An array of the agent instances that are using the installation
+    def agent_instances
+      retrieve_instances("agent-group-instance", AgentInstance);
+    end
+
+    # An array of the agent instances that are using the installation
+    def cache_server_instances
+      retrieve_instances("cache-server-group-instance", CacheServerInstance);
+    end
+
+    # An array of the locator instances that are using the installation
+    def locator_instances
+      retrieve_instances("locator-group-instance", LocatorInstance);
+    end
+    
+  end
+  
+end

data/lib/vas/gemfire/live_application_codes.rb

@@ -0,0 +1,29 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate a cache server's live application code.
+  class LiveApplicationCodes < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "live-application-code", ApplicationCode)
+    end
+
+  end
+
+end

data/lib/vas/gemfire/locator_configuration.rb

@@ -0,0 +1,28 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # A configuration file in a locator instance
+  class LocatorConfiguration < Shared::Configuration
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "locator-group-instance", LocatorInstance)
+    end
+
+  end
+end

data/lib/vas/gemfire/locator_instances.rb

@@ -0,0 +1,109 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate, create, and delete locator instances.
+  class LocatorInstances < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "locator-group-instances", LocatorInstance)
+    end
+
+    # Creates a new instance named +name+, using the given +installation+.
+    # Creation can be customized using +options+.
+    #
+    # Recognized options are:
+    #
+    # peer::   +true+ if the locator should act as a peer, otherwise +false+. Defaults to +true+
+    # port::   The port on which the locator should listen. If omitted the locator will listen on the default port (10334)
+    # server:: +true+ if the locator should act as a server, otherwise +false+. Defaults to +true+
+    def create(installation, name, options = {})
+      payload = { :installation => installation.location, :name => name }
+
+      if options.has_key?(:peer)
+        payload[:peer] = options[:peer]
+      end
+
+      if options.has_key?(:port)
+        payload[:port] = options[:port]
+      end
+
+      if options.has_key?(:server)
+        payload[:server] = options[:server]
+      end
+
+      LocatorInstance.new(client.post(location, payload, "locator-group-instance"), client)
+    end
+
+  end
+
+  # A locator instance
+  class LocatorInstance < Shared::Instance
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Group, Installation, LocatorLiveConfigurations, LocatorPendingConfigurations, LocatorNodeInstance, 'locator-node-instance')
+    end
+
+    # Updates the instance using the supplied +options+.
+    #
+    # Recognized options are:
+    #
+    # installation:: The installation to use when running the locator instance. If omitted or nil, the installation configuration will not be changed
+    # peer::         Whether or not the locator will act as a peer. If omitted, the configuration will not be changed
+    # port::         The port on which the locator will listen. If omitted, the port configuration will not be changed
+    # server::       Whether or not the locator will act as a server. If omitted, the configuration will not be changed
+    def update(options)
+      payload = {}
+
+      if options.has_key?(:installation)
+        payload[:installation] = options[:installation].location
+      end
+
+      if options.has_key?(:peer)
+        payload[:peer] = options[:peer]
+      end
+
+      if options.has_key?(:port)
+        payload[:port] = options[:port]
+      end
+
+      if options.has_key?(:server)
+        payload[:server] = options[:server]
+      end
+
+      client.post(location, payload)
+    end
+
+    # The port that the locator will listen on
+    def port
+      client.get(location)['port']
+    end
+
+    # +true+ if the locator will act as a peer, +false+ if it will not
+    def peer
+      client.get(location)['peer']
+    end
+
+    # +true+ if the locator will act as a server, +false+ if it will not
+    def server
+      client.get(location)['server']
+    end
+
+  end
+
+end

data/lib/vas/gemfire/locator_live_configurations.rb

@@ -0,0 +1,29 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Gemfire
+
+  # Used to enumerate a locator instance's live configuration
+  class LocatorLiveConfigurations < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "live-configurations", LocatorConfiguration)
+    end
+
+  end
+
+end