(The following instructions are based on Manish Kapur's Installing TWiki on Sun Java System Web Server. These instructions complement Manish's 2005 blog post)

The goal is to get the TWiki up and running on Sun Java Web Server (formerly known as Sun ONE Web Server / iPlanet Web Server). The assumption is that Sun Java Web Server is running on the Solaris operating system.

Steps:

1. Create 'twiki' user.
   

   % mkdir /export/twiki
   % useradd -d /export/twiki -s /bin/bash twiki
   % cd /export
   % chown twiki:other twiki
   % passwd twiki

   
   
2. Install Sun Java Web Server 7.0 Update 2 in /export/twiki/sjws7u2 directory. Select 'Custom' installation; and choose port '8080' to run the web server.
   
   Sun Java Web Server 7.0 Update 2 is available for free at Sun Downloads web site.
           View by Category -> Web & Proxy Servers -> Web Servers -> Web Server 7.0 Update 2.
   
   
3. Install TWiki 4.2.0
   
   Download TWiki tgz file
   

   % mkdir /export/twiki/sjws7u2/https-<hostname>/docs/twiki
   % cp TWiki-4.2.0.tgz /export/twiki/sjws7u2/https-<hostname>/docs/twiki
   % cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki
   % gunzip TWiki-4.2.0.tgz
   % tar xf TWiki-4.2.0.tar

   
   
4. Enable CGI on the web server
   
   
   • cd /export/twiki/sjws7u2/https-<hostname>/config
     
     
   • Edit the 'default' section of obj.conf file to include the following two lines
     
     NameTrans fn="pfx2dir" from="/twiki/view" dir="/export/twiki/sjws7u2/<hostname>/docs/twiki/bin/view" name="cgi"
Service fn="send-cgi" type="magnus-internal/cgi" nice="10"
     
     Hopefully the following example gives an idea on where to insert those two lines. In the example, 't2000-240-08' is the hostname.
     

      % diff -C 3 obj.conf obj.conf.orig
     
     *** obj.conf    Wed May 14 01:36:34 2008
     --- obj.conf.orig       Wed May 14 01:02:52 2008
     ***************
     *** 10,17 ****
       AuthTrans fn="match-browser" browser="*MSIE*" ssl-unclean-shutdown="true"
       NameTrans fn="ntrans-j2ee" name="j2ee"
       NameTrans fn="pfx2dir" from="/mc-icons" dir="/export/twiki/sjws7u2/lib/icons" name="es-internal"
     - # Consider anything in the directory /export/twiki/sjws7u2/https-t2000-240-08/docs/twiki/bin to be a CGI
     - NameTrans fn="pfx2dir" from="/twiki/view" dir="/export/twiki/sjws7u2/https-t2000-240-08/docs/twiki/bin/view" name="cgi"
       PathCheck fn="uri-clean"
       PathCheck fn="check-acl" acl="default"
       PathCheck fn="find-pathinfo"
     --- 10,15 ----
     ***************
     *** 20,27 ****
       ObjectType fn="type-j2ee"
       ObjectType fn="type-by-extension"
       ObjectType fn="force-type" type="text/plain"
     - # Run CGI processes with a "Nice" level of 10
     - Service fn="send-cgi" type="magnus-internal/cgi" nice="10"
       Service method="(GET|HEAD)" type="magnus-internal/directory" fn="index-common"
       Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" fn="send-file"
       Service method="TRACE" fn="service-trace"
     --- 18,23 ----

   
   
5. Install Revision Control System (RCS), GNU diff utilities (diffutils) and update the PATH variable in user's .profile.
   
   Those packages are available in 'ready to install' form at sunfreeware.com and blastwave.org web sites. Perhaps the easiest way is to use pkg-get to pull those packages with the required dependencies from Blastwave.
   
   Assuming RCS and diffutils are available under /usr/csw/bin directory,
   

   % cat ~/.profile | grep PATH
   export PATH=/usr/bin:/usr/sbin:/usr/local/bin:/usr/sfw/bin:/usr/csw/bin:$PATH

   
   
6. Configure the TWiki. Edit TWiki's *.cfg files, that is.
   
   
   1. Create the config file LocalLib.cfg.
      
      
      1. There is a template for this config file in twiki/bin/LocalLib.cfg.txt. Copy LocalLib.cfg.txt to LocalLib.cfg.
         

         % cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki/bin
         % cp LocalLib.cfg.txt LocalLib.cfg

         
         
      2. Edit LocalLib.cfg to update the $twikiLibPath variable.
         $twikiLibPath = "/export/twiki/sjws7u2/https-<hostname>/docs/twiki/lib";
      
      
      
   2. Manually create the config file LocalSite.cfg.
      

      % cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki/lib
      % cp TWiki.spec LocalSite.cfg

      
      
   3. Update the following variables with appropriate values in LocalSite.cfg.
      
      $TWiki::cfg{DefaultUrlHost}, $TWiki::cfg{ScriptUrlPath}, $TWiki::cfg{PubUrlPath}, $TWiki::cfg{PubDir}, $TWiki::cfg{TemplateDir}, $TWiki::cfg{DataDir}, $TWiki::cfg{LocalesDir}, and $TWiki::cfg{OS}, $TWiki::cfg{RCS}{EgrepCmd} and $TWiki::cfg{RCS}{FgrepCmd}.
      
      This diff output shows how they were configured in the demo TWiki that I used for the Proof-Of-Concept (POC). The hardware it was deployed on is a Sun Fire T2000. So Cool Stack was installed on the server to take advantage of the optimized Perl.
   
   
7. Exit the current shell; and reconnect.
   
   
8. Restart the Sun Java Web Server.
   

   % cd /export/twiki/sjws7u2/https-<hostname>/bin
   % ./stopserv
   % ./startserv

   
   
9. Manually execute the 'view' script from the command line.
   

   % cd /export/twiki/sjws7u2/https-/docs/twiki/bin
   % ./view

   
   You should see valid HTML (not errors) on the stdout. If you see errors, check /export/twiki/sjws7u2/https-<hostname>/logs/errors for the error messages. Fix the issues and re-run 'view' from the command line. Continue this exercise until the script returns valid HTML.
   
   
10. Finally verify the TWiki installation through the web browser.
            Open http://<webhost>:<port>/twiki/view in a web browser.

References:

1. Installing TWiki on Sun Java System Web Server by Manish Kumar, Sun Microsystems
   
2. Using PHP on Sun Java System Web Server by Joe McCabe, Sun Microsystems

________________
Technorati Tags:
TWiki | Sun Java Web Server

Sun Microsystems' own OpenSolaris distribution, OpenSolaris 2008.05, has been available for download for almost 3 weeks on the new web site www.opensolaris.com . Finally I had some time to test the Live CD on my Toshiba Tecra M2 notebook computer.

I have been monitoring this effort (project Indiana as Sun calls it) from the beginning - so, I'm not surprised to see the Ubuntu like graphical interface. I spent very little time checking what is working and what is not. I'm quite impressed with the Network Auto-Magic (NWAM). It worked out of the box. NWAM detected the available Wi-Fi networks; and configured the wireless network interface in the first shot. However I could not figure out how to bring up the NWAM GUI, just in case if I need to connect to a different Wi-Fi network. The workaround seems to remove the file /etc/nwam/known_wifi_nets, restart the NWAM daemon (svcadm restart nwam) and to restart the GDM session (simply logout) to see the NWAM GUI window popped with the list of available networks. If that's the case, it needs to be fixed.


I am also impressed with the way the Live CD mounted the existing file systems on /mnt/solaris* mount points. It eliminated the need to run format and to mount those file systems manually.

The much awaited Image Packaging System (IPS) debuted in this release. There doesn't seem to be an usable graphical interface for IPS at the moment. Command line works mostly, but requires the package names to be accurate (check the image). It should be able to show the available packages even when the user searches with a partial keyword.


Sun is making good progress with the project Indiana. Hopefully it gets better with each and every release.

[Updated 05/24/08 12:42 PM] For those desktop users who like eye candy interface, OpenSolaris 2008.05 comes with Compiz 3D window manager. Assuming the hardware has the required graphic card, the Compiz window manager can be quickly enabled by selecting System -> Preferences -> Appearance -> Visual Effects -> Extra.

Some screenshots from my laptop with the nVidia GeForce FX Go5200 32M/64M graphic card:


Currently I have Solaris Nevada build 79 installed on my notebook computer. I'm using this laptop as my primary workstation; and I cannot afford any downtime at this time. So wiping out the existing Nevada build and installing OpenSolaris 2008.05 is not a feasible option. However it might be interesting to install OpenSolaris 2008.05 as a guest OS under xVM on the very same laptop.
________________
Technorati Tags:
Sun | OpenSolaris

Oracle 10g RDBMS has some useful features to automate SQL tuning up to some extent. The SQL Tuning Advisor of Oracle 10g helps us in optimizing poorly written/tuned SQL statements. SQL Tuning Advisor can be used from the command line SQL*Plus environment or from the web based Enterprise Manager. The optimizer runs in the 'tuning' mode under the SQL Tuning Advisor; collects the SQL profile data and tries to improve the performance of the SQL by creating new indexes, gathering {additional} statistics, etc., In case of significant improvements, the potential SQL profile can be accepted and saved in the database, so the optimizer can use the potential SQL profile while executing similar SQL statements in the 'normal' mode.

Sometimes it is desirable to use similar SQL profile(s) in environments running similar databases -- Testing and Production database environments, for example. As long as the SQL tuning advisor's recommendations are within the boundaries of the database system administrator, it is easy to manually replicate one system's behavior on another. However in some cases it is beyond the control of a DBA to replicate the database system behavior - for example, optimizer might suggest a completely different explain plan based on some internal heuristics. In such cases it is hard to replicate similar behavior by hand. Fortunately the Transportable SQL Profile feature of Oracle Database 10g makes it possible to export the SQL profiles from one system to another in just few steps.

Without further ado, let's have a look at the necessary steps with examples.

1. On the source system, create the staging table. The staging table will be used to store the contents of the SQL Profile.
   
   eg.,
   

   % sqlplus / as sysdba
   
   SQL*Plus: Release 10.2.0.3.0 - Production on Fri Apr 11 01:47:39 2008
   Copyright (c) 1982, 2006, Oracle.  All Rights Reserved.
   
   SQL> execute DBMS_SQLTUNE.CREATE_STGTAB_SQLPROF(table_name => 'CS90_BATCH_PROFILE_STGTAB');
   
   PL/SQL procedure successfully completed.

   
   The name of the {staging} table is CS90_BATCH_PROFILE_STGTAB.
   
   
2. Load the contents of the SQL Profile into the staging table. To perform this step, you need to know the SQL profile name. When the profile is accepted, you can either specify a name of your choice for the profile, or accept the system generated name.
   
   

    SQL> execute DBMS_SQLTUNE.PACK_STGTAB_SQLPROF (profile_name => 'SYS_SQLPROF_01464eb777e6c001', 
           staging_table_name => 'CS90_BATCH_PROFILE_STGTAB');
   
   PL/SQL procedure successfully completed.

   
   In this example, the name of the SQL Profile being loaded is SYS_SQLPROF_01464eb777e6c001, a system generated name.
   
   Note #1:
   You can store as many SQL profiles as you wish in the staging table. The following example, loads another SQL profile called SYS_SQLPROF_01464eb83e5f8002, another system generated name.
   
   

    SQL> execute DBMS_SQLTUNE.PACK_STGTAB_SQLPROF (profile_name => 'SYS_SQLPROF_01464eb83e5f8002', 
           staging_table_name => 'CS90_BATCH_PROFILE_STGTAB');
   
   PL/SQL procedure successfully completed.

   
   
3. Export the staging table (CS90_BATCH_PROFILE_STGTAB in this example) to the destination system using Data Pump, exp utility or DB Links.
   

    % exp \'CS90/CS90 AS SYSDBA\' FILE=CS90BatchSQLprofiles.DMP TABLES=CS90_BATCH_PROFILE_STGTAB
   
   Export: Release 10.2.0.3.0 - Production on Fri Apr 11 02:02:12 2008
   Copyright (c) 1982, 2005, Oracle.  All rights reserved.
   
   Connected to: Oracle Database 10g Enterprise Edition Release 10.2.0.3.0 - 64bit Production
   With the Partitioning, OLAP and Data Mining options
   Export done in UTF8 character set and UTF8 NCHAR character set
   server uses WE8ISO8859P15 character set (possible charset conversion)
   
   About to export specified tables via Conventional Path ...
   . . exporting table      CS90_BATCH_PROFILE_STGTAB          2 rows exported
   Export terminated successfully without warnings.

   
   Note #2:
   Since the string "AS SYSDBA" contains a blank, most operating systems require that entire string '<username>/<password> AS SYSDBA' be placed in quotes or marked as a literal by some method. Be aware that some operating systems also require that quotes on the command line be escaped as well.
   
   
4. On the destination system, import the staging table into the database.
   
   eg., Import the staging table, CS90_BATCH_PROFILE_STGTAB, into the destination database using Data Pump, imp utility or DB Links.
   
   

    % imp \'CS90/CS90 AS SYSDBA\' FILE=CS90BatchSQLprofiles.DMP TABLES=CS90_BATCH_PROFILE_STGTAB
   
   Import: Release 10.2.0.3.0 - Production on Fri Apr 11 02:06:57 2008
   Copyright (c) 1982, 2005, Oracle.  All rights reserved.
   
   Connected to: Oracle Database 10g Enterprise Edition Release 10.2.0.3.0 - 64bit Production
   With the Partitioning, OLAP and Data Mining options
   
   Export file created by EXPORT:V10.02.01 via conventional path
   import done in UTF8 character set and UTF8 NCHAR character set
   import server uses WE8ISO8859P15 character set (possible charset conversion)
   . importing SYS's objects into SYS
   . importing SYS's objects into SYS
   IMP-00015: following statement failed because the object already exists:
    "CREATE TYPE "SQLPROF_ATTR" TIMESTAMP '2008-02-02:00:37:22' OID 'AE1A3645A6B"
    "D1155E0340800209420B8'      "
    "                                                                       AS V"
    "ARRAY(2000) of VARCHAR2(500)"
   . . importing table    "CS90_BATCH_PROFILE_STGTAB"          2 rows imported
   Import terminated successfully with warnings.

   
   
5. Download SQL Profile content from the staging table to create equivalent SQL profile(s) in the destination database.
   
   

    % sqlplus / as sysdba
   
   SQL*Plus: Release 10.2.0.3.0 - Production on Fri Apr 11 02:08:02 2008
   Copyright (c) 1982, 2006, Oracle.  All Rights Reserved.
   
   Connected to:
   Oracle Database 10g Enterprise Edition Release 10.2.0.3.0 - 64bit Production
   With the Partitioning, OLAP and Data Mining options
   
   SQL> desc CS90_BATCH_PROFILE_STGTAB
    Name                                      Null?    Type
    ----------------------------------------- -------- ----------------------------
    PROFILE_NAME                                       VARCHAR2(30)
    CATEGORY                                           VARCHAR2(30)
    SIGNATURE                                          NUMBER
    SQL_TEXT                                           CLOB
    DESCRIPTION                                        VARCHAR2(500)
    TYPE                                               VARCHAR2(9)
    STATUS                                             VARCHAR2(8)
    BOOLEAN_FLAGS                                      NUMBER
    ATTRIBUTES                                         SQLPROF_ATTR
    VERSION                                            NUMBER
    SPARE1                                             CLOB
    SPARE2                                             BLOB
   
   SQL> execute DBMS_SQLTUNE.UNPACK_STGTAB_SQLPROF( replace => FALSE, staging_table_name => 'CS90_BATCH_PROFILE_STGTAB');
   
   PL/SQL procedure successfully completed.

   
   [New:09/05/09]
   Note #3:
   By default the staging will be created in SYS schema. If you want it to be created in a different schema, specify the schema owner.
   
   

   SQL> execute DBMS_SQLTUNE.UNPACK_STGTAB_SQLPROF( replace => FALSE, staging_table_name => 'CS90_BATCH_PROFILE_STGTAB', staging_schema_owner  => 'CS90');
   
   PL/SQL procedure successfully completed.

   
   
6. Finally query the DBA_SQL_PROFILES table to make sure that the SQL profile(s) are successfully imported into the database.
   
   eg.,
   

    SQL> select NAME from DBA_SQL_PROFILES;
   
   NAME
   --------------------------------------------------------------------------------
   SYS_SQLPROF_01464eb83e5f8002
   SYS_SQLPROF_01464eb777e6c001
   ...
   ...

[New:09/05/09]
How to drop an SQL profile?

By using the DROP_SQL_PROFILE procedure in DBMS_SQLTUNE package.

eg.,

SQL> execute DBMS_SQLTUNE.drop_sql_profile (name => 'SYS_SQLPROF_01464eb83e5f8002', ignore => TRUE);

PL/SQL procedure successfully completed.

That is all there is in it. For further/detailed information around SQL Tuning Advisor and SQL profiles, check the following:

• Optimizing the Optimizer: Essential SQL Tuning Tips and Techniques. An Oracle White Paper
  
• Automatic SQL Tuning in Oracle Database 10g. Author: Tim. http://www.oracle-base.com

_____________
Technorati Tags:
Oracle | Database | SQL Tuning | Oracle Enterprise Manager