Memo: monster.danly.com publishing
Date: 1/18/2001, revised 2/16/2001
By:   Charles Roth, IBS

Publishing the websphere "Danly" store interface files to monster.danly.com
involved the following steps:

1. /opt/IBMHTTPD/conf/httpd.conf changes:

   (a) Enable server-side parsing of regular .html files

       AddHandler server-parsed .shtml .html

       <Directory />
       Options FollowSymLinks +Includes
       AllowOverride None
       </Directory>

   (b) Alias /idanly

       #---Alias for store interface "idanly", 1/18/2001 Charles Roth.
       Alias   /idanly         "/opt/WebSphere/CommerceSuite/stores/idanly"

   Note that if changes are made to the commercesuite instance, say from
   the configuration manager, the httpd.conf file gets rewritten!  And
   some of these changes (notably the /idanly alias) get lost.  So there's
   a backup copy in the same directory, called httpd.roth.
   

2. Turn off caching for the instance, so that changes to the macro
   files would take effect immediately.

       (From configuration manager, stop instance, choose settings,
        caching, "no caching", start instance.)

   Once the store is 100% functioning properly, caching should be turned
   back on to improve performance.


3. Copied the entire "idanly" directory (and all subdirs, which include
   product images, interface images, macro files, etc.) to
   /opt/WebSphere/CommerceSuite/stores/idanly.

   Created a top-level index.html in "stores" that has a link to
   the above.  This file will probably eventually disappear, but
   is useful now for testing, especially if we have multiple versions
   of the interface active simultaneously.

   Note: all of these files are owned by root.  This is bad practice... 
   as soon as I can check the original install guide, I'll find out how 
   the proper ownership of these files should work.


4. Redirect the BAD_REG, BAD_REG_MODIFY, and AUDIT_REG_ERR tasks that get
   called by the RegisterNew command when an error occurs.
   They now all run /macros/err_reg.d2w.  Specifically, change 
   MACROS rows MARFNBR=1002, 1010, and 1014 to set 
   MAFILENAME='/macros/err_reg.d2w'.

   Add err_reg.d2w to /macros so that it uses $(idn) to include the
   proper interface's copy of err_reg.d2w.  (Just like all the other
   files in /macros.)


5. Redirect the ORD_OK view task that gets called by the OrderProcess
   command, so that it executes one of our .d2w files.

   Create ...stores/macros/orderaccept.d2w that redirects to
          ...stores/$(idn)/orderaccept.d2w

   Change the entry in the MACROS table for ORD_OK to be 
   "/macros/orderaccept.d2w"


6. Redirect the LOGON_ERR task that gets called by the Logon command,
   so that in case of user error (bad password, etc.), it still
   goes to the home.d2w page.  Specifically, change all rows in
   MACROS with MARFNBR=1013 to have an MAFILENAME value of
   "/macros/home.d2w".


7. Make sure that the db2www.ini commerce suite configuration file
   defines the DTW_SMTP_SERVER parameter, with the full DNS hostname
   of a server that will handle SMTP mail.  This file is usually found
   in the root document directory of the /opt/IBMHTTPD web server.


8. In ncadmin, under Site manager, configure the messaging system.
   Make sure e-mail delivery is both installed and active.  Make
   sure, under the e-mail "setup" form, that the server name and
   site administrator's e-mail address are both properly set.


9. Edit /opt/WebSphere/CommerceSuite/templates/en_US/pwdresetmsg.tpl
   to provide the proper text of the e-mail message that is received
   when a user resets their (forgotten) password.


10. In db2www.ini, look for the EXEC_PATH parameter.  It should
   (probably) include the directory /opt/IBMNetData/macro.  Whatever
   directory(ies) it does designate, copy the mailto.sh script into
   that directory and make it world readable/executable.


11. Redirect the BAD_PWD_RESET and CHECK_CHANS_ERR tasks that get
   called by the ResetPassword command when an error occurs.
   They now both run /macros/forgot.d2w.  Specifically, change 
   MACROS rows MARFNBR=9066 and 9069 to set MAFILENAME='/macros/forgot.d2w'.

   Add forgot.d2w to /macros so that it uses $(idn) to include the
   proper interface's copy of forgot.d2w.  (Just like all the other
   files in /macros.)