Testing chuiWeb on MAJIC server: 

1. Create on your home directory the following structure:

~/testing
    /majic
      /build
        /lib
      /run
        /server
      /p2j
        /build
          /lib
    
2. Download the MAJIC jar files to ~/testing/majic/build/lib

  $ scp -P 2224 $USER@localhost:~/testing/majic/build/lib/*.jar ~/testing/majic/build/lib/

3. Download MAJIC server configuration files from ~/testing/majic/run/server

You may download the entire folder which take some time:
  
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/* ~/testing/majic/run/server/

Or you can download only some specific files
  
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/*-directory.xml ~/testing/majic/run/server/
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/*_server.xml ~/testing/majic/run/server/
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/*.store ~/testing/majic/run/server/
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/*.sh ~/testing/majic/run/server/
  $ scp -P 2224 $USER@localhost:~/testing/majic/run/server/*.properties ~/testing/majic/run/server/

4. Build p2j project than the spawner and copy all the files from $P2J_HOME/build/lib to ~/testing/majic/p2j/build/lib
  
  $ ant all (jar)
  $ ant -Dhave.pam=yes -Dpost.build=yes native
  $ cp -r -v $P2J_HOME/build/lib/ ~/testing/majic/p2j/build/lib

5. Go to ~/testing/majic/run/server

  $ cd ~/testing/majic/run/server
  
6. Open the file gso-directory.xml using your preferred text editor and do the following changes:
   
 a.) Change PostgreSQL port number. 
     Go to the following node.
 
   <node-attribute name="value" value="jdbc:postgresql://localhost:<port_numer>/gso_20090909_staging"/>
   
   Replace the <port_number> with 25432. You already have a ssh tunnel when you run the gcd_remote.sh
   script which allow you to access the remote postgres server using the local port 25432.
   You can check by trying to connect to the postgres server using the pgAdmin GUI tool using:
     Host: localhost 
     Port: 25432.   
     Username and Password are listed on gso-directory.xml.

   <node-attribute name="value" value="jdbc:postgresql://localhost:25432/gso_20090909_staging"/>
   
 b.) Add gso server to the acl/admin/001300 node subjects list:

      <node class="container" name="acl">
        ...
        <node class="container" name="admin">
          ...
          <node class="container" name="001300">
            <node class="strings" name="subjects">
              <node-attribute name="values" value="admins"/>
              <!-- Add server names -->
              <node-attribute name="values" value="gso"/>
            </node>
            <node class="adminRights" name="rights">
              <node-attribute name="permissions" value="'01'B"/>
              <node-attribute name="type" value="0"/>
            </node>
            <node class="resource" name="resource-instance">
              <node-attribute name="reference" value="/"/>
              <node-attribute name="reftype" value="TRUE"/>
            </node>
          </node>
   
   NOTE: This settings are for gso server on which the tests has been done. 
   For other servers you should add also the name of specified server.
   Example:

   <node class="container" name="server">
      ...
      <node class="container" name="security">
         ...
         <node class="container" name="acl">
            ...
            <!- Change this node and add process name ->
            <node class="container" name="admin">
               <node class="container" name="001300">
                  <node class="strings" name="subjects">
                    <node-attribute name="values" value="admins"/>
                    <!-- Add server names -->
                    <node-attribute name="values" value="gso"/>
                    <node-attribute name="values" value="rfq"/>
                    <node-attribute name="values" value="lcq"/>
                    <node-attribute name="values" value="mcn"/>
                    <node-attribute name="values" value="osc"/>
                    <node-attribute name="values" value="gyr"/>
                  </node>
                  <node class="adminRights" name="rights">
                    <node-attribute name="permissions" value="'01'B"/>
                    <node-attribute name="type" value="0"/>
                  </node>
                  <node class="resource" name="resource-instance">
                    <node-attribute name="reference" value="/"/>
                    <node-attribute name="reftype" value="TRUE"/>
                  </node>
               </node>
   
 c.) Add chuiWeb node. At least the chuiWeb node must contains the enabled attribute set to true.
     If enabled node is missing or it value is false the chuiWeb is not available.

      <node class="container" name="gso">
        ...
        <node class="container" name="chuiWeb">
          <node class="boolean" name="enabled">
            <node-attribute name="value" value="TRUE"/>
          </node>
        </node>

   Default values are provided for missing attributes (see ClientBuilderOptions and TerminalOptions).
   The default values are suitable for testing purposes only and you are able to spawn web clients only for user account on which the P2J server is running.   

   The values from directory override the default values. On production some files should be shared by all accounts.
   A complete node should looks as follow:   
      
        <node class="container" name="chuiWeb">
          <node class="boolean" name="enabled">
            <node-attribute name="value" value="TRUE"/>
          </node>
          <node class="boolean" name="secure">
            <node-attribute name="value" value="TRUE"/>
          </node>
          <node class="string" name="spawner">
            <node-attribute name="value" value="/usr/share/p2j/spawn"/>
          </node>
          <node class="string" name="command">
            <node-attribute name="value" value="java"/>
          </node>
          <node class="integer" name="poolSize">
            <node-attribute name="value" value="8"/>
          </node>
          <node class="integer" name="30000">
            <node-attribute name="value" value="12"/>
          </node>
          <node class="string" name="jvmArgs">
            <node-attribute name="value" value="-Xmx512m -XX:MaxPermSize=64m -Djava.awt.headless=true"/>
          </node>
          <node class="string" name="classpath">
            <node-attribute name="value" value="/usr/share/p2j/lib/p2j.jar"/>
          </node>
          <node class="string" name="libPath">
            <node-attribute name="value" value="/usr/share/p2j/lib"/>
          </node>
          <node class="string" name="workingDir">
            <node-attribute name="value" value="./"/>
          </node>
          <node class="string" name="configFile">
            <node-attribute name="value" value="config.xml"/>
          </node>
          <node class="integer" name="rows">
            <node-attribute name="value" value="24"/>
          </node>
          <node class="integer" name="columns">
            <node-attribute name="value" value="80"/>
          </node>
          <node class="string" name="background">
            <node-attribute name="value" value="0x000000"/>
          </node>
          <node class="string" name="foreground">
            <node-attribute name="value" value="0xFFA500"/>
          </node>
          <node class="string" name="selection">
            <node-attribute name="value" value="0x0000FF"/>
          </node>
          <node class="string" name="fontname">
            <node-attribute name="value" value="monospaced"/>
          </node>
          <node class="integer" name="fontsize">
            <node-attribute name="value" value="12"/>
          </node>
        </node>
        
 d.) Add rights to access Spawn interface via RemoteObject protocol /server/security/acl/net/00240:

   <node class="container" name="server">
      ...
      <node class="container" name="security">
         ...
         <node class="container" name="acl">
            ...
            <node class="container" name="net">
               ...
               <!-- Add this node -->
               <node class="container" name="002400">
                  <node class="strings" name="subjects">
                    <node-attribute name="values" value="all_others"/>
                  </node>
                  <node class="netRights" name="rights">
                    <node-attribute name="permissions" value="'0101'B"/>
                  </node>
                  <node class="resource" name="resource-instance">
                    <node-attribute name="reference" value="com.goldencode.p2j.main.Spawner"/>
                    <node-attribute name="reftype" value="TRUE"/>
                  </node>
                </node>

 e.) Save your changes and exit from editor.
   
7. From the same location start the server.

  $ ./server.sh

8. Wait until the sever is ready. Check the server.log file from time to time:

  $ tail server.log
  
  until you'll see the following message:
  
  [12/23/2013 11:06:50 EET] (SessionManager.listen():INFO) {00000000:00000001:gso} Server ready
  
  or an error message if the server cannot be started for some reasons.
  
9. When the server is ready open the following URL on your web browser (Firefox):

  https://localhost:<gso_admin_port>/chui
  
  Where the <gso_admin_port> is the GSO admin port usually 7673.
  The <gso_admin_port> is also listed on the gso-directory.xml file.