The Old Toxophilist

Connecting Oracle SOA Suite to Java CAPS JMS

2011-11-17T17:59:00.003Z

Following a number of recent requests about connecting SOA Suite to existing SeeBeyond / Sun JMS I decided to put together this quick blog entry that describes the simple configuration required to successfully achieve this. The entry is based on a short document I originally wrote that described alternative connection options but JMS seems to be the most popular.

The key to connecting SOA Suite to STCMS (SeeBeyond JMS) is collecting the correct information about your JMS Instance and tracking down the appropriate jar file. This blog assumes the reader is running Java CAPS, but the concepts are the same for ICAN and e*Gate, and we will be simply using a Mediator to write a message to a JMS Queue.

Select JMS Adapter and then ThirdParty

Edit the factory properties as follows:

java.naming.provider.url : stcms://jcapsserver:18007
java.naming.factory.initial=com.stc.jms.jndispi.InitialContextFactory
java.naming.security.principal: Administrator
java.naming.security.credentials: STC

Now configure the JMS Connection information.

JMS Connection Factory : connectionfactories/queueconnectionfactory
JNDI Name : eis/Jms/JmsAdapter/Stcms/qLogging

Configure Message (Adapter)

Once the configuration is complete we need to define the Adapter Interface and in this example we will simply specify that we will specify it later. We do this because within the STCMS we will simply be passing an Opaque Type (Text Message).

Define Operation

Because we will be writing to the Queue we will define the Operation as a Produce Message.

Following this we will need to define the define the actual STCMS Queue name which is prefixed by jms/ to locate it within the Java CAPS server.

Define Message

Because we will be writing a simple log string to our Queue we will define the Message structure as Native format.

Mediator Configuration

We can now simply connect the JMS Connector to the Mediator as follows :

To successfully write to the Queue we will need to define the following properties for the connection:

Open Mediator and edit new service information. In Assign Values Set :

jca.jms.JMSType = TextMessage
jca.jms.JMSCorrelationID = 1234567890

Now we can simply copy contents to the Inbound on the Queue connection and these will be available for Java CAPS.

Integrating NetBeans MultiView with XAM/XDM based XML Object Model

2011-09-12T18:29:00.000+01:00

Overview

As part of my ongoing side-line work with the NetBeans Coherence Module I have finally had the time to reimplement the GUI Editor associated with the Coherence pof-config.xml file. As you may remember from my previous entry "Implementing XML Object Model based on XAM/XDM" I converted my existing JAXB Implementation of the pof-config.xml to the NetBeans preferred XAM/XDM model. Now it is time to change GUI interface so that it uses this new XML Object Model. In addition because this will be shipped post NetBeans 7.1 I decided to use the new NetBeans MultiView functionality.

Creating the MultiView

To create the XML MultiView component we first need a standard NetBeans Module Project with a base path (package), in my case, of org.netbeans.modules.coherence and in addition I have created the package org.netbeans.coherence.editor.pof for the MultiView classes and org.netbeans.modules.coherence.resources.icons for the icons associated with the file type. To create a MultiView Editor in 7.1 is simplicity itself and can be done by following the instructions below.

Create New File Type:

MIME Type : text/coh-pof+xml
Namespace : http://xmlns.oracle.com/coherence/coherence-pof-config

Next
Name, Icon and Location

Class Name Prefix : PofConfig
Icon : Path to pof file icon
MultiView : checked (This is a new feature of NetBeans 7.1)
Package : org.netbeans.modules.coherence.editor.pof

Finish

This will create two Java files, in addition to a number of xml files :

PofConfigDataObject.java
PofConfigVisualElement.java (.form)

These two files provide all the base functionality to implement the MultiView functionality for the pof-config.xml file.

PofConfigDataObject.java

 1 /*
 2  * To change this template, choose Tools | Templates and open the template in
 3  * the editor.
 4  */
 5 package org.netbeans.modules.coherence.editor.pof;
 6 
 7 import java.io.IOException;
 8 import org.netbeans.core.spi.multiview.MultiViewElement;
 9 import org.netbeans.core.spi.multiview.text.MultiViewEditorElement;
10 import org.openide.filesystems.FileObject;
11 import org.openide.loaders.DataObjectExistsException;
12 import org.openide.loaders.MultiDataObject;
13 import org.openide.loaders.MultiFileLoader;
14 import org.openide.util.Lookup;
15 import org.openide.windows.TopComponent;
16 
17 public class PofConfigDataObject extends MultiDataObject {
18 
19     public PofConfigDataObject(FileObject pf, MultiFileLoader loader) throws DataObjectExistsException, IOException {
20         super(pf, loader);
21         registerEditor("text/coh-pof+xml", true);
22     }
23 
24     @Override
25     protected int associateLookup() {
26         return 1;
27     }
28 
29     @MultiViewElement.Registration(displayName = "#LBL_PofConfig_EDITOR",
30     iconBase = "org/netbeans/modules/coherence/resources/icons/pof.png",
31     mimeType = "text/coh-pof+xml",
32     persistenceType = TopComponent.PERSISTENCE_ONLY_OPENED,
33     preferredID = "PofConfig",
34     position = 1000)
35     public static MultiViewEditorElement createEditor(Lookup lkp) {
36         return new MultiViewEditorElement(lkp);
37     }
38 }
39 
40

PofConfigVisualElement.java

  1 /*
  2  * To change this template, choose Tools | Templates and open the template in
  3  * the editor.
  4  */
  5 package org.netbeans.modules.coherence.editor.pof;
  6 
  7 import javax.swing.Action;
  8 import javax.swing.JComponent;
  9 import javax.swing.JPanel;
 10 import javax.swing.JToolBar;
 11 import org.netbeans.core.spi.multiview.CloseOperationState;
 12 import org.netbeans.core.spi.multiview.MultiViewElement;
 13 import org.netbeans.core.spi.multiview.MultiViewElementCallback;
 14 import org.openide.awt.UndoRedo;
 15 import org.openide.util.Lookup;
 16 import org.openide.util.NbBundle.Messages;
 17 import org.openide.windows.TopComponent;
 18 
 19 @MultiViewElement.Registration(displayName = "#LBL_PofConfig_VISUAL",
 20 iconBase = "org/netbeans/modules/coherence/resources/icons/pof.png",
 21 mimeType = "text/coh-pof+xml",
 22 persistenceType = TopComponent.PERSISTENCE_NEVER,
 23 preferredID = "PofConfigVisual",
 24 position = 2000)
 25 @Messages({
 26     "LBL_PofConfig_VISUAL=Visual"
 27 })
 28 public final class PofConfigVisualElement extends JPanel implements MultiViewElement {
 29 
 30     private PofConfigDataObject obj;
 31     private JToolBar toolbar = new JToolBar();
 32     private transient MultiViewElementCallback callback;
 33 
 34     public PofConfigVisualElement(Lookup lkp) {
 35         obj = lkp.lookup(PofConfigDataObject.class);
 36         assert obj != null;
 37         initComponents();
 38     }
 39 
 40     @Override
 41     public String getName() {
 42         return "PofConfigVisualElement";
 43     }
 44 
 45     /** This method is called from within the constructor to
 46      * initialize the form.
 47      * WARNING: Do NOT modify this code. The content of this method is
 48      * always regenerated by the Form Editor.
 49      */
 50     //                           
 51     private void initComponents() {
 52 
 53         javax.swing.GroupLayout layout = new javax.swing.GroupLayout(this);
 54         this.setLayout(layout);
 55         layout.setHorizontalGroup(
 56             layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 57             .addGap(0, 400, Short.MAX_VALUE)
 58         );
 59         layout.setVerticalGroup(
 60             layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 61             .addGap(0, 300, Short.MAX_VALUE)
 62         );
 63     }//                         
 64 
 65     // Variables declaration - do not modify                     
 66     // End of variables declaration                   
 67     @Override
 68     public JComponent getVisualRepresentation() {
 69         return this;
 70     }
 71 
 72     @Override
 73     public JComponent getToolbarRepresentation() {
 74         return toolbar;
 75     }
 76 
 77     @Override
 78     public Action[] getActions() {
 79         return new Action[0];
 80     }
 81 
 82     @Override
 83     public Lookup getLookup() {
 84         return obj.getLookup();
 85     }
 86 
 87     @Override
 88     public void componentOpened() {
 89     }
 90 
 91     @Override
 92     public void componentClosed() {
 93     }
 94 
 95     @Override
 96     public void componentShowing() {
 97     }
 98 
 99     @Override
100     public void componentHidden() {
101     }
102 
103     @Override
104     public void componentActivated() {
105     }
106 
107     @Override
108     public void componentDeactivated() {
109     }
110 
111     @Override
112     public UndoRedo getUndoRedo() {
113         return UndoRedo.NONE;
114     }
115 
116     @Override
117     public void setMultiViewCallback(MultiViewElementCallback callback) {
118         this.callback = callback;
119     }
120 
121     @Override
122     public CloseOperationState canCloseElement() {
123         return CloseOperationState.STATE_OK;
124     }
125 }
126 
127

We now need to add the following libraries.

Now run the project and we will see that the pof-config.xml files have a green file icon and opening the file will initially display the "Source" view but we also have "Visual" tab that if selected will simply display an empty windows and this is because we have not added any visual components.

Extending the MultiView

Obviously an empty Visual Component is not what we want and so it is now time to edit the Visual component to display the XML in our chosen Visual Format. In addition we will change the name of the Visual component and place it first in the list. The end result will be as follows:

I will not go into detail about how to create the visual component but will assume the reader has created swing based NetBeans components before. The resulting code is displayed below.

PofConfigDataObject.java

 1 /*
 2  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 3  *
 4  * Copyright 2011 Oracle and/or its affiliates. All rights reserved.
 5  *
 6  * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 7  * Other names may be trademarks of their respective owners.
 8  *
 9  * The contents of this file are subject to the terms of either the GNU
10  * General Public License Version 2 only ("GPL") or the Common
11  * Development and Distribution License("CDDL") (collectively, the
12  * "License"). You may not use this file except in compliance with the
13  * License. You can obtain a copy of the License at
14  * http://www.netbeans.org/cddl-gplv2.html
15  * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
16  * specific language governing permissions and limitations under the
17  * License.  When distributing the software, include this License Header
18  * Notice in each file and include the License file at
19  * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
20  * particular file as subject to the "Classpath" exception as provided
21  * by Oracle in the GPL Version 2 section of the License file that
22  * accompanied this code. If applicable, add the following below the
23  * License Header, with the fields enclosed by brackets [] replaced by
24  * your own identifying information:
25  * "Portions Copyrighted [year] [name of copyright owner]"
26  *
27  * If you wish your version of this file to be governed by only the CDDL
28  * or only the GPL Version 2, indicate your decision by adding
29  * "[Contributor] elects to include this software in this distribution
30  * under the [CDDL or GPL Version 2] license." If you do not indicate a
31  * single choice of license, a recipient has the option to distribute
32  * your version of this file under either the CDDL, the GPL Version 2 or
33  * to extend the choice of license to its licensees as provided above.
34  * However, if you add GPL Version 2 code and therefore, elected the GPL
35  * Version 2 license, then the option applies only if the new code is
36  * made subject to such option by the copyright holder.
37  *
38  * Contributor(s):
39  *
40  * Portions Copyrighted 2011 Sun Microsystems, Inc.
41  */
42 package org.netbeans.modules.coherence.editor.pof;
43 
44 import java.io.IOException;
45 import org.netbeans.core.spi.multiview.MultiViewElement;
46 import org.netbeans.core.spi.multiview.text.MultiViewEditorElement;
47 import org.openide.filesystems.FileObject;
48 import org.openide.loaders.DataObjectExistsException;
49 import org.openide.loaders.MultiDataObject;
50 import org.openide.loaders.MultiFileLoader;
51 import org.openide.util.Lookup;
52 import org.openide.windows.TopComponent;
53 
54 /**
55  *
56  * @author Andrew Hopkinson (Oracle A-Team)
57  */
58 public class PofConfigDataObject extends MultiDataObject {
59 
60     public PofConfigDataObject(FileObject pf, MultiFileLoader loader) throws DataObjectExistsException, IOException {
61         super(pf, loader);
62         registerEditor("text/coh-pof+xml", true);
63     }
64 
65     @Override
66     protected int associateLookup() {
67         return 1;
68     }
69 
70     @MultiViewElement.Registration(displayName = "#LBL_PofConfig_EDITOR",
71     iconBase = "org/netbeans/modules/coherence/resources/icons/pof.png",
72     mimeType = "text/coh-pof+xml",
73     persistenceType = TopComponent.PERSISTENCE_ONLY_OPENED,
74     preferredID = "PofConfig",
75     position = 2000)
76     public static MultiViewEditorElement createEditor(Lookup lkp) {
77         return new MultiViewEditorElement(lkp);
78     }
79 }
80 
81

PofConfigVisualElement.java

   1 /*
   2  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
   3  *
   4  * Copyright 2011 Oracle and/or its affiliates. All rights reserved.
   5  *
   6  * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
   7  * Other names may be trademarks of their respective owners.
   8  *
   9  * The contents of this file are subject to the terms of either the GNU
  10  * General Public License Version 2 only ("GPL") or the Common
  11  * Development and Distribution License("CDDL") (collectively, the
  12  * "License"). You may not use this file except in compliance with the
  13  * License. You can obtain a copy of the License at
  14  * http://www.netbeans.org/cddl-gplv2.html
  15  * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
  16  * specific language governing permissions and limitations under the
  17  * License.  When distributing the software, include this License Header
  18  * Notice in each file and include the License file at
  19  * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
  20  * particular file as subject to the "Classpath" exception as provided
  21  * by Oracle in the GPL Version 2 section of the License file that
  22  * accompanied this code. If applicable, add the following below the
  23  * License Header, with the fields enclosed by brackets [] replaced by
  24  * your own identifying information:
  25  * "Portions Copyrighted [year] [name of copyright owner]"
  26  *
  27  * If you wish your version of this file to be governed by only the CDDL
  28  * or only the GPL Version 2, indicate your decision by adding
  29  * "[Contributor] elects to include this software in this distribution
  30  * under the [CDDL or GPL Version 2] license." If you do not indicate a
  31  * single choice of license, a recipient has the option to distribute
  32  * your version of this file under either the CDDL, the GPL Version 2 or
  33  * to extend the choice of license to its licensees as provided above.
  34  * However, if you add GPL Version 2 code and therefore, elected the GPL
  35  * Version 2 license, then the option applies only if the new code is
  36  * made subject to such option by the copyright holder.
  37  *
  38  * Contributor(s):
  39  *
  40  * Portions Copyrighted 2011 Sun Microsystems, Inc.
  41  */
  42 package org.netbeans.modules.coherence.editor.pof;
  43 
  44 import com.sun.istack.logging.Logger;
  45 import java.util.ArrayList;
  46 import java.util.List;
  47 import java.util.logging.Level;
  48 import javax.swing.Action;
  49 import javax.swing.JComponent;
  50 import javax.swing.JOptionPane;
  51 import javax.swing.JPanel;
  52 import javax.swing.JToolBar;
  53 import javax.swing.event.ListSelectionEvent;
  54 import javax.swing.event.ListSelectionListener;
  55 import javax.swing.event.TableModelEvent;
  56 import javax.swing.event.TableModelListener;
  57 import javax.swing.table.AbstractTableModel;
  58 import org.jdesktop.beansbinding.AutoBinding.UpdateStrategy;
  59 import org.jdesktop.beansbinding.BeanProperty;
  60 import org.jdesktop.beansbinding.Binding;
  61 import org.jdesktop.beansbinding.Binding.SyncFailure;
  62 import org.jdesktop.beansbinding.BindingGroup;
  63 import org.jdesktop.beansbinding.BindingListener;
  64 import org.jdesktop.beansbinding.Bindings;
  65 import org.jdesktop.beansbinding.Property;
  66 import org.jdesktop.beansbinding.PropertyStateEvent;
  67 import org.netbeans.core.spi.multiview.CloseOperationState;
  68 import org.netbeans.core.spi.multiview.MultiViewElement;
  69 import org.netbeans.core.spi.multiview.MultiViewElementCallback;
  70 import org.netbeans.modules.coherence.xml.pof.PofConfig;
  71 import org.netbeans.modules.coherence.xml.pof.PofConfigComponentFactory;
  72 import org.netbeans.modules.coherence.xml.pof.PofConfigModel;
  73 import org.netbeans.modules.coherence.xml.pof.PofConfigModelFactory;
  74 import org.netbeans.modules.coherence.xml.pof.Serializer;
  75 import org.netbeans.modules.coherence.xml.pof.UserType;
  76 import org.netbeans.modules.coherence.xml.pof.UserTypeList;
  77 import org.netbeans.modules.coherence.xml.pof.ValueNotPermittedException;
  78 import org.netbeans.modules.xml.retriever.catalog.Utilities;
  79 import org.netbeans.modules.xml.xam.ModelSource;
  80 import org.openide.awt.StatusDisplayer;
  81 import org.openide.awt.UndoRedo;
  82 import org.openide.util.Exceptions;
  83 import org.openide.util.Lookup;
  84 import org.openide.util.NbBundle.Messages;
  85 import org.openide.windows.TopComponent;
  86 
  87 @MultiViewElement.Registration(displayName = "#LBL_PofConfig_VISUAL",
  88 iconBase = "org/netbeans/modules/coherence/resources/icons/pof.png",
  89 mimeType = "text/coh-pof+xml",
  90 persistenceType = TopComponent.PERSISTENCE_NEVER,
  91 preferredID = "PofConfigVisual",
  92 position = 1000)
  93 @Messages({
  94     "LBL_PofConfig_VISUAL=General"
  95 })
  96 /**
  97  *
  98  * @author Andrew Hopkinson (Oracle A-Team)
  99  */
 100 public final class PofConfigVisualElement extends JPanel implements MultiViewElement, TableModelListener, ListSelectionListener, BindingListener {
 101 
 102     private PofConfigDataObject obj;
 103     private JToolBar toolbar = new JToolBar();
 104     private transient MultiViewElementCallback callback;
 105 
 106     public PofConfigVisualElement(Lookup lkp) {
 107         obj = lkp.lookup(PofConfigDataObject.class);
 108         assert obj != null;
 109         initComponents();
 110         initialise();
 111     }
 112 
 113     @Override
 114     public String getName() {
 115         return "PofConfigVisualElement";
 116     }
 117 
 118     /** This method is called from within the constructor to
 119      * initialize the form.
 120      * WARNING: Do NOT modify this code. The content of this method is
 121      * always regenerated by the Form Editor.
 122      */
 123     //                           
 124     private void initComponents() {
 125 
 126         jScrollPane3 = new javax.swing.JScrollPane();
 127         topPanel = new javax.swing.JPanel();
 128         generalPanel = new javax.swing.JPanel();
 129         jPanel9 = new javax.swing.JPanel();
 130         jToggleButton1 = new javax.swing.JToggleButton();
 131         jPanel2 = new javax.swing.JPanel();
 132         cbAllowInterfaces = new javax.swing.JCheckBox();
 133         cbAllowSubclesses = new javax.swing.JCheckBox();
 134         jPanel7 = new javax.swing.JPanel();
 135         jLabel1 = new javax.swing.JLabel();
 136         tfClassName = new javax.swing.JTextField();
 137         standardPanel = new javax.swing.JPanel();
 138         jPanel3 = new javax.swing.JPanel();
 139         jToggleButton2 = new javax.swing.JToggleButton();
 140         jPanel4 = new javax.swing.JPanel();
 141         jScrollPane1 = new javax.swing.JScrollPane();
 142         tabStandardUT = new javax.swing.JTable();
 143         customPanel = new javax.swing.JPanel();
 144         jPanel5 = new javax.swing.JPanel();
 145         jToggleButton3 = new javax.swing.JToggleButton();
 146         jPanel6 = new javax.swing.JPanel();
 147         jScrollPane2 = new javax.swing.JScrollPane();
 148         tabCustomUT = new javax.swing.JTable();
 149         jPanel8 = new javax.swing.JPanel();
 150         btnAdd = new javax.swing.JButton();
 151         btnEdit = new javax.swing.JButton();
 152         btnRemove = new javax.swing.JButton();
 153         jPanel1 = new javax.swing.JPanel();
 154         btnEditImage = new javax.swing.JButton();
 155         btnAddImage = new javax.swing.JButton();
 156         btnDeleteImage = new javax.swing.JButton();
 157 
 158         jToggleButton1.setSelected(true);
 159         org.openide.awt.Mnemonics.setLocalizedText(jToggleButton1, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.jToggleButton1.text")); // NOI18N
 160         jToggleButton1.setHorizontalAlignment(javax.swing.SwingConstants.LEADING);
 161         jToggleButton1.addActionListener(new java.awt.event.ActionListener() {
 162             public void actionPerformed(java.awt.event.ActionEvent evt) {
 163                 jToggleButton1ActionPerformed(evt);
 164             }
 165         });
 166 
 167         org.openide.awt.Mnemonics.setLocalizedText(cbAllowInterfaces, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.cbAllowInterfaces.text")); // NOI18N
 168 
 169         org.openide.awt.Mnemonics.setLocalizedText(cbAllowSubclesses, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.cbAllowSubclesses.text")); // NOI18N
 170 
 171         jPanel7.setBorder(javax.swing.BorderFactory.createTitledBorder(org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.jPanel7.border.title"))); // NOI18N
 172 
 173         org.openide.awt.Mnemonics.setLocalizedText(jLabel1, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.jLabel1.text")); // NOI18N
 174 
 175         javax.swing.GroupLayout jPanel7Layout = new javax.swing.GroupLayout(jPanel7);
 176         jPanel7.setLayout(jPanel7Layout);
 177         jPanel7Layout.setHorizontalGroup(
 178             jPanel7Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 179             .addGroup(jPanel7Layout.createSequentialGroup()
 180                 .addContainerGap()
 181                 .addComponent(jLabel1)
 182                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.UNRELATED)
 183                 .addComponent(tfClassName, javax.swing.GroupLayout.DEFAULT_SIZE, 417, Short.MAX_VALUE))
 184         );
 185         jPanel7Layout.setVerticalGroup(
 186             jPanel7Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 187             .addGroup(jPanel7Layout.createSequentialGroup()
 188                 .addGroup(jPanel7Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.BASELINE)
 189                     .addComponent(jLabel1)
 190                     .addComponent(tfClassName, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE))
 191                 .addContainerGap(javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 192         );
 193 
 194         javax.swing.GroupLayout jPanel2Layout = new javax.swing.GroupLayout(jPanel2);
 195         jPanel2.setLayout(jPanel2Layout);
 196         jPanel2Layout.setHorizontalGroup(
 197             jPanel2Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 198             .addGroup(jPanel2Layout.createSequentialGroup()
 199                 .addContainerGap()
 200                 .addGroup(jPanel2Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 201                     .addComponent(cbAllowInterfaces)
 202                     .addComponent(cbAllowSubclesses)
 203                     .addComponent(jPanel7, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE))
 204                 .addContainerGap(22, Short.MAX_VALUE))
 205         );
 206         jPanel2Layout.setVerticalGroup(
 207             jPanel2Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 208             .addGroup(jPanel2Layout.createSequentialGroup()
 209                 .addComponent(cbAllowInterfaces)
 210                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.UNRELATED)
 211                 .addComponent(cbAllowSubclesses)
 212                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 213                 .addComponent(jPanel7, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 214                 .addContainerGap(15, Short.MAX_VALUE))
 215         );
 216 
 217         javax.swing.GroupLayout jPanel9Layout = new javax.swing.GroupLayout(jPanel9);
 218         jPanel9.setLayout(jPanel9Layout);
 219         jPanel9Layout.setHorizontalGroup(
 220             jPanel9Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 221             .addGroup(jPanel9Layout.createSequentialGroup()
 222                 .addGap(10, 10, 10)
 223                 .addComponent(jPanel2, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 224                 .addContainerGap(75, Short.MAX_VALUE))
 225             .addComponent(jToggleButton1, javax.swing.GroupLayout.DEFAULT_SIZE, 628, Short.MAX_VALUE)
 226         );
 227         jPanel9Layout.setVerticalGroup(
 228             jPanel9Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 229             .addGroup(jPanel9Layout.createSequentialGroup()
 230                 .addComponent(jToggleButton1)
 231                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 232                 .addComponent(jPanel2, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 233         );
 234 
 235         javax.swing.GroupLayout generalPanelLayout = new javax.swing.GroupLayout(generalPanel);
 236         generalPanel.setLayout(generalPanelLayout);
 237         generalPanelLayout.setHorizontalGroup(
 238             generalPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 239             .addComponent(jPanel9, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 240         );
 241         generalPanelLayout.setVerticalGroup(
 242             generalPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 243             .addComponent(jPanel9, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 244         );
 245 
 246         org.openide.awt.Mnemonics.setLocalizedText(jToggleButton2, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.jToggleButton2.text")); // NOI18N
 247         jToggleButton2.setHorizontalAlignment(javax.swing.SwingConstants.LEADING);
 248         jToggleButton2.addActionListener(new java.awt.event.ActionListener() {
 249             public void actionPerformed(java.awt.event.ActionEvent evt) {
 250                 jToggleButton2ActionPerformed(evt);
 251             }
 252         });
 253 
 254         javax.swing.GroupLayout jPanel3Layout = new javax.swing.GroupLayout(jPanel3);
 255         jPanel3.setLayout(jPanel3Layout);
 256         jPanel3Layout.setHorizontalGroup(
 257             jPanel3Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 258             .addComponent(jToggleButton2, javax.swing.GroupLayout.DEFAULT_SIZE, 628, Short.MAX_VALUE)
 259         );
 260         jPanel3Layout.setVerticalGroup(
 261             jPanel3Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 262             .addComponent(jToggleButton2)
 263         );
 264 
 265         tabStandardUT.setModel(getStandardUserTypes());
 266         tabStandardUT.setFillsViewportHeight(true);
 267         jScrollPane1.setViewportView(tabStandardUT);
 268 
 269         javax.swing.GroupLayout jPanel4Layout = new javax.swing.GroupLayout(jPanel4);
 270         jPanel4.setLayout(jPanel4Layout);
 271         jPanel4Layout.setHorizontalGroup(
 272             jPanel4Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 273             .addComponent(jScrollPane1, javax.swing.GroupLayout.DEFAULT_SIZE, 628, Short.MAX_VALUE)
 274         );
 275         jPanel4Layout.setVerticalGroup(
 276             jPanel4Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 277             .addComponent(jScrollPane1, javax.swing.GroupLayout.DEFAULT_SIZE, 159, Short.MAX_VALUE)
 278         );
 279 
 280         javax.swing.GroupLayout standardPanelLayout = new javax.swing.GroupLayout(standardPanel);
 281         standardPanel.setLayout(standardPanelLayout);
 282         standardPanelLayout.setHorizontalGroup(
 283             standardPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 284             .addComponent(jPanel4, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 285             .addComponent(jPanel3, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 286         );
 287         standardPanelLayout.setVerticalGroup(
 288             standardPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 289             .addGroup(standardPanelLayout.createSequentialGroup()
 290                 .addComponent(jPanel3, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 291                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 292                 .addComponent(jPanel4, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE))
 293         );
 294 
 295         org.openide.awt.Mnemonics.setLocalizedText(jToggleButton3, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.jToggleButton3.text")); // NOI18N
 296         jToggleButton3.setHorizontalAlignment(javax.swing.SwingConstants.LEADING);
 297         jToggleButton3.addActionListener(new java.awt.event.ActionListener() {
 298             public void actionPerformed(java.awt.event.ActionEvent evt) {
 299                 jToggleButton3ActionPerformed(evt);
 300             }
 301         });
 302 
 303         javax.swing.GroupLayout jPanel5Layout = new javax.swing.GroupLayout(jPanel5);
 304         jPanel5.setLayout(jPanel5Layout);
 305         jPanel5Layout.setHorizontalGroup(
 306             jPanel5Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 307             .addComponent(jToggleButton3, javax.swing.GroupLayout.DEFAULT_SIZE, 628, Short.MAX_VALUE)
 308         );
 309         jPanel5Layout.setVerticalGroup(
 310             jPanel5Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 311             .addGroup(jPanel5Layout.createSequentialGroup()
 312                 .addComponent(jToggleButton3)
 313                 .addContainerGap(javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 314         );
 315 
 316         tabCustomUT.setModel(getCustomUserTypes());
 317         tabCustomUT.setFillsViewportHeight(true);
 318         jScrollPane2.setViewportView(tabCustomUT);
 319 
 320         org.openide.awt.Mnemonics.setLocalizedText(btnAdd, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.btnAdd.text")); // NOI18N
 321         btnAdd.addActionListener(new java.awt.event.ActionListener() {
 322             public void actionPerformed(java.awt.event.ActionEvent evt) {
 323                 btnAddActionPerformed(evt);
 324             }
 325         });
 326 
 327         org.openide.awt.Mnemonics.setLocalizedText(btnEdit, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.btnEdit.text")); // NOI18N
 328         btnEdit.setEnabled(false);
 329         btnEdit.addActionListener(new java.awt.event.ActionListener() {
 330             public void actionPerformed(java.awt.event.ActionEvent evt) {
 331                 btnEditActionPerformed(evt);
 332             }
 333         });
 334 
 335         org.openide.awt.Mnemonics.setLocalizedText(btnRemove, org.openide.util.NbBundle.getMessage(PofConfigVisualElement.class, "PofConfigVisualElement.btnRemove.text")); // NOI18N
 336         btnRemove.setEnabled(false);
 337         btnRemove.addActionListener(new java.awt.event.ActionListener() {
 338             public void actionPerformed(java.awt.event.ActionEvent evt) {
 339                 btnRemoveActionPerformed(evt);
 340             }
 341         });
 342 
 343         javax.swing.GroupLayout jPanel8Layout = new javax.swing.GroupLayout(jPanel8);
 344         jPanel8.setLayout(jPanel8Layout);
 345         jPanel8Layout.setHorizontalGroup(
 346             jPanel8Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 347             .addGroup(jPanel8Layout.createSequentialGroup()
 348                 .addContainerGap()
 349                 .addComponent(btnAdd)
 350                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 351                 .addComponent(btnEdit)
 352                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 353                 .addComponent(btnRemove)
 354                 .addContainerGap(javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 355         );
 356         jPanel8Layout.setVerticalGroup(
 357             jPanel8Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 358             .addGroup(jPanel8Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.BASELINE)
 359                 .addComponent(btnAdd)
 360                 .addComponent(btnEdit)
 361                 .addComponent(btnRemove))
 362         );
 363 
 364         btnEditImage.setBorderPainted(false);
 365         btnEditImage.setContentAreaFilled(false);
 366         btnEditImage.setEnabled(false);
 367         btnEditImage.setMargin(new java.awt.Insets(2, 2, 2, 2));
 368         btnEditImage.addActionListener(new java.awt.event.ActionListener() {
 369             public void actionPerformed(java.awt.event.ActionEvent evt) {
 370                 btnEditImageActionPerformed(evt);
 371             }
 372         });
 373 
 374         btnAddImage.setBorderPainted(false);
 375         btnAddImage.setContentAreaFilled(false);
 376         btnAddImage.setMargin(new java.awt.Insets(2, 2, 2, 2));
 377         btnAddImage.addActionListener(new java.awt.event.ActionListener() {
 378             public void actionPerformed(java.awt.event.ActionEvent evt) {
 379                 btnAddImageActionPerformed(evt);
 380             }
 381         });
 382 
 383         btnDeleteImage.setBorderPainted(false);
 384         btnDeleteImage.setContentAreaFilled(false);
 385         btnDeleteImage.setEnabled(false);
 386         btnDeleteImage.setMargin(new java.awt.Insets(2, 2, 2, 2));
 387         btnDeleteImage.addActionListener(new java.awt.event.ActionListener() {
 388             public void actionPerformed(java.awt.event.ActionEvent evt) {
 389                 btnDeleteImageActionPerformed(evt);
 390             }
 391         });
 392 
 393         javax.swing.GroupLayout jPanel1Layout = new javax.swing.GroupLayout(jPanel1);
 394         jPanel1.setLayout(jPanel1Layout);
 395         jPanel1Layout.setHorizontalGroup(
 396             jPanel1Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 397             .addComponent(btnEditImage)
 398             .addComponent(btnAddImage)
 399             .addComponent(btnDeleteImage)
 400         );
 401         jPanel1Layout.setVerticalGroup(
 402             jPanel1Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 403             .addGroup(jPanel1Layout.createSequentialGroup()
 404                 .addComponent(btnAddImage)
 405                 .addGap(6, 6, 6)
 406                 .addComponent(btnEditImage)
 407                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 408                 .addComponent(btnDeleteImage)
 409                 .addContainerGap(43, Short.MAX_VALUE))
 410         );
 411 
 412         javax.swing.GroupLayout jPanel6Layout = new javax.swing.GroupLayout(jPanel6);
 413         jPanel6.setLayout(jPanel6Layout);
 414         jPanel6Layout.setHorizontalGroup(
 415             jPanel6Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 416             .addGroup(jPanel6Layout.createSequentialGroup()
 417                 .addGroup(jPanel6Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 418                     .addComponent(jPanel8, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 419                     .addGroup(javax.swing.GroupLayout.Alignment.TRAILING, jPanel6Layout.createSequentialGroup()
 420                         .addComponent(jScrollPane2, javax.swing.GroupLayout.DEFAULT_SIZE, 603, Short.MAX_VALUE)
 421                         .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 422                         .addComponent(jPanel1, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)))
 423                 .addContainerGap())
 424         );
 425         jPanel6Layout.setVerticalGroup(
 426             jPanel6Layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 427             .addGroup(javax.swing.GroupLayout.Alignment.TRAILING, jPanel6Layout.createSequentialGroup()
 428                 .addComponent(jScrollPane2, javax.swing.GroupLayout.DEFAULT_SIZE, 266, Short.MAX_VALUE)
 429                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 430                 .addComponent(jPanel8, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE))
 431             .addGroup(jPanel6Layout.createSequentialGroup()
 432                 .addComponent(jPanel1, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 433                 .addContainerGap())
 434         );
 435 
 436         javax.swing.GroupLayout customPanelLayout = new javax.swing.GroupLayout(customPanel);
 437         customPanel.setLayout(customPanelLayout);
 438         customPanelLayout.setHorizontalGroup(
 439             customPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 440             .addComponent(jPanel5, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 441             .addComponent(jPanel6, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 442         );
 443         customPanelLayout.setVerticalGroup(
 444             customPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 445             .addGroup(customPanelLayout.createSequentialGroup()
 446                 .addComponent(jPanel5, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 447                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 448                 .addComponent(jPanel6, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 449         );
 450 
 451         javax.swing.GroupLayout topPanelLayout = new javax.swing.GroupLayout(topPanel);
 452         topPanel.setLayout(topPanelLayout);
 453         topPanelLayout.setHorizontalGroup(
 454             topPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 455             .addComponent(standardPanel, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 456             .addComponent(generalPanel, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 457             .addComponent(customPanel, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
 458         );
 459         topPanelLayout.setVerticalGroup(
 460             topPanelLayout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 461             .addGroup(topPanelLayout.createSequentialGroup()
 462                 .addComponent(generalPanel, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 463                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 464                 .addComponent(standardPanel, javax.swing.GroupLayout.PREFERRED_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.PREFERRED_SIZE)
 465                 .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)
 466                 .addComponent(customPanel, javax.swing.GroupLayout.DEFAULT_SIZE, javax.swing.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
 467         );
 468 
 469         jScrollPane3.setViewportView(topPanel);
 470 
 471         javax.swing.GroupLayout layout = new javax.swing.GroupLayout(this);
 472         this.setLayout(layout);
 473         layout.setHorizontalGroup(
 474             layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 475             .addGap(0, 400, Short.MAX_VALUE)
 476             .addGroup(layout.createSequentialGroup()
 477                 .addContainerGap()
 478                 .addComponent(jScrollPane3, javax.swing.GroupLayout.DEFAULT_SIZE, 390, Short.MAX_VALUE))
 479         );
 480         layout.setVerticalGroup(
 481             layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
 482             .addGap(0, 300, Short.MAX_VALUE)
 483             .addComponent(jScrollPane3, javax.swing.GroupLayout.DEFAULT_SIZE, 300, Short.MAX_VALUE)
 484         );
 485     }//                         
 486 
 487 private void jToggleButton1ActionPerformed(java.awt.event.ActionEvent evt) {                                               
 488     jPanel2.setVisible(jToggleButton1.isSelected());
 489 }                                              
 490 
 491 private void jToggleButton2ActionPerformed(java.awt.event.ActionEvent evt) {                                               
 492     jPanel4.setVisible(jToggleButton2.isSelected());
 493 }                                              
 494 
 495 private void jToggleButton3ActionPerformed(java.awt.event.ActionEvent evt) {                                               
 496     jPanel6.setVisible(jToggleButton3.isSelected());
 497 }                                              
 498 
 499 private void btnAddActionPerformed(java.awt.event.ActionEvent evt) {                                       
 500     java.awt.EventQueue.invokeLater(new Runnable() {
 501 
 502         public void run() {
 503             EditUserTypeDialog dialog = new EditUserTypeDialog(null, true, null);
 504             dialog.setLocationRelativeTo(null);
 505             dialog.setVisible(true);
 506             if (dialog.getReturnStatus() == dialog.RET_OK) {
 507                 getModel().startTransaction();
 508                 try {
 509                     UserType ut = getFactory().createUserType();
 510                     ut.setClassName(getFactory().createClassName());
 511                     ut.getClassName().setValue(dialog.getClassname());
 512                     ut.setTypeId(getFactory().createTypeId());
 513                     ut.getTypeId().setValue(Integer.parseInt(dialog.getTypeId()));
 514                     String serializer = dialog.getSerializerClassname();
 515                     if (serializer != null & serializer.trim().length() > 0) {
 516                         Serializer utSerializer = getFactory().createSerializer();
 517                         utSerializer.setClassName(getFactory().createClassName());
 518                         utSerializer.getClassName().setValue(serializer);
 519                         ut.setSerializer(utSerializer);
 520                     }
 521                     PofConfig pofConfig = getPofConfig();
 522                     pofConfig.getUserTypeList().addElement(ut);
 523                     customUserTypes.addRow(ut.getTypeId().getValue(), ut.getClassName().getValue(), serializer, ut);
 524                     setModified();
 525                     //                    serialize();
 526                 } catch (ValueNotPermittedException ex) {
 527                     Exceptions.printStackTrace(ex);
 528                 }
 529                 getModel().endTransaction();
 530             }
 531         }
 532     });
 533 }                                      
 534 
 535 private void btnEditActionPerformed(java.awt.event.ActionEvent evt) {                                        
 536     java.awt.EventQueue.invokeLater(new Runnable() {
 537 
 538         public void run() {
 539             int rowNum = tabCustomUT.getSelectedRow();
 540             UserType ut = (UserType) customUserTypes.getUserType(rowNum);
 541             EditUserTypeDialog dialog = new EditUserTypeDialog(null, true, ut);
 542             dialog.setLocationRelativeTo(null);
 543             dialog.setVisible(true);
 544             if (dialog.getReturnStatus() == dialog.RET_OK) {
 545                 getModel().startTransaction();
 546                 try {
 547                     ut.getClassName().setValue(dialog.getClassname());
 548                     ut.getTypeId().setValue(Integer.parseInt(dialog.getTypeId()));
 549                     String serializer = dialog.getSerializerClassname();
 550                     if (serializer != null & serializer.trim().length() > 0) {
 551                         Serializer utSerializer = getFactory().createSerializer();
 552                         if (utSerializer.getClassName() == null) {
 553                             utSerializer.setClassName(getFactory().createClassName());
 554                         }
 555                         utSerializer.getClassName().setValue(serializer);
 556                         ut.setSerializer(utSerializer);
 557                     }
 558                     //                    PofConfig pofConfig = getPofConfig();
 559                     //                    pofConfig.getUserTypeList().getUserTypeOrInclude().add(ut);
 560                     customUserTypes.updateRow(rowNum, ut.getTypeId().getValue(), ut.getClassName().getValue(), serializer);
 561                     setModified();
 562                     //                    serialize();
 563                 } catch (ValueNotPermittedException ex) {
 564                     Exceptions.printStackTrace(ex);
 565                 }
 566                 getModel().endTransaction();
 567             }
 568         }
 569     });
 570 }                                       
 571 
 572 private void btnRemoveActionPerformed(java.awt.event.ActionEvent evt) {                                          
 573     java.awt.EventQueue.invokeLater(new Runnable() {
 574 
 575         public void run() {
 576             int option = JOptionPane.showConfirmDialog(customPanel, "Please Confirm User Type Removal", "", JOptionPane.OK_CANCEL_OPTION);
 577             if (option == JOptionPane.OK_OPTION) {
 578                 int rowNum = tabCustomUT.getSelectedRow();
 579                 UserType ut = (UserType) customUserTypes.getUserType(rowNum);
 580                 customUserTypes.removeRow(rowNum);
 581 
 582                 getModel().startTransaction();
 583                 for (UserType xmlUT : getPofConfig().getUserTypeList().getUserTypes()) {
 584                     if (xmlUT.getTypeId().equals(ut.getTypeId()) && xmlUT.getClassName().equals(ut.getClassName())) {
 585                         getPofConfig().getUserTypeList().removeElement(xmlUT);
 586                         break;
 587                     }
 588                 }
 589                 setModified();
 590                 getModel().endTransaction();
 591 //                    serialize();
 592             }
 593         }
 594     });
 595 }                                         
 596 
 597 private void btnEditImageActionPerformed(java.awt.event.ActionEvent evt) {                                             
 598     btnEditActionPerformed(evt);
 599 }                                            
 600 
 601 private void btnAddImageActionPerformed(java.awt.event.ActionEvent evt) {                                            
 602     btnAddActionPerformed(evt);
 603 }                                           
 604 
 605 private void btnDeleteImageActionPerformed(java.awt.event.ActionEvent evt) {                                               
 606     btnRemoveActionPerformed(evt);
 607 }                                              
 608     // Variables declaration - do not modify                     
 609     private javax.swing.JButton btnAdd;
 610     private javax.swing.JButton btnAddImage;
 611     private javax.swing.JButton btnDeleteImage;
 612     private javax.swing.JButton btnEdit;
 613     private javax.swing.JButton btnEditImage;
 614     private javax.swing.JButton btnRemove;
 615     private javax.swing.JCheckBox cbAllowInterfaces;
 616     private javax.swing.JCheckBox cbAllowSubclesses;
 617     private javax.swing.JPanel customPanel;
 618     private javax.swing.JPanel generalPanel;
 619     private javax.swing.JLabel jLabel1;
 620     private javax.swing.JPanel jPanel1;
 621     private javax.swing.JPanel jPanel2;
 622     private javax.swing.JPanel jPanel3;
 623     private javax.swing.JPanel jPanel4;
 624     private javax.swing.JPanel jPanel5;
 625     private javax.swing.JPanel jPanel6;
 626     private javax.swing.JPanel jPanel7;
 627     private javax.swing.JPanel jPanel8;
 628     private javax.swing.JPanel jPanel9;
 629     private javax.swing.JScrollPane jScrollPane1;
 630     private javax.swing.JScrollPane jScrollPane2;
 631     private javax.swing.JScrollPane jScrollPane3;
 632     private javax.swing.JToggleButton jToggleButton1;
 633     private javax.swing.JToggleButton jToggleButton2;
 634     private javax.swing.JToggleButton jToggleButton3;
 635     private javax.swing.JPanel standardPanel;
 636     private javax.swing.JTable tabCustomUT;
 637     private javax.swing.JTable tabStandardUT;
 638     private javax.swing.JTextField tfClassName;
 639     private javax.swing.JPanel topPanel;
 640     // End of variables declaration                   
 641 
 642     @Override
 643     public JComponent getVisualRepresentation() {
 644         return this;
 645     }
 646 
 647     @Override
 648     public JComponent getToolbarRepresentation() {
 649         return toolbar;
 650     }
 651 
 652     @Override
 653     public Action[] getActions() {
 654         return new Action[0];
 655     }
 656 
 657     @Override
 658     public Lookup getLookup() {
 659         return obj.getLookup();
 660     }
 661 
 662     @Override
 663     public void componentOpened() {
 664     }
 665 
 666     @Override
 667     public void componentClosed() {
 668     }
 669 
 670     @Override
 671     public void componentShowing() {
 672     }
 673 
 674     @Override
 675     public void componentHidden() {
 676     }
 677 
 678     @Override
 679     public void componentActivated() {
 680         Logger.getLogger(this.getClass()).log(Level.INFO, "*** APH-I1 : Allowed Subclasses : " + getRoot().getAllowSubclasses().getValue());
 681         refreshBindings();
 682     }
 683 
 684     @Override
 685     public void componentDeactivated() {
 686     }
 687 
 688     @Override
 689     public UndoRedo getUndoRedo() {
 690         return UndoRedo.NONE;
 691     }
 692 
 693     @Override
 694     public void setMultiViewCallback(MultiViewElementCallback callback) {
 695         this.callback = callback;
 696     }
 697 
 698     @Override
 699     public CloseOperationState canCloseElement() {
 700         return CloseOperationState.STATE_OK;
 701     }
 702 
 703     @Override
 704     public void tableChanged(TableModelEvent e) {
 705     }
 706 
 707     @Override
 708     public void valueChanged(ListSelectionEvent e) {
 709         btnEdit.setEnabled(true);
 710         btnRemove.setEnabled(true);
 711         btnEditImage.setEnabled(true);
 712         btnDeleteImage.setEnabled(true);
 713     }
 714 
 715     @Override
 716     public void bindingBecameBound(Binding binding) {
 717     }
 718 
 719     @Override
 720     public void bindingBecameUnbound(Binding binding) {
 721     }
 722 
 723     @Override
 724     public void syncFailed(Binding binding, SyncFailure failure) {
 725     }
 726 
 727     @Override
 728     public void synced(Binding binding) {
 729     }
 730 
 731     @Override
 732     public void sourceChanged(Binding binding, PropertyStateEvent event) {
 733     }
 734 
 735     @Override
 736     public void targetChanged(Binding binding, PropertyStateEvent event) {
 737     }
 738 
 739     /*
 740      * =========================================================================
 741      * START: Custom Code
 742      * =========================================================================
 743      */
 744     private PofConfigModel myModel = null;
 745     private PofConfig myRoot = null;
 746     private ModelSource myModelSource = null;
 747     private PofConfigComponentFactory myFactory = null;
 748     private UserTypesTableModel standardUserTypes = new UserTypesTableModel();
 749     private UserTypesTableModel customUserTypes = new UserTypesTableModel();
 750     private BindingGroup bindingGroup = new BindingGroup();
 751 
 752     private PofConfig getPofConfig() {
 753         return getRoot();
 754     }
 755 
 756     private PofConfig getRoot() {
 757         if (myRoot == null) {
 758             myRoot = getModel().getPofConfig();
 759         }
 760         return myRoot;
 761     }
 762 
 763     private PofConfigModel getModel() {
 764         if (myModel == null) {
 765             // Get Model
 766             myModel = PofConfigModelFactory.getInstance().getModel(getModelSource());
 767         }
 768         return myModel;
 769     }
 770 
 771     private ModelSource getModelSource() {
 772         if (myModelSource == null) {
 773             myModelSource = Utilities.getModelSource(obj.getPrimaryFile(), true);
 774         }
 775         return myModelSource;
 776     }
 777 
 778     private PofConfigComponentFactory getFactory() {
 779         if (myFactory == null) {
 780             myFactory = getModel().getFactory();
 781         }
 782         return myFactory;
 783     }
 784     /*
 785      * Custom Inner Classes
 786      */
 787 
 788     public class UserTypesTableModel extends AbstractTableModel {
 789 
 790         private final String[] columnNames = {"Type Id", "Class Name", "Serializer"};
 791         private List data = new ArrayList();  792         private boolean[] edittable = {false, false, false};  793   794         @Override  795         public int getRowCount() {  796             return data.size();  797         }  798   799         @Override  800         public int getColumnCount() {  801             return columnNames.length;  802         }  803   804         @Override  805         public Object getValueAt(int rowIndex, int columnIndex) {  806             Object value = null;  807   808             if (rowIndex < getRowCount() && columnIndex < getColumnCount()) {  809                 value = data.get(rowIndex)[columnIndex];  810             }  811             return value;  812         }  813   814         @Override  815         public void setValueAt(Object aValue, int rowIndex, int columnIndex) {  816             if (rowIndex < getRowCount() && columnIndex < getColumnCount()) {  817                 data.get(rowIndex)[columnIndex] = aValue;  818                 fireTableCellUpdated(rowIndex, columnIndex);  819             }  820         }  821   822         @Override  823         public String getColumnName(int column) {  824             return columnNames[column];  825         }  826   827         @Override  828         public boolean isCellEditable(int rowIndex, int columnIndex) {  829             if (getEdittable() == null || columnIndex > getEdittable().length) {  830                 return false;  831             } else {  832                 return getEdittable()[columnIndex];  833             }  834         }  835   836         public boolean[] getEdittable() {  837             return edittable;  838         }  839   840         public void setEdittable(boolean[] edittable) {  841             this.edittable = edittable;  842         }  843   844         public void addRow(int id, String name, String serializer, Object node) {  845             Object[] row = {Integer.valueOf(id), name, serializer, node};  846             data.add(row);  847             fireTableDataChanged();  848         }  849   850         public void clear() {  851             data.clear();  852             fireTableDataChanged();  853         }  854   855         public void updateRow(int rowNum, int id, String name, String serializer) {  856             try {  857                 data.get(rowNum)[0] = id;  858                 data.get(rowNum)[1] = name;  859                 data.get(rowNum)[2] = serializer;  860                 UserType ut = (UserType) data.get(rowNum)[3];  861                 ut.getClassName().setValue(name);  862                 ut.getTypeId().setValue(id);  863                 ut.getSerializer().getClassName().setValue(serializer);  864                 fireTableDataChanged();  865             } catch (ValueNotPermittedException ex) {  866                 Exceptions.printStackTrace(ex);  867             }  868         }  869   870         public Object getUserType(int rowIndex) {  871             Object value = null;  872   873             if (rowIndex < getRowCount()) {  874                 value = data.get(rowIndex)[3];  875             }  876             return value;  877         }  878   879         public void removeRow(int rowIndex) {  880             if (rowIndex < getRowCount()) {  881                 data.remove(rowIndex);  882             }  883             fireTableDataChanged();  884         }  885   886         public List getData() {  887             return data;  888         }  889   890         public void setData(List data) {  891             this.data = data;  892             fireTableDataChanged();  893         }  894     }  895   896     public UserTypesTableModel getCustomUserTypes() {  897         return customUserTypes;  898     }  899   900     public UserTypesTableModel getStandardUserTypes() {  901         return standardUserTypes;  902     }  903   904     private void setModified() {  905     }  906   907     private void initialise() {  908         // Set Display State of Panels based on Toggle Button Status  909         jToggleButton1ActionPerformed(null);  910         jToggleButton2ActionPerformed(null);  911         jToggleButton3ActionPerformed(null);  912         // Assign Change listener to Table  913         tabCustomUT.getSelectionModel().addListSelectionListener(this);  914         // Add Listeners  915     }  916   917     private void refreshBindings() {  918         for (Binding b : bindingGroup.getBindings()) {  919             bindingGroup.removeBinding(b);  920         }  921         setupBindings();  922     }  923   924     private void setupBindings() {  925         PofConfig pofConfig = getPofConfig();  926         // Set Bindings  927         Property propertyTextValue = BeanProperty.create("text");  928         Property propertySelected = BeanProperty.create("selected");  929         Property propertySelectedItem = BeanProperty.create("selectedItem");  930         Property propertyData = BeanProperty.create("data");  931         // EditionName  932         Property propertyDefaultSerializer = BeanProperty.create("defaultSerializer");  933         Binding bindingDefaultSerializer = Bindings.createAutoBinding(UpdateStrategy.READ_WRITE, this, propertyDefaultSerializer, tfClassName, propertyTextValue);  934         bindingGroup.addBinding(bindingDefaultSerializer);  935         // Allow SubClasses  936         Property propertyAllowSubclasses = BeanProperty.create("allowSubclasses");  937         Binding bindingAllowSubclasses = Bindings.createAutoBinding(UpdateStrategy.READ_WRITE, this, propertyAllowSubclasses, cbAllowSubclesses, propertySelected);  938         bindingGroup.addBinding(bindingAllowSubclasses);  939         // Allow Interfaces  940         Property propertyAllowInterfaces = BeanProperty.create("allowInterfaces");  941         Binding bindingAllowInterfaces = Bindings.createAutoBinding(UpdateStrategy.READ_WRITE, this, propertyAllowInterfaces, cbAllowInterfaces, propertySelected);  942         bindingGroup.addBinding(bindingAllowInterfaces);  943         // Standard Types  944         Property propertyStandardTypes = BeanProperty.create("standardUserTypeRows");  945         Binding bindingStandardTypes = Bindings.createAutoBinding(UpdateStrategy.READ_WRITE, this, propertyStandardTypes, standardUserTypes, propertyData);  946         bindingGroup.addBinding(bindingStandardTypes);  947         // Standard Types  948         Property propertyCustomTypes = BeanProperty.create("customUserTypeRows");  949         Binding bindingCustomTypes = Bindings.createAutoBinding(UpdateStrategy.READ_WRITE, this, propertyCustomTypes, customUserTypes, propertyData);  950         bindingGroup.addBinding(bindingCustomTypes);  951         // Bind All  952         bindingGroup.addBindingListener(this);  953         bindingGroup.bind();  954     }  955     /*  956      * Binding Methods  957      */  958   959     public void setAllowInterfaces(boolean b) {  960         getModel().startTransaction();  961         if (getPofConfig().getAllowInterfaces() == null) {  962             getPofConfig().setAllowInterfaces(getFactory().createAllowInterfaces());  963         }  964         getPofConfig().getAllowInterfaces().setValue(b);  965         getModel().endTransaction();  966     }  967   968     public boolean isAllowInterfaces() {  969         if (getPofConfig().getAllowInterfaces() == null) {  970             getPofConfig().setAllowInterfaces(getFactory().createAllowInterfaces());  971         }  972         return getPofConfig().getAllowInterfaces().getValue();  973     }  974   975     public boolean getAllowInterfaces() {  976         return isAllowInterfaces();  977     }  978   979     public void setAllowSubclasses(boolean b) {  980         getModel().startTransaction();  981         if (getPofConfig().getAllowSubclasses() == null) {  982             getPofConfig().setAllowSubclasses(getFactory().createAllowSubclasses());  983         }  984         getPofConfig().getAllowSubclasses().setValue(b);  985         getModel().endTransaction();  986     }  987   988     public boolean isAllowSubclasses() {  989         if (getPofConfig().getAllowSubclasses() == null) {  990             getPofConfig().setAllowSubclasses(getFactory().createAllowSubclasses());  991         }  992         return getPofConfig().getAllowSubclasses().getValue();  993     }  994   995     public boolean getAllSubclasses() {  996         return isAllowSubclasses();  997     }  998   999     public void setDefaultSerializer(String s) { 1000         getModel().startTransaction(); 1001         if (s == null || s.trim().length() == 0) { 1002             getPofConfig().setDefaultSerializer(null); 1003         } else { 1004             if (getPofConfig().getDefaultSerializer() == null) { 1005                 getPofConfig().setDefaultSerializer(getFactory().createDefaultSerializer()); 1006             } 1007             if (getPofConfig().getDefaultSerializer().getClassName() == null) { 1008                 getPofConfig().getDefaultSerializer().setClassName(getFactory().createClassName()); 1009             } 1010             getPofConfig().getDefaultSerializer().getClassName().setValue(s); 1011         } 1012         getModel().endTransaction(); 1013     } 1014  1015     public String getDefaultSerializer() { 1016         String s = null; 1017         if (getPofConfig().getDefaultSerializer() != null) { 1018             if (getPofConfig().getDefaultSerializer().getClassName() != null) { 1019                 s = getPofConfig().getDefaultSerializer().getClassName().getValue(); 1020             } 1021         } 1022         return s; 1023     } 1024  1025     public void setStandardUserTypeRows(List data) { 1026         PofConfig pofConfig = getPofConfig(); 1027         if (data != null) { 1028 //            for (Object[] oArray : data) { 1029 //            } 1030         } 1031     } 1032  1033     public List getStandardUserTypeRows() { 1034         PofConfig pofConfig = getPofConfig(); 1035         List objArrayList = new ArrayList(); 1036         Object[] row = null; 1037         // Process User Type 1038         UserTypeList utl = pofConfig.getUserTypeList(); 1039         if (utl != null) { 1040             List utoiList = utl.getUserTypes(); 1041             String serializer = null; 1042             if (utoiList != null) { 1043                 for (UserType ut : utoiList) { 1044                     try { 1045                         serializer = null; 1046                         if (ut.getTypeId().getValue() < 1000) { 1047                             if (ut.getSerializer() != null) { 1048                                 serializer = ut.getSerializer().getClassName().getValue(); 1049                             } 1050                             row = new Object[4]; 1051                             row[0] = ut.getTypeId().getValue(); 1052                             row[1] = ut.getClassName(); 1053                             row[2] = serializer; 1054                             row[3] = ut; 1055                             objArrayList.add(row); 1056                         } 1057                     } catch (Exception e) { 1058                         StatusDisplayer.getDefault().setStatusText("Failed to parse type"); 1059                     } 1060                 } 1061             } 1062         } 1063         return objArrayList; 1064     } 1065  1066     public void setCustomUserTypeRows(List data) { 1067         PofConfig pofConfig = getPofConfig(); 1068         if (data != null) { 1069 //            for (Object[] oArray : data) { 1070 //            } 1071         } 1072     } 1073  1074     public List getCustomUserTypeRows() { 1075         PofConfig pofConfig = getPofConfig(); 1076         List objArrayList = new ArrayList(); 1077         Object[] row = null; 1078         // Process User Type 1079         UserTypeList utl = pofConfig.getUserTypeList(); 1080         if (utl != null) { 1081             List utoiList = utl.getUserTypes(); 1082             String serializer = null; 1083             if (utoiList != null) { 1084                 for (UserType ut : utoiList) { 1085                     try { 1086                         serializer = null; 1087                         if (ut.getTypeId().getValue() >= 1000) { 1088                             if (ut.getSerializer() != null) { 1089                                 serializer = ut.getSerializer().getClassName().getValue(); 1090                             } 1091                             row = new Object[4]; 1092                             row[0] = ut.getTypeId().getValue(); 1093                             row[1] = ut.getClassName(); 1094                             row[2] = serializer; 1095                             row[3] = ut; 1096                             objArrayList.add(row); 1097                         } 1098                     } catch (Exception e) { 1099                         StatusDisplayer.getDefault().setStatusText("Failed to parse type"); 1100                     } 1101                 } 1102             } 1103         } 1104         return objArrayList; 1105     } 1106     /* 1107      * ========================================================================= 1108      * END: Custom Code 1109      * ========================================================================= 1110      */ 1111 } 1112  1113

The key changes that modify the MultiView tab display name and order are done within the Annotaions in the PofConfigVisualElement.java.

 86
 87 @MultiViewElement.Registration(displayName = "#LBL_PofConfig_VISUAL",
 88 iconBase = "org/netbeans/modules/coherence/resources/icons/pof.png",
 89 mimeType = "text/coh-pof+xml",
 90 persistenceType = TopComponent.PERSISTENCE_NEVER,
 91 preferredID = "PofConfigVisual",
 92 position = 1000)
 93 @Messages({
 94 "LBL_PofConfig_VISUAL=General"
 95 })
 96 /**
 97 *
 98 * @author Andrew Hopkinson (Oracle A-Team)
 99 */

To change the name of the tab we simply modify line 94 whilst editting line 92 will change the position of the teb on the bar. What I did for positioning was modify 92 to the value that is in the PofConfigDataObject.java (line 75) and vica versa.

We now have the graphical portion complete and all we need to do is link the previously built XAM/XDM XML Object Model into the Visual Component.

Integrating the XAM/XDM Code

When integrating the XAM/XDM Object Model we need to initially create a model based on the Primary File associated with the DataObject (see line 773 below). You will notice from the code below that I build the XAM/XDM Object Model as required and this is only done once because at every other point within the Visual Code I access the Model using the getPofConfig() method.

 102 private PofConfigDataObject obj;
 103 private JToolBar toolbar = new JToolBar();
 104 private transient MultiViewElementCallback callback;
 105
 106 public PofConfigVisualElement(Lookup lkp) {
 107 obj = lkp.lookup(PofConfigDataObject.class);
 108 assert obj != null;
 109 initComponents();
 110 initialise();
 111 }
 112

 739 /*
 740 * =========================================================================
 741 * START: Custom Code
 742 * =========================================================================
 743 */
 744 private PofConfigModel myModel = null;
 745 private PofConfig myRoot = null;
 746 private ModelSource myModelSource = null;
 747 private PofConfigComponentFactory myFactory = null;
 748 private UserTypesTableModel standardUserTypes = new UserTypesTableModel();
 749 private UserTypesTableModel customUserTypes = new UserTypesTableModel();
 750 private BindingGroup bindingGroup = new BindingGroup();
 751
 752 private PofConfig getPofConfig() {
 753 return getRoot();
 754 }
 755
 756 private PofConfig getRoot() {
 757 if (myRoot == null) {
 758 myRoot = getModel().getPofConfig();
 759 }
 760 return myRoot;
 761 }
 762
 763 private PofConfigModel getModel() {
 764 if (myModel == null) {
 765 // Get Model
 766 myModel = PofConfigModelFactory.getInstance().getModel(getModelSource());
 767 }
 768 return myModel;
 769 }
 770
 771 private ModelSource getModelSource() {
 772 if (myModelSource == null) {
 773 myModelSource = Utilities.getModelSource(obj.getPrimaryFile(), true);
 774 }
 775 return myModelSource;
 776 }
 777
 778 private PofConfigComponentFactory getFactory() {
 779 if (myFactory == null) {
 780 myFactory = getModel().getFactory();
 781 }
 782 return myFactory;
 783 }

You will also notice within the full code that I use the Java Bindings functionality to link the Object model with the displayed fields. To achieve this I have written a number of Model Accessor methods getters and setters because when modifying the Model we will need to do it transactionally. If we consider the AllowInterfaces Element we can see from the methods below that when setting the value of the Element we will need to start a transaction against the model (line 960) then check is the Element exists (line 961) and create it if it does not (line 962) before writing and completing the transaction (line 965). The result of this process is that the Text version will be updated and when the user switches views they will see the updated values. You can also see from the code fragment below that within the get I test for and create the Element if it does not exist. Reviewing the full code listing above you will notice that all accessor methods are implemented in a similar fashion.

 955 /*
 956 * Binding Methods
 957 */
 958
 959 public void setAllowInterfaces(boolean b) {
 960 getModel().startTransaction();
 961 if (getPofConfig().getAllowInterfaces() == null) {
 962 getPofConfig().setAllowInterfaces(getFactory().createAllowInterfaces());
 963 }
 964 getPofConfig().getAllowInterfaces().setValue(b);
 965 getModel().endTransaction();
 966 }
 967
 968 public boolean isAllowInterfaces() {
 969 if (getPofConfig().getAllowInterfaces() == null) {
 970 getPofConfig().setAllowInterfaces(getFactory().createAllowInterfaces());
 971 }
 972 return getPofConfig().getAllowInterfaces().getValue();
 973 }
 974
 975 public boolean getAllowInterfaces() {
 976 return isAllowInterfaces();
 977 }

The functionaly above differs from that used when accessing a JAXB Object Model because we do not need to start transactions and in the majority of cases we can assume the Element exists or will be created when we get its value.

Exalogic Networking Part 1

2011-08-10T15:29:00.002+01:00

This is the first blog entry in a series I will be writing on Exalogic Networking. The entries will start with the low level basics and work their way up to architectural strategies for the partitioning and configuration an Exalogic Rack.

This first entry will look at the low level creation and configuration of vNICs, vIPs, vLANs, BONDs and how we can leverage scripting and the dcli command to configure all Exalogic Compute Nodes at the same time. At this point in time the scripts with documented within this page are designed from Oracle Enterprise Linux but can be tweaked slightly for a Solaris Exalogic installation. In addition we will focus on the external facing 10Gb network because the the 1Gb is management only and should be on a private network whilst the internal InfiniBand network will not be directly accessible to the outside world.

vNICs

Virtual Network Interface Cards (vNICs) emulates a NIC for a given Compute Node within the Exalogic Rack. As part of the installation and configuration the Oracle Engineer will create a number of these, based on a predefined algorithm, to allow 10Gb connection through the switches within the rack. Internally this is implemented over the InfiniBand Network and converted to 10Gb at the switch.

As mentioned the Engineer will create the vNICs with MAC addresses based on a predefined algorithm that takes the GUID for each Compute Nodes Network card and a value indicating which exernal Ethernet port we will be connecting it to. In reality the only requirement is that the MAC addresses be unique. Given the fact that hand cranking these for a full, 30 node, rack is time consuming and error prone I created a number of scripts that generate a simple script file containing all the required createvnic commands.

#!/bin/sh

# "el2bcn15 192.168.10.67 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:f5:fa -mac a0:f5:fa:10:00:67 -pkey default

# "el2bcn16 192.168.10.68 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:fb:4a -mac a0:fb:4a:10:00:68 -pkey default

# "el2bcn08 192.168.10.58 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:d5:85 -mac a0:d5:85:10:00:58 -pkey default

# "el2bcn09 192.168.10.59 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:d6:fe -mac a0:d6:fe:10:00:59 -pkey default

# "el2bcn12 192.168.10.62 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:d5:6e -mac a0:d5:6e:10:00:62 -pkey default

# "el2bcn11 192.168.10.61 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:d7:ea -mac a0:d7:ea:10:00:61 -pkey default

# "el2bcn14 192.168.10.64 VNIC

createvnic 0A-ETH-1 -guid 00:21:28:00:01:a1:0c:0e -mac a0:0c:0e:10:00:64 -pkey default

# "el2bcn13 192.168.10.63 VNIC

Once generated this file can be executed on the switches to create the actual vNICs that can then be used by the compute node to access / be accessed from external systems using the 10Gb network. Before this can be done we will need to create / configure the Ethernet and Bonds on each compute node as described in the next section.

The two scripts below, genVNICsFromLinkListUp.sh and genVNICsFromIBNetDiscover.sh, use the existing Exalogic scripts linklistup and inbnetdiscover to obtain information about the Exalogic network configuration. If you already have a 10Gb cable plugged into the Exalogic switch then using the genVNICsFromLinkListUp.sh will identify this and create the script file based on the active link by calling the genVNICsFromIBNetDiscover.sh passing the information. If on the other hand you need to create the vNICs before the cable has been connected then you can use the genVNICsFromIBNetDiscover.sh directly passing the Ethernet port id that will be used.

genVNICsFromLinkListUp.sh

  1 #!/bin/sh

  2 

  3 ################################################################################

  4 #

  5 #       Exalogic EL X2-2 1.0 (Linux x86-64) Configuration Script.

  6 #

  7 #  HEADER START

  8 # 

  9 #  THIS SCRIPT IS PROVIDED ON AN �AS IS� BASIS, WITHOUT WARRANTY OF ANY KIND, 

 10 #  EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT 

 11 #  THE COVERED SCRIPT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR 

 12 #  PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 

 13 #  OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE 

 14 #  DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER 

 15 #  CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION.

 16 #  NO USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 

 17 #  DISCLAIMER.

 18 #

 19 #  When distributing this Code, include this HEADER in each file.

 20 #  If applicable, add the following below this this HEADER, with the fields

 21 #  enclosed by brackets "[]" replaced with your own identifying information:

 22 #       Portions Copyright [yyyy] [name of copyright owner]

 23 # 

 24 #  HEADER END

 25 # 

 26 # 

 27 #       Copyright 2011 Andrew Hopkinson, Oracle Corporation UK Ltd.

 28 #

 29 ################################################################################

 30 

 31 

 32 ################################################################################

 33 #

 34 # genVNICsFromListLinkUp.sh

 35 # =========================

 36 #

 37 # Version : 1.0.1

 38 #

 39 # This script does not directly affect the system it is running rather it calls

 40 # the genVNICsFromIBNetDiscover.sh script for each ETH port it finds which is up.

 41 # On execution of the genVNICsFromIBNetDiscover.sh script it will pass the ETH

 42 # port and output from the ibnetdiscover.

 43 #

 44 # Parameters

 45 #

 46 #   -f : Specifies a file that contain the output from the listlinkup command

 47 #      : executed on the switch. If no file is provided the script will execute

 48 #      : the listlinkup command to generate the file.

 49 #   -i : If this script is not being run on a switch or you already have an

 50 #      : output from ibnetdiscover that you want to use then it can be specified

 51 #      : with this flag. If the flag is not present the script will execute 

 52 #      : ibnetdiscover to generate the file.

 53 #   -v : If the script is not being run on a switch then you must supply the 

 54 #      : output from showvnics. If the flag is not present then the script will

 55 #      : execute showvnics and write the content to a temporary file.

 56 #

 57 # Version History

 58 # 1.0.0 - Initial Realease

 59 # 1.0.1 - Modified the generation of the delete VNICs script so that it is 

 60 #         generated based on the output from showvnics

 61 #

 62 ################################################################################

 63 

 64 

 65 IBNETDISCOVER=

 66 LISTLINKUPOUT=

 67 SHOWVNICSFILE=

 68 

 69 while [ $# -gt 0 ]

 70 do

 71         case "$1" in

 72                 -f) LISTLINKUPOUT="$2"; shift;;

 73                 -i) IBNETDISCOVER="$2"; shift;;

 74                 -v) SHOWVNICSFILE="$2"; shift;;

 75                 *) echo ""; echo >&2 \

 76                     "usage: $0 [-f listlinkup output] [-i ibnetdiscover output] [-v showvnics output] "

 77                     echo""; exit 1;;

 78                 *) break;;

 79         esac

 80         shift

 81 done

 82 

 83 # Generate ibnetdiscover

 84 if test "$IBNETDISCOVER" = ""

 85 then

 86         echo "Generating ibnetdiscover"

 87         echo ""

 88         IBNETDISCOVER=ibnetdiscover.out

 89         ibnetdiscover > $IBNETDISCOVER

 90         if [ "$?" -ne "0" ]

 91         then

 92                 echo ""

 93                 echo "Error: Generating ibnetdiscover output only works on the switch"

 94                 echo ""

 95                 exit 1

 96         fi

 97 fi

 98 

 99 # Generate showvnics

100 if test "$SHOWVNICSFILE" = ""

101 then

102         echo "Generating showvnics"

103         echo ""

104         SHOWVNICSFILE=showvnics.out

105         showvnics > $SHOWVNICSFILE

106         if [ "$?" -ne "0" ]

107         then

108                 echo ""

109                 echo "Error: Generating showvnics output only works on the switch"

110                 echo ""

111                 exit 1

112         fi

113 fi

114 

115 # Generate listlinkup

116 if test "$LISTLINKUPOUT" = ""

117 then

118         echo "Generating listlinkup"

119         echo ""

120         LISTLINKUPOUT=listlinkup.out

121         listlinkup > $LISTLINKUPOUT

122         if [ "$?" -ne "0" ]

123         then

124                 echo ""

125                 echo "Error: Generating listlinkup output only works on the switch"

126                 echo ""

127                 exit 1

128         fi

129 fi

130 

131 TEMPBRIDGEFILE=.upEthBridges

132 

133 grep Bridge $LISTLINKUPOUT | grep "ETH-" | grep "up" > $TEMPBRIDGEFILE

134 

135 while read line

136 do

137         i=0

138         for el in $line

139         do

140                 i=`expr $i + 1`

141 #               echo "$i = $el"

142                 if [ $i -eq 3 ]

143                 then

144 #                       echo "Port $el"

145                         ./genVNICsFromIBNetDiscover.sh -f $IBNETDISCOVER -p $el -v $SHOWVNICSFILE

146                         break

147                 fi

148         done

149 done < $TEMPBRIDGEFILE

150 

151 # Cleanup

152 

153 rm $TEMPBRIDGEFILE

154 

155

genVNICsFromIBNetDiscover.sh

  1 #!/bin/sh

  2 

  3 ################################################################################

  4 #

  5 #       Exalogic EL X2-2 1.0 (Linux x86-64) Configuration Script.

  6 #

  7 #  HEADER START

  8 # 

  9 #  THIS SCRIPT IS PROVIDED ON AN �AS IS� BASIS, WITHOUT WARRANTY OF ANY KIND, 

 10 #  EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT 

 11 #  THE COVERED SCRIPT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR 

 12 #  PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 

 13 #  OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE 

 14 #  DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER 

 15 #  CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION.

 16 #  NO USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 

 17 #  DISCLAIMER.

 18 #

 19 #  When distributing this Code, include this HEADER in each file.

 20 #  If applicable, add the following below this this HEADER, with the fields

 21 #  enclosed by brackets "[]" replaced with your own identifying information:

 22 #       Portions Copyright [yyyy] [name of copyright owner]

 23 # 

 24 #  HEADER END

 25 # 

 26 # 

 27 #       Copyright 2011 Andrew Hopkinson, Oracle Corporation UK Ltd.

 28 #

 29 ################################################################################

 30 

 31 

 32 ################################################################################

 33 #

 34 # genVNICsFromIBNetDiscover.sh

 35 # ============================

 36 #

 37 # Version : 1.0.2

 38 #

 39 # This does not affect the system directly rather it build a number of other 

 40 # scripts that the user can execute to modify the system. The scripts it 

 41 # created are in in the format :

 42 #      create---VNICs.sh

 43 #

 44 # This file contain a series of createvnic commands similar to those below

 45 #

 46 #       #!/bin/sh

 47 #       # "el01cn15 192.168.10.17 VNIC

 48 #       createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:f5:fa -mac a0:f5:fa:10:00:17 -pkey default

 49 #       # "el01cn16 192.168.10.18 VNIC

 50 #       createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:fb:4a -mac a0:fb:4a:10:00:18 -pkey default

 51 #       # "el01cn08 192.168.10.8 VNIC

 52 #       createvnic 0A-ETH-1 -guid 00:21:28:00:01:a0:d5:85 -mac a0:d5:85:10:00:08 -pkey default

 53 #

 54 # Once created the user can then execute this file on the switch or edit it as

 55 # required.

 56 #

 57 # Parameters

 58 #

 59 #   -a : Specifies is the script is to generate create-$swname-$ETHPORT-VNICs.sh

 60 #      : files for all switches that can be identified from the ibnetdiscover

 61 #      : output. By default this is false and this script will only generate

 62 #      : output for the first switch found that is the one it is being run on.

 63 #   -f : If this script is not being run on a switch or you already have an

 64 #      : output from ibnetdiscover that you want to use then it can be specified

 65 #      : with this flag. If the flag is not present the script will execute 

 66 #      : ibnetdiscover to generate the file.

 67 #   -p : Defines the ETH Port for which thes create..... script will be generated

 68 #      : by default we assume thise is 0A-ETH-1. 

 69 #   -v : If the script is not being run on a switch then you must supply the 

 70 #      : output from showvnics. If the flag is not present then the script will

 71 #      : execute showvnics and write the content to a temporary file.

 72 #   -c : Flag to indicate that the /conf/bx.conf should be cleared.

 73 #

 74 # When called from the genVNICsFromListLookUp.sh script -a will be ommited 

 75 # but -f and -p will be specified.

 76 #

 77 # Version History

 78 # 1.0.0 - Initial Realease

 79 # 1.0.1 - Modified the generation of the delete VNICs script so that it is 

 80 #         generated based on the output from showvnics

 81 # 1.0.2 - Added " service bxm restart" to the end of the deletevnincs generated 

 82 #         file.

 83 #

 84 ################################################################################

 85 

 86 

 87 IBNETDISCOVER=

 88 ETHPORT=0A-ETH-1

 89 PORTNO=00

 90 ALLSWITCHES=false

 91 SHOWVNICSFILE=

 92 CLEARBXCONF=false

 93 

 94 while [ $# -gt 0 ]

 95 do

 96         case "$1" in

 97                 -a) ALLSWITCHES=true;;

 98                 -c) CLEARBXCONF=true;;

 99                 -f) IBNETDISCOVER="$2"; shift;;

100                 -p) ETHPORT="$2"; shift;;

101                 -v) SHOWVNICSFILE="$2"; shift;;

102                 *) echo ""; echo >&2 \

103                     "usage: $0 [-f ibnetdiscover output] [-p Ethernet Port (eg 0A-ETH-1)] [-a generate for all visible switches] [-v showvnics output] [-c clear /conf/bx.conf]"

104                     echo""; exit 1;;

105                 *) break;;

106         esac

107         shift

108 done

109 #                   "usage: $0 [-f ibnetdiscover output] [-p Ethernet Port (eg 0A-ETH-1)] [-n Machine Name Prefix (eg el01)]"

110 

111 # Generate ibnetdiscover

112 if test "$IBNETDISCOVER" = ""

113 then

114         echo "Generating ibnetdiscover"

115         echo ""

116         IBNETDISCOVER=ibnetdiscover.out

117         ibnetdiscover > $IBNETDISCOVER

118         if [ "$?" -ne "0" ]

119         then

120                 echo ""

121                 echo "Error: Generating ibnetdiscover output only works on the switch"

122                 echo ""

123                 exit 1

124         fi

125 fi

126 

127 # Generate showvnics

128 if test "$SHOWVNICSFILE" = ""

129 then

130         echo "Generating showvnics"

131         echo ""

132         SHOWVNICSFILE=showvnics.out

133         showvnics > $SHOWVNICSFILE

134         if [ "$?" -ne "0" ]

135         then

136                 echo ""

137                 echo "Error: Generating showvnics output only works on the switch"

138                 echo ""

139                 exit 1

140         fi

141 fi

142 

143 

144 if test "$ETHPORT" = "0A-ETH-1"

145 then

146         PORTNO=10

147 fi

148 if test "$ETHPORT" = "0A-ETH-2"

149 then

150         PORTNO=20

151 fi

152 if test "$ETHPORT" = "0A-ETH-3"

153 then

154         PORTNO=30

155 fi

156 if test "$ETHPORT" = "0A-ETH-4"

157 then

158         PORTNO=40

159 fi

160 if test "$ETHPORT" = "1A-ETH-1"

161 then

162         PORTNO=50

163 fi

164 if test "$ETHPORT" = "1A-ETH-2"

165 then

166         PORTNO=60

167 fi

168 if test "$ETHPORT" = "1A-ETH-3"

169 then

170         PORTNO=70

171 fi

172 if test "$ETHPORT" = "1A-ETH-4"

173 then

174         PORTNO=80

175 fi

176 

177 DELETEVNICSFILE=

178 CREATEVNICSFILE=

179 

180 # Process file

181 

182 switchcount=0

183 ln=0

184 vn=0

185 while read line

186 do

187         ln=`expr $ln + 1`

188         # Check for IB Switch

189         i=0

190         createfiles=false

191         swname=Unknown

192         for el in $line

193         do

194                 i=`expr $i + 1`

195                 if [ $i -eq 1 ]

196                 then

197                         if test "$el" != "Switch"

198                         then

199                                 break

200                         fi

201                 fi

202                 if [ $i -eq 6 ]

203                 then

204                         if test "$el" != "IB"

205                         then

206                                 break

207                         fi

208                 fi

209                 if [ $i -eq 7 ]

210                 then

211                         if test "$el" != "QDR"

212                         then

213                                 break

214                         fi

215                 fi

216                 if [ $i -eq 10 ]

217                 then

218                         switchname=$el

219                         if test "$el" != "localhost"

220                         then

221                                 swname=$el

222                                 createfiles=true

223                                 break

224                         fi

225                 fi

226                 if [ $i -eq 11 ]

227                 then

228                         swname=$el

229                         createfiles=true

230                         break

231                 fi

232 #               echo "$i el = $el"

233         done

234         

235         # Check if we need to create files

236         if test "$createfiles" = "true"

237         then

238                 createfiles=false

239                 switchcount=`expr $switchcount + 1`

240                         

241                 if [ $switchcount -eq 2 ]

242                 then

243                         if test "$ALLSWITCHES" != "true"

244                         then

245                                 break

246                         fi

247                 fi

248                 

249                 CREATEVNICSFILE=create-$swname-$ETHPORT-VNICs.sh

250                 echo "#!/bin/sh" > $CREATEVNICSFILE

251                 chmod +x $CREATEVNICSFILE

252         fi

253         

254         # Check for Connection

255         i=0

256         for el in $line

257         do

258                 i=`expr $i + 1`

259                 if [ $i -eq 2 ]

260                 then

261                         sc=`expr substr $el 2 1`

262                         if test "$sc" != "H"

263                         then

264                                 break

265                         fi

266                         

267                         oct1=`expr substr $el 25 2`

268                         oct2=`expr substr $el 27 2`

269                         oct3=`expr substr $el 29 2`

270                         oct4=`expr substr $el 31 2`

271                         oct5=`expr substr $el 33 2`

272                         oct6=`expr substr $el 35 2`

273                         oct7=`expr substr $el 37 2`

274 

275                         guid=00:$oct1:$oct2:$oct3:$oct4:$oct5:$oct6:$oct7

276                 fi

277                 if [ $i -eq 4 ]

278                 then

279                         cn=$el

280                 fi

281                 if [ $i -eq 5 ]

282                 then

283                         if test "$el" != "EL-C"

284                         then

285                                 break

286                         fi

287                 fi

288                 if [ $i -eq 6 ]

289                 then

290                         ip=$el

291                         len=`expr length $el`

292                         start=`expr $len - 1`

293                         mac3=`expr substr $el $start 2`

294                         if test "`expr substr $mac3 1 1`" = "."

295                         then

296                                 start=`expr $start + 1`

297                                 mac3=0`expr substr $el $start 1`

298                         fi

299 

300                         mac=a0:$oct6:$oct7:$PORTNO:00:$mac3

301                         

302                         # Write to file

303                         echo "# $cn $ip VNIC"  >> $CREATEVNICSFILE

304                         echo "createvnic $ETHPORT -guid $guid -mac $mac -pkey default" >> $CREATEVNICSFILE

305                         

306                 fi

307 #               echo "$i el = $el"

308         done

309         

310 done < $IBNETDISCOVER

311 

312 

313 echo "Generated Switch Files"

314 

315 # Generate DELETEVNICS File

316 DELETEVNICSFILE=delete-$ETHPORT-VNICs.sh

317 echo "#!/bin/sh" > $DELETEVNICSFILE

318 chmod +x $DELETEVNICSFILE

319 

320 SHOWVNICSFILEGREP=$SHOWVNICSFILE.grep

321 grep $ETHPORT $SHOWVNICSFILE > $SHOWVNICSFILEGREP

322 while read line

323 do

324         i=0

325         for el in $line

326         do

327                 i=`expr $i + 1`

328                 if [ $i -eq 1 ]

329                 then

330                         vn=$el

331                         echo "deletevnic $ETHPORT $vn" >> $DELETEVNICSFILE

332                         break

333                 fi

334         done

335 done < $SHOWVNICSFILEGREP

336 

337 rm $SHOWVNICSFILEGREP

338 

339 if test "$CLEARBXCONF" = "true"

340 then

341         echo "echo > /conf/bx.conf" >> $DELETEVNICSFILE

342 fi

343 

344 echo "service bxm restart" >> $DELETEVNICSFILE

345 

346 echo "Generated Delete VNICS Files"

347 

348

Bonds and Eth Config

Once the vNICs have been created we need to configure each of the Compute Nodes to connect to each of the switches and to do this we will create two Ethernet configuration files, by convention named ifcfg-eth4 and ifcfg-eth5, which are the physical connections to the ports. In addition we will create a bonded port, by convention name ifcfg-bond1, which it the logical port that the Compute Node will connect through. The creation of the bonded (bond1) network provides network resilience and fail-over. The contents of these files are similar to the following :

Ifcfg-eth4

DEVICE=eth4

BOOTPROTO=none

ONBOOT=yes

HWADDR=A0:F9:1E:50:00:32

MASTER=bond1

SLAVE=yes

Ifcfg-eth5

DEVICE=eth5

BOOTPROTO=none

ONBOOT=yes

HWADDR=A0:F9:1D:50:00:32

MASTER=bond1

SLAVE=yes

Ifcfg-bond1

DEVICE=bond1

IPADDR=10.131.12.94

NETMASK=255.255.255.0

BOOTPROTO=none

USERCTL=no

TYPE=Ethernet

ONBOOT=yes

IPV6INIT=no

BONDING_OPTS="mode=active-backup miimon=100 downdelay=5000 updelay=5000"

GATEWAY=10.131.12.1

In addition to allow default routing over the 10Gb Network we will need to modify the network conguration to specify the 10Gb network as the default routing option.

Again I have created some simple scripts to simplify the work and running the genCNNetFiles.sh will generated an new script that uses dcli to distribute the genIfcfgFiles.sh and execute it using ssh. This will generate the appropriate ifcfg files based on the outputs from the previous create vNICs execution.

genCNNetFiles.sh

  1 #!/bin/sh

  2 

  3 ################################################################################

  4 #

  5 #       Exalogic EL X2-2 1.0 (Linux x86-64) Configuration Script.

  6 #

  7 #  HEADER START

  8 # 

  9 #  THIS SCRIPT IS PROVIDED ON AN �AS IS� BASIS, WITHOUT WARRANTY OF ANY KIND, 

 10 #  EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT 

 11 #  THE COVERED SCRIPT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR 

 12 #  PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 

 13 #  OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE 

 14 #  DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER 

 15 #  CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION.

 16 #  NO USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 

 17 #  DISCLAIMER.

 18 #

 19 #  When distributing this Code, include this HEADER in each file.

 20 #  If applicable, add the following below this this HEADER, with the fields

 21 #  enclosed by brackets "[]" replaced with your own identifying information:

 22 #       Portions Copyright [yyyy] [name of copyright owner]

 23 # 

 24 #  HEADER END

 25 # 

 26 # 

 27 #       Copyright 2011 Andrew Hopkinson, Oracle Corporation UK Ltd.

 28 #

 29 ################################################################################

 30 

 31 

 32 ################################################################################

 33 #

 34 # genCNNetFiles.sh

 35 # ================

 36 #

 37 # Version : 1.0.2

 38 #

 39 # This does not affect the system directly rather it build a number of other 

 40 # scripts that the user can execute to modify the system. The three scripts it 

 41 # creates are:

 42 #    createAllIfCfg.sh

 43 #    setDefaultRouting.sh

 44 #    add10gIPToHosts.sh

 45 # In addition it relies on the existance of the genIfcfgFiles.sh within the same

 46 # directory.

 47 #

 48 # Parameters

 49 #

 50 #   -d     : Home directory of the dcli command

 51 #   -n     : Node list to need processed

 52 #   -ip    : A file containing a list (one per line) IP Address that will be

 53 #          : allocated to the nodes. This allows for non sequential IPs

 54 #   -nm    : The Bond1 Network Mask

 55 #   -gw    : The Gateway to be used by the 10 Gb bond1 conection.

 56 #   -vnic1 : File containing the output for showvnics on Gateway Switch 1 

 57 #          : The contents will be paired with the entry for -vnics2 to

 58 #          : create the ifcfg-eth4 file. (Compute Nodes 1-16)

 59 #   -vnic2 : File containing the output for showvnics on Gateway Switch 2 

 60 #          : The contents will be paired with the entry for -vnics1 to

 61 #          : create the ifcfg-eth5 file. (Compute Nodes 1-16)

 62 #   -vnic3 : File containing the output for showvnics on Gateway Switch 3 

 63 #          : The contents will be paired with the entry for -vnics4 to

 64 #          : create the ifcfg-eth4 file. (Compute Nodes 17-30)

 65 #   -vnic4 : File containing the output for showvnics on Gateway Switch 4 

 66 #          : The contents will be paired with the entry for -vnics3 to

 67 #          : create the ifcfg-eth5 file. (Compute Nodes 17-30)

 68 #

 69 # createAllIfCfg.sh

 70 # -----------------

 71 #

 72 # This generated script will use dcli to copy the genIfcfgFiles.sh to all nodes

 73 # and then execute this script using a series of ssh commands. These ssh commands

 74 # commands are built within the main script and pass in compute node specific 

 75 # information (see genIfcfgFiles.sh header for information). On completion of 

 76 # the script the genIfcfgFiles.sh will be removed from all compute nodes.

 77 #

 78 # setDefaultRouting.sh

 79 # --------------------

 80 #

 81 # This generated script will remove the default routing information and then 

 82 # add the 10 Gb (bond1) gateway as the default route. It should be executed 

 83 # after the service network restart has completed.

 84 #

 85 # add10gIPToHosts.sh

 86 # ------------------

 87 #

 88 # Optional script that when executed will add entries to the hosts file in the

 89 # format :

 90 #     <10Gb Suffix>

 91 #    10.131.12.61 el2bcn01-10g

 92 # The script is simply a set of echo commands to the /etc/hosts file and it is

 93 # left to the user to decide if this should be executed via dcli.

 94 #

 95 # Version History

 96 # 1.0.0 - Initial Realease.

 97 # 1.0.1 - Enable generation of add10gIPToHosts.sh script.

 98 # 1.0.2 - Extend the generated createAllIfCfg.sh so that it will re-run the ssh

 99 #         trust setup removed at the end of the Exalogic Configuration Utility.

100 #         This can be disabled by using the -i flag on the createAllIfCfg.sh.

101 #

102 ################################################################################

103 

104 NODELIST=nodelist

105 DCLIHOME=/opt/exalogic.tools/tools

106 VNICS1FILE=

107 VNICS2FILE=

108 VNICS3FILE=

109 VNICS4FILE=

110 IPFILE=

111 TENGBSUFFIX=-10g

112 

113 bond1nm=255.255.255.0

114 bond1gw=10.131.12.1

115 

116 while [ $# -gt 0 ]

117 do

118         case "$1" in

119                 -d) DCLIHOME="$2"; shift;;

120                 -n) NODELIST="$2"; shift;;

121                 -ip) IPFILE="$2"; shift;;

122                 -nm) bond1nm="$2"; shift;;

123                 -gw) bond1gw="$2"; shift;;

124                 -vnic1) VNICS1FILE="$2"; shift;;

125                 -vnic2) VNICS2FILE="$2"; shift;;

126                 -vnic3) VNICS3FILE="$2"; shift;;

127                 -vnic4) VNICS4FILE="$2"; shift;;

128                 -10g) TENGBSUFFIX="$2"; shift;;

129                 *) echo ""; echo >&2 \

130                     "usage: $0 -d  -n  -ip  -gw  -nm  -vnic1  -vnic2  [-vnic3  -vnic4 ]"

131                     echo""; exit 1;;

132                 *) break;;

133         esac

134         shift

135 done

136 

137 if test "$DCLIHOME" = ""

138 then

139         DCLIHOME=/opt/exalogic.tools/tools

140 fi

141 

142 if test "$NODELIST" = ""

143 then

144         NODELIST=nodelist

145 fi

146 

147 if test "$TENGBSUFFIX" = ""

148 then

149         TENGBSUFFIX=-10g

150 fi

151 

152 vl1=${#VNICS1FILE}

153 vl2=${#VNICS2FILE}

154 vl3=${#VNICS3FILE}

155 vl4=${#VNICS4FILE}

156 

157 # Check for the VNIC Files

158 if [ $vl1 -eq 0 ] || [ $vl2 -eq 0 ]

159 then

160         echo "Outputs from showvnics for Switch 1 and 2 must be provided"

161         exit 1

162 fi

163 

164 if [ $vl3 -gt 0 ] && [ $vl4 -eq 0 ]

165 then

166         echo "Output from Switch 3 and 4 must be provided as a pair"

167         exit 1

168 fi

169 if [ $vl3 -eq 0 ] && [ $vl4 -gt 0 ]

170 then

171         echo "Output from Switch 3 and 4 must be provided as a pair"

172         exit 1

173 fi

174 

175 # Need to validate the vnic file pairing ie there are either 2 or 4 I assume they are paired correctly

176 

177 GENIFCFGSCRIPT=genIfcfgFiles.sh

178 CREATECFGFILE=createAllIfCfg.sh

179 SETDEFAULTROUTING=setDefaultRouting.sh

180 ADDTOHOSTS=add10gIPToHosts.sh

181 

182 echo "#!/bin/sh" > $SETDEFAULTROUTING

183 echo "echo \"**********************\"" >> $SETDEFAULTROUTING

184 echo "echo \"** Processing \`hostname\` \"" >> $SETDEFAULTROUTING

185 echo "echo \"**********************\"" >> $SETDEFAULTROUTING

186 echo "netstat -rn" >> $SETDEFAULTROUTING

187 echo "route delete default" >> $SETDEFAULTROUTING

188 echo "route add default gw $bond1gw bond1" >> $SETDEFAULTROUTING

189 echo "netstat -rn" >> $SETDEFAULTROUTING

190 chmod +x $SETDEFAULTROUTING

191 

192 

193 

194 # Copy Create Script to all nodes

195 DESTDIR=/tmp/GenScripts

196 

197 echo "#!/bin/sh" > $CREATECFGFILE

198 chmod +x $CREATECFGFILE

199 

200 # Set ssh Trust Setup

201 echo "SETUPSSHTRUST=true"  >> $CREATECFGFILE

202 echo ""  >> $CREATECFGFILE

203 

204 echo "while [ \$# -gt 0 ]"  >> $CREATECFGFILE

205 echo "do"  >> $CREATECFGFILE

206 echo "  case \"\$1\" in "  >> $CREATECFGFILE

207 echo "          -i) SETUPSSHTRUST=false;;"  >> $CREATECFGFILE

208 echo "          *) echo \"\"; echo >&2 \\"  >> $CREATECFGFILE

209 echo "              \"usage: \$0 [-i ]\""  >> $CREATECFGFILE

210 echo "              echo\"\"; exit 1;;"  >> $CREATECFGFILE

211 echo "          *) break;;"  >> $CREATECFGFILE

212 echo "  esac"  >> $CREATECFGFILE

213 echo "  shift"  >> $CREATECFGFILE

214 echo "done"  >> $CREATECFGFILE

215 echo ""  >> $CREATECFGFILE

216 

217 echo "if test \"\$SETUPSSHTRUST\" = \"true\""  >> $CREATECFGFILE

218 echo "then"  >> $CREATECFGFILE

219 echo "  echo \"Setting up SSH Trust\""  >> $CREATECFGFILE

220 echo "  echo \"\""  >> $CREATECFGFILE

221 echo "  ssh-keygen -t dsa"  >> $CREATECFGFILE

222 echo "  $DCLIHOME/dcli -k -g $NODELIST "  >> $CREATECFGFILE

223 echo "fi"  >> $CREATECFGFILE

224 echo ""  >> $CREATECFGFILE

225 

226 # Copy Files

227 echo "chmod +x genIfcfgFiles.sh" >> $CREATECFGFILE

228 echo "dos2unix genIfcfgFiles.sh" >> $CREATECFGFILE

229 echo "$DCLIHOME/dcli -g $NODELIST mkdir -p $DESTDIR" >> $CREATECFGFILE

230 echo "$DCLIHOME/dcli -g $NODELIST -d $DESTDIR -f genIfcfgFiles.sh" >> $CREATECFGFILE

231 echo "$DCLIHOME/dcli -g $NODELIST -d $DESTDIR -f $SETDEFAULTROUTING" >> $CREATECFGFILE

232 echo ""  >> $CREATECFGFILE

233 

234 # Now for each compute node we need to execute the appropriate command

235 NEWNODELIST=$NODELIST.out

236 > $NEWNODELIST

237 

238 echo "#!/bin/sh" > $ADDTOHOSTS

239 chmod +x $ADDTOHOSTS

240 echo "echo \"\" >> /etc/hosts" >> $ADDTOHOSTS

241 echo "echo \"# Auto Generated Exalogic IP / Hostname for 10Gb (bond1) Connections\" >> /etc/hosts" >> $ADDTOHOSTS

242 echo "echo \"\" >> /etc/hosts" >> $ADDTOHOSTS

243 

244 cnip=0

245 # We need to execute this for the Switch pairings

246 # VNICS1FILE & VNICS2FILE 

247 # Optionally

248 # VNICS3FILE & VNICS4FILE

249 for ETH4FILE in $VNICS1FILE $VNICS3FILE

250 do

251         # Get ETH5FILE

252         if test "$ETH4FILE" = ""

253         then

254                 break

255         else

256                 if test "$ETH4FILE" = "$VNICS1FILE"

257                 then

258                         ETH5FILE=$VNICS2FILE

259                 else

260                         ETH5FILE=$VNICS4FILE

261                 fi

262         fi

263         echo "Eth4 $ETH4FILE"

264         echo "Eth5 $ETH5FILE"

265         

266         # Sort Input File

267         SORTEDETH4FILE=$ETH4FILE.sorted

268         sort +4 -5 $ETH4FILE > $SORTEDETH4FILE

269         

270         ln=0

271         while read line

272         do

273                 ln=`expr $ln + 1`

274                 

275                 i=0

276                 for el in $line

277                 do

278                         i=`expr $i + 1`

279                         if [ $i -eq 1 ]

280                         then

281                                 s=$el

282                                 break;

283                         fi

284                 done

285                 

286                 if test "$s" = "---"

287                 then

288                         continue

289                 fi

290                 if test "$s" = "ID"

291                 then

292                         continue

293                 fi

294                 # It's a Compute node so lets process it

295                 

296                 cnip=`expr $cnip + 1`

297                 # Get the Compute Node and its Mac from the first VNIC File

298                 # We will assume this is eth4 Mac address

299                 i=0

300                 for el in $line

301                 do

302                         i=`expr $i + 1`

303                         if [ $i -eq 5 ]

304                         then

305                                 cn=$el

306                                 echo "$cn" >> $NEWNODELIST

307                         fi

308                         if [ $i -eq 7 ]

309                         then

310                                 ip=$el

311                         fi

312                         if [ $i -eq 9 ]

313                         then

314                                 eth4mac=$el

315                         fi

316                         if [ $i -eq 12 ]

317                         then

318                                 port=$el

319                         fi

320                 done

321                 

322                 # Now we have the information from the first VNICs file we will process

323                 # the second to get eth5 mac address.

324                 #line=`grep $cn $VNICS2FILE`

325                 line=`grep $cn $ETH5FILE`

326                 #echo $line

327                 i=0

328                 for el in $line

329                 do

330                         i=`expr $i + 1`

331                         if [ $i -eq 9 ]

332                         then

333                                 eth5mac=$el

334                         fi

335                 done

336                 

337                 # Now we need to get the Bond 1 (10 Gb) IP Address from the list in the supplied file

338                 i=0

339                 while read ipaddr

340                 do

341                         i=`expr $i + 1`

342                         if [ $i -eq $cnip ]

343                         then

344                                 bond1ip=$ipaddr

345                                 break

346                         fi

347                 done < $IPFILE

348                 echo "# Call Script on $cn" >> $CREATECFGFILE

349                 echo "ssh -l root $cn $DESTDIR/$GENIFCFGSCRIPT -ip $bond1ip -nm $bond1nm -gw $bond1gw -m4 $eth4mac -m5 $eth5mac -cn $cn" >> $CREATECFGFILE

350                 

351                 cnalt=

352                 cnl=${#cn}

353                 if [ $cnl -gt 2 ]

354                 then

355                         ipos=`expr $cnl - 2`

356                         cns=${cn:0:$ipos}

357                         cne=${cn:$ipos}

358                         cnalt=${cn/%$cne/x$cne}

359                 fi

360                 echo "echo \"$bond1ip $cn$TENGBSUFFIX $cnalt\" >> /etc/hosts" >> $ADDTOHOSTS

361         done < $SORTEDETH4FILE

362         #done < $VNICS1FILE

363 done

364 

365 # Remove working file

366 echo "$DCLIHOME/dcli -g $NODELIST rm -r $DESTDIR" >> $CREATECFGFILE

367 

368 # Report Complete

369 echo ""

370 echo "Generated $CREATECFGFILE"

371 echo "=================================="

372 echo ""

373 echo "File should be validated before executing"

374 echo ""

375 echo "The script has also create the $SETDEFAULTROUTING file that can be executed"

376 echo "to reconfigure the default routing once the $CREATECFGFILE has completed"

377 echo "its restart of the network"

378 echo ""

379 

380

genIfgcfgFiles.sh

  1 #!/bin/sh

  2 

  3 ################################################################################

  4 #

  5 #       Exalogic EL X2-2 1.0 (Linux x86-64) Configuration Script.

  6 #

  7 #  HEADER START

  8 # 

  9 #  THIS SCRIPT IS PROVIDED ON AN �AS IS� BASIS, WITHOUT WARRANTY OF ANY KIND, 

 10 #  EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT 

 11 #  THE COVERED SCRIPT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR 

 12 #  PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 

 13 #  OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE 

 14 #  DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER 

 15 #  CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION.

 16 #  NO USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 

 17 #  DISCLAIMER.

 18 #

 19 #  When distributing this Code, include this HEADER in each file.

 20 #  If applicable, add the following below this this HEADER, with the fields

 21 #  enclosed by brackets "[]" replaced with your own identifying information:

 22 #       Portions Copyright [yyyy] [name of copyright owner]

 23 # 

 24 #  HEADER END

 25 # 

 26 # 

 27 #       Copyright 2011 Andrew Hopkinson, Oracle Corporation UK Ltd.

 28 #

 29 ################################################################################

 30 

 31 

 32 ################################################################################

 33 #

 34 # genIfcfgFiles.sh

 35 # ================

 36 #

 37 # Version : 1.0.0

 38 #

 39 # This script is used to generate ifcfg_bond1, ifcfg_eth4 and ifcfg_eth5 files

 40 # in the /etc/sysconfig/network-scripts directory based on the passed parameters.

 41 #

 42 # The key reason for this script is to help configure the 10 Gb Networking on

 43 # bond1 but also configure the redundant eth4 & eth5 network connection to our

 44 # pairs of switches.

 45 #

 46 # Parameters

 47 #

 48 #   -ip : The IP Address that should be assigned to the bond1 connection

 49 #   -nm : The Bond1 Network Mask

 50 #   -gw : The Gateway to be used by the 10 Gb bond1 conection.

 51 #   -m4 : The MAC Address to be associated with Eth4. This may have been 

 52 #         previously configured using the genVNICsFromIBNetDiscover.sh or

 53 #         genVNICsFromListLinkUp.sh on the Switches.

 54 #   -m5 : The MAC Address to be associated with Eth5. This may have been 

 55 #         previously configured using the genVNICsFromIBNetDiscover.sh or

 56 #         genVNICsFromListLinkUp.sh on the Switches.

 57 #

 58 # Processing

 59 #

 60 # On execution the script will first edit the /etc/sysconfig/network file to add

 61 # the specified 10 Gb Gateway. Once this has been done it will create the three

 62 # ifcfg- files in /etc/sysconfig/network-scripts. 

 63 #

 64 # Having created the file the script will, optionally, then edit the /etc/sysctl.conf

 65 # file to set net.ipv4.conf.default.rp_filter = 2 which will provide a loose 

 66 # filtering on the network and hence allow the standard management connection to be 

 67 # discovered and connected to.

 68 #

 69 # The final part of the script will restart the network service to implement the

 70 # changes. On completion of this script we will need to remove the default route

 71 # and add a new default that goes via the bond1 gateway. This is done in the 

 72 # setDefaultRouting.sh that will be generated as part of the genCNNetFiles.sh.

 73 #

 74 # Version History

 75 # 1.0.0 - Initial Realease

 76 #

 77 ################################################################################

 78 

 79 

 80 # Define Variables

 81 BAK_EXT=`date +"%Y%m%d-%H%M%S"`

 82 BAK_PREFIX=Orig

 83 

 84 SYSCONFROOT=/etc/sysconfig

 85 IFCFGROOT=$SYSCONFROOT/network-scripts

 86 

 87 NETWORKFILE=$SYSCONFROOT/network

 88 BACKUPNETWORKFILE=$SYSCONFROOT/$BAK_PREFIX.network.$BAK_EXT

 89 

 90 SYSCTLFILE=/etc/sysctl.conf

 91 BACKUPSYSCTLFILE=/etc/$BAK_PREFIX.sysctl.conf.$BAK_EXT

 92 

 93 BOND1IP=

 94 BOND1NM=

 95 BOND1GW=

 96 ETH4MAC=

 97 ETH5MAC=

 98 

 99 COMPUTENODE=

100 

101 # Setting the following variable to true will cause the /etc/sysctl.conf file

102 # to be edited so that the net.ipv4.conf.default.rp_filter = 2

103 # This is not recommended for production.

104 CHANGESYSCTL=false

105 

106 # Read Parameters

107 while [ $# -gt 0 ]

108 do

109         case "$1" in

110                 -r) IFCFGROOT="$2"; shift;;

111                 -ip) BOND1IP="$2"; shift;;

112                 -nm) BOND1NM="$2"; shift;;

113                 -gw) BOND1GW="$2"; shift;;

114                 -m4) ETH4MAC="$2"; shift;;

115                 -m5) ETH5MAC="$2"; shift;;

116                 -cn) COMPUTENODE="$2"; shift;;

117                 *) echo ""; echo >&2 \

118                     "usage: $0 [-r ] -ip  -nm  -gw  -m4  -m5  "

119                     echo""; exit 1;;

120                 *) break;;

121         esac

122         shift

123 done

124 

125 echo ""

126 echo "***** Starting Processessing on Compute Node $COMPUTENODE *****"

127 echo ""

128 

129 # Set File Names

130 

131 IFCFG_BOND1=$IFCFGROOT/ifcfg-bond1

132 IFCFG_ETH4=$IFCFGROOT/ifcfg-eth4

133 IFCFG_ETH5=$IFCFGROOT/ifcfg-eth5

134 

135 BAK_IFCFG_BOND1=$IFCFGROOT/$BAK_PREFIX.ifcfg-bond1.$BAK_EXT

136 BAK_IFCFG_ETH4=$IFCFGROOT/$BAK_PREFIX.ifcfg-eth4.$BAK_EXT

137 BAK_IFCFG_ETH5=$IFCFGROOT/$BAK_PREFIX.ifcfg-eth5.$BAK_EXT

138 

139 # Backup any existing files

140 if [ -f $IFCFG_BOND1 ] 

141 then

142         mv $IFCFG_BOND1 $BAK_IFCFG_BOND1

143 fi

144 if [ -f $IFCFG_ETH4 ] 

145 then

146         mv $IFCFG_ETH4 $BAK_IFCFG_ETH4

147 fi

148 if [ -f $IFCFG_ETH5 ] 

149 then

150         mv $IFCFG_ETH5 $BAK_IFCFG_ETH5

151 fi

152 

153 # Generate Bond1 (10 Gb Ethernet File)

154 

155 > $IFCFG_BOND1

156 echo "DEVICE=bond1" >> $IFCFG_BOND1

157 echo "IPADDR=$BOND1IP" >> $IFCFG_BOND1

158 echo "NETMASK=$BOND1NM" >> $IFCFG_BOND1

159 echo "BOOTPROTO=none" >> $IFCFG_BOND1

160 echo "USERCTL=no" >> $IFCFG_BOND1

161 echo "TYPE=Ethernet" >> $IFCFG_BOND1

162 echo "ONBOOT=yes" >> $IFCFG_BOND1

163 echo "IPV6INIT=no" >> $IFCFG_BOND1

164 echo "BONDING_OPTS=\"mode=active-backup miimon=100 downdelay=5000 updelay=5000\"" >> $IFCFG_BOND1

165 # Do I need the Gateway or just set it in /etc/sysconfig/network as per EIS Checklist

166 echo "GATEWAY=$BOND1GW" >> $IFCFG_BOND1

167 

168 # Process Network file

169 # Backup

170 mv $NETWORKFILE $BACKUPNETWORKFILE

171 

172 while read line

173 do

174         len=${#line}

175         if [ $len -eq 0 ]

176         then

177                 continue

178         fi

179         f7=`expr substr $line 1 7`

180         if test "$f7" != "GATEWAY"

181         then

182                 echo $line >> $NETWORKFILE

183         fi

184 done < $BACKUPNETWORKFILE

185 echo "GATEWAY=$BOND1GW" >> $NETWORKFILE

186 echo "GATEWAYDEV=bond1" >> $NETWORKFILE

187 

188 echo "Edited $NETWORKFILE file"

189 

190 # Generate ETH4 

191 

192 > $IFCFG_ETH4

193 echo "DEVICE=eth4" >> $IFCFG_ETH4

194 echo "BOOTPROTO=none" >> $IFCFG_ETH4

195 echo "ONBOOT=yes" >> $IFCFG_ETH4

196 echo "HWADDR=$ETH4MAC" >> $IFCFG_ETH4

197 echo "MASTER=bond1" >> $IFCFG_ETH4

198 echo "SLAVE=yes" >> $IFCFG_ETH4

199 

200 # Generate ETH5 

201 

202 > $IFCFG_ETH5

203 echo "DEVICE=eth5" >> $IFCFG_ETH5

204 echo "BOOTPROTO=none" >> $IFCFG_ETH5

205 echo "ONBOOT=yes" >> $IFCFG_ETH5

206 echo "HWADDR=$ETH5MAC" >> $IFCFG_ETH5

207 echo "MASTER=bond1" >> $IFCFG_ETH5

208 echo "SLAVE=yes" >> $IFCFG_ETH5

209 

210 

211 # Complete Message

212 

213 echo "Generated New ifcfg files"

214 echo "          $IFCFG_BOND1"

215 echo "          $IFCFG_ETH4"

216 echo "          $IFCFG_ETH5"

217 

218 if test "$CHANGESYSCTL" = "true"

219 then

220         # Change the /etc/sysctl.conf so that the default filtering is 2

221         # This will allow the normal & 10 Gb network access

222 

223         # Backup

224         mv $SYSCTLFILE $BACKUPSYSCTLFILE

225         

226         while read line

227         do

228                 len=${#line}

229                 if [ $len -eq 0 ]

230                 then

231                         echo "" >> $SYSCTLFILE

232                 fi

233                 

234                 i=0

235                 for el in $line

236                 do

237                         i=`expr $i + 1`

238                         if [ $i -eq 1 ]

239                         then

240                                 if test "$el" = "net.ipv4.conf.default.rp_filter"

241                                 then

242                                         echo "net.ipv4.conf.default.rp_filter = 2" >> $SYSCTLFILE

243                                 else

244                                         echo $line >> $SYSCTLFILE

245                                 fi

246                                 break

247                         fi

248                 done

249         done < $BACKUPSYSCTLFILE

250         

251         echo "Editted $SYSCTLFILE file"

252 fi

253 

254 # Restarting Network

255 

256 service network restart

257 

258 echo ""

259 echo "***** Finished Processessing on Compute Node $COMPUTENODE *****"

260 echo ""

261 

262

vIPs

Virtual IPs are useful when multiple, virtual, IPs for a single compute node and we have used this when running multiple WLS domains on the same Compute Node. Using vIPs allows you the create all the domains with the same port number but different IP address. The net result is that we can simplify HA / Failover and load balancing.

The simple script below will generate a specified number of, sequential, vIPs with a given Netmask for a given bond.

genVNICsFromLinkListUp.sh

  1 #!/bin/sh

  2 

  3 ################################################################################

  4 #

  5 #       Exalogic EL X2-2 1.0 (Linux x86-64) Configuration Script.

  6 #

  7 #  HEADER START

  8 # 

  9 #  THIS SCRIPT IS PROVIDED ON AN �AS IS� BASIS, WITHOUT WARRANTY OF ANY KIND, 

 10 #  EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT 

 11 #  THE COVERED SCRIPT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR 

 12 #  PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 

 13 #  OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE 

 14 #  DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER 

 15 #  CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION.

 16 #  NO USE OF ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 

 17 #  DISCLAIMER.

 18 #

 19 #  When distributing this Code, include this HEADER in each file.

 20 #  If applicable, add the following below this this HEADER, with the fields

 21 #  enclosed by brackets "[]" replaced with your own identifying information:

 22 #       Portions Copyright [yyyy] [name of copyright owner]

 23 # 

 24 #  HEADER END

 25 # 

 26 # 

 27 #       Copyright 2011 Andrew Hopkinson, Oracle Corporation UK Ltd.

 28 #

 29 ################################################################################

 30 

 31 

 32 ################################################################################

 33 #

 34 # createVLANs.sh

 35 # ==============

 36 #

 37 # Version : 1.0.0

 38 #

 39 # This scripts simply creates a number of VLANs for a specified bond. The script

 40 # must be provided with all the parameters and will then simply loop starting at

 41 # the first IP Address and incrementing by 1 until it has processed the specified 

 42 # number. 

 43 #

 44 # Parameters

 45 #

 46 #   -ip : Starting IP Address in the format 192.168.12.1.

 47 #   -nm : Netmask (i.e. 255.255.255.0)

 48 #   -c  : Number of VLANs to create

 49 #   -b  : Bond on which the VLANs should be created (bond0 or bond1)

 50 #

 51 # Version History

 52 # 1.0.0 - Initial Realease

 53 #

 54 ################################################################################

 55 

 56 

 57 # functions

 58 usage()

 59 {

 60         echo ""

 61         echo >&2 "usage: $0 [-ip Starting IP] [-nm Netmask] [-c Number of IPs require] [-b Bond]"

 62         echo""

 63 }

 64 

 65 SBIN=/sbin

 66 

 67 while [ $# -gt 0 ]

 68 do

 69         case "$1" in

 70                 -ip) STARTIP="$2"; shift;;

 71                 -nm) MASK="$2"; shift;;

 72                 -c) COUNT="$2"; shift;;

 73                 -b) BOND="$2"; shift;;

 74                 -sbin) SBIN="$2"; shift;;

 75                 *) usage; exit 1;;

 76                 *) break;;

 77         esac

 78         shift

 79 done

 80 

 81 if test "$STARTIP" = ""

 82 then

 83         echo "Starting IP Address must be specified"

 84         usage

 85         exit 1;

 86 fi

 87 if test "$MASK" = ""

 88 then

 89         echo "Netmask must be specified"

 90         usage

 91         exit 1;

 92 fi

 93 if test "$COUNT" = ""

 94 then

 95         echo "Number of IP Addresses must be specified"

 96         usage

 97         exit 1;

 98 fi

 99 if test "$BOND" = ""

100 then

101         echo "Bond must be specified"

102         usage

103         exit 1;

104 fi

105 

106 # Strip out the constituent parts of the IP Address

107 ip=$STARTIP

108 for i in 1 2 3

109 do

110         pos=`expr index $ip .`

111         if [ $i -eq 1 ]

112         then

113                 ip1=${ip:0:$pos}

114         fi

115         if [ $i -eq 2 ]

116         then

117                 ip2=${ip:0:$pos}

118         fi

119         if [ $i -eq 3 ]

120         then

121                 ip3=${ip:0:$pos}

122         fi

123         if [ $i -eq 4 ]

124         then

125                 ip4=${ip:0:$pos}

126         fi

127         ip=${ip:$pos}

128         ip4=$ip

129 done

130 

131 # Loop through and create VLANS

132 for (( i=1; i<=$COUNT; i++ ))

133 do

134         ip=$ip1$ip2$ip3$ip4

135         $SBIN/ifconfig $BOND:$i $ip netmask $MASK up

136         $SBIN/arping -q -U -c 3 -I $BOND $ip

137         ip4=`expr $ip4 + 1`

138 done

139 

140 ip4=`expr $ip4 - 1`

141 ENDIP=$ip1$ip2$ip3$ip4

142 

143 echo "Creating a ifcfg file to make permenant"

144 echo ""

145 

146 BAK_EXT=`date +"%Y%m%d-%H%M%S"`

147 IFCFG_FILE="/etc/sysconfig/network-scripts/ifcfg-$BOND"

148 VIP_RANGE_FILE="$IFCFG_FILE-range0"

149 BACKUP_VIP_RANGE_FILE=Orig.$VIP_RANGE_FILE.$BAK_EXT

150 mv $VIP_RANGE_FILE $BACKUP_VIP_RANGE_FILE

151 

152 while read line

153 do

154         f6=${line:0:6}

155         if test "$f6" = "IPADDR"

156         then

157                 echo $line

158         else

159                 echo $line >> $VIP_RANGE_FILE

160         fi

161 done < $IFCFG_FILE

162 

163 echo "IPADDR_START=$STARTIP" >> $VIP_RANGE_FILE

164 echo "IPADDR_END=$ENDIP" >> $VIP_RANGE_FILE

165 echo "CLONENUM_START=1" >> $VIP_RANGE_FILE

166 

167 echo ""

168 echo "Created VLANs $STARTIP to $ENDIP on $BOND"

169 echo ""

170 

171

vLANs

Virtual LANs are used to combine multiple domains and hence IP subnets onto a single physical port. The be fully configured both ends of the connected cable must be capable and configured for vLANs and hence I will assume this is the case. We use vLANs to enforce security isolation, division of workload and splitting traing across multiple domains / subnets.

A simple scenario (I will document more in later articles) would be to partition the Exalogic so that we can run Production, Test and Development on the same box but keep their 10Gb Ethernet connection isolated.

To create a vLAN (no script for this one) we simply issue the createvlan command on the switch as follows.

createvlan  -vlan  -pkey default

Where:

ETH Port : Ethernet Port on the switch e.g. 0A-ETH-3, 1A-ETH-1, etc
Unique number between 2 and 4094

As long as the VLAN IDs are unique we can create multiple vLANs on each of the ports.
At this point to enforce the network issolation we will associated the newly created vLANs to specific vNICs and hence Compute Nodes. At present the scripts for creating vNICs do not do this but it can be easily achived by modifying the generated Create---VNICs.sh to add the -vlan argument to specify the required vLAN ID.