[ic] (newbie) Setup for virtual hosts

Mark Jaffe interchange-users@interchange.redhat.com
Mon Mar 18 17:35:00 2002


--============_-1195642296==_============
Content-Type: text/plain; charset="us-ascii" ; format="flowed"

Hi, all; sorry for not checking the archives more fully. I downloaded 
and built ic on YellowDog Linux (PPC/RedHat-based) and am a little 
confused on some of the configuration details. I run Apache as a 
multi-host setup; a main page and CGI files are under user httpd, and 
I am setting up a store for user alex, whose site GeminiManor.com has 
a DocumentRoot at /usr2/sites/Gemini. Can anyone help who has a 
similar setup? The following shows some installation and setup logs, 
and it looks like there are permission problems that need to be 
resolved:

[root@wizdev interchange]# bin/makecat

Select a short, mnemonic name for the catalog. This will be
used to set the defaults for naming the catalog, executable,
and directory, so you will have to type in this name frequently.

NOTE: This will be the name of 'vlink' or 'tlink', the link CGI
program. Depending on your CGI setup, it may also have the
extension .cgi added.

Only the characters [-a-zA-Z0-9_] are allowed, and it is strongly suggested
that the catalog name be all lower case.

If you are doing the demo for the first time, you might use "foundation".

Catalog name? demo
makecat -- Interchange catalog installation program.

*** We will be making a catalog named 'demo'. ***

######### BEGINNING CATALOG CONFIGURATION #########
# The server name, something like: www.company.com
#                                  www.company.com:8000
#                                  www.company.com/~yourname
#
Server name? [wizdev.net]

# The type of demo catalog to use. The standard one distributed is:
#
#    foundation
#
# If you have defined your own custom template catalog,
# you can enter its name.
#
# If you are new to Interchange, use "foundation" to start with.


DemoType? [foundation]

# The type of permission structure for multiple user catalogs.
# Select M for each user in own group (with interchange user in group)
#        G for all users in group of interchange user
#        U for all catalogs owned by interchange user (must be catuser as well)
#
#        M is recommended, G works for most installations.


permtype? [M]

# The user name the Interchange server runs under on this machine. This
# should not be the same as the user that runs the HTTP server (i.e.
# NOT nobody).
#


InterchangeUser? [httpd]

#
# The user name the catalog will be owned by.
#


CatUser? alex

# The group name the server-owned files should be set to.  This is
# only important if Interchange catalogs will be owned by multiple users
# and the group to be used is not the default for the catalog user.
#
# Normally this is left blank unless G mode was selected above.
#


InterchangeGroup?

# The email address where orders for this catalog should go.
# To have a secure catalog, either this should be a local user name and
# not go over the Internet -- or use the PGP option.
#


MailOrderTo? [alex]

# Where the Interchange files for this catalog will go, pages,
# products, config and all.  This should not be in HTML document
# space! Usually a 'catalogs' directory below your home directory
# works well. Remember, you will want a test catalog and an online
# catalog.
#


CatRoot? [/home/alex/catalogs/demo]

# The location of the normal CGI directory. This is a
# file path, not a script alias.
#
# If all of your CGI programs must end in .cgi, this is
# should be the same as your HTML directory.
#


CgiDir? [/home/httpd/cgi-bin]

# The URL location of the CGI program, without the http://
# or server name.
#
# http://www.virtual.com/cgi-bin/prog
#                       ^^^^^^^^^^^^^
#
# http://www.virtual.com/program.cgi
#                       ^^^^^^^^^^^^
#


CgiUrl? [/cgi-bin/demo]

#
# Additional URL locations for the CGI program, as with CgiUrl.
# This is used when calling the catalog from more than one place,
# perhaps because your secure server is not the same name as the
# non-secure one.
#
# http://www.secure.domain/secure-bin/prog
#                         ^^^^^^^^^^^^^^^^
#
# We set it to the name of the catalog by default to enable the
# internal HTTP server.
#


Aliases? [/demo]

# The base directory for HTML for this (possibly virtual) domain.
# This is a directory path name, not a URL -- it is your HTML
# directory.
#


DocumentRoot? [/home/httpd/html] /usr2/sites/Gemini

# Where the sample HTML files (not Interchange pages) should be installed.
# There is a difference. Usually a subdirectory of your HTML directory.
#


SampleHtml? [/usr2/sites/Gemini/demo]

# Where the image files should be copied. A directory path
# name, not a URL.
#


ImageDir? [/usr2/sites/Gemini/demo/images]

# The URL base for the sample images. Sets the ImageDir
# directive in the catalog configuration file. This is a URL
# fragment, not a directory or file name.
#
#         <IMG SRC="/foundation/images/icon.gif">
#                   ^^^^^^^^^^^^^^^^^^
#


ImageUrl? [/demo/images]

Interchange can use either UNIX- or internet-domain sockets.
Most ISPs would prefer UNIX mode, and it is more secure.

If you already have a program there, or use a common program
and the FullURL directive, select NONE. You will then need
to copy the program by hand or otherwise ensure its presence.

INET or UNIX mode? [UNIX]
Do you use CGIWRAP or SUEXEC? [n]
Checking directories........................................mkdir 
/home/alex/catalogs
mkdir /home/alex/catalogs/demo
mkdir /usr2/sites/Gemini/demo
mkdir /usr2/sites/Gemini/demo/images
done.
Copying demo files..........................................found more to ask.

Your company name: ...............................[Foundation Store] 
Gemini Manor

You can choose to pre-populate your Foundation template with some
data which might be illustrative. You can always delete it later
and replace it with your own.

The types are:

     tools      Construct Something, includes products, users, orders
     reports    Marketing reports, downloadable softgoods, products, users
     none       No data. Same as leaving blank.

Sample data type?: ...............................[tools]

Interchange has a workable internal database, but many things will
work better (and a few worse) if you use a SQL database. Interchange
can configure MySQL, PostgreSQL, and Oracle in a test configuration.

Set to 1 if you want to use MySQL, PostgreSQL, Oracle, or DB2: ..1

You can select this to use MySQL in your test catalog. Careful!
This requires the ability to create a database named "test_foundation",
and is highly dependent on your Perl and MySQL configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use MySQL: ...............

You can select this to use PostgreSQL in your test catalog.
This requires the ability to create a database named "test_foundation",
and is highly dependent on your Perl and system configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use PostgreSQL: ..........

You can select this to use Oracle in your test catalog. This requires
that you know your Oracle DSN and that you've already created a user and
tablespace for Interchange. You should also have the environment variables
ORACLE_BASE, ORACLE_HOME, and ORACLE_SID set. Don't be too surprised if
this doesn't work.

Set to 1 if you want to use Oracle: ..............[1] 0

You can select this to use DB2 in your test catalog. Careful!
This requires the ability to create a database named "intchg",
and is highly dependent on your Perl and DB2 configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use DB2: .................0

You can use Interchange's companion configuration
interface, to do upload/download of files, manipulation of
the database, reconfiguration of the catalog, and much more.

To enable the UI, you will need a "super-user" account
name that has full access.

The initial password is "pass". CHANGE IT! You can do this
by going to the admin menu and selecting the superuser and
then "Change password".

Account name that will control this catalog: .....[alex]
Administrative password: .........................[pass]
Set to 1 to display demo helper features in your store: ..1

Found system commands to run.

done.
Moving link program to /home/httpd/cgi-bin/demo.............done.
Copying share/ files to /home/httpd/html....................done.
Moving HTML files to /usr2/sites/Gemini/demo................done.
Moving image files to /usr2/sites/Gemini/demo/images........done.

Found additional system commands to run.

We need to make some directories to store sessions, logs, and such.

run "sh /home/alex/catalogs/demo/config/makedirs"? [y]
You can install some sample data to start with in this catalog.
This script will install the sample (tools) you selected.

run "sh /home/alex/catalogs/demo/config/installsample"? [y]
Add catalog to interchange.cfg? [y]

Done with installation. If my reading of your input is correct, you
should be able to access the demo catalog with the following URL:

         http://wizdev.net/demo

In any case, you should get direct access at:

         http://wizdev.net/cgi-bin/demo

That is, after you START or RESTART the Interchange server.  8-)
It is best done with:



For session expiration, you might want to place a line like this in your
crontab:

44 4 * * * /home/httpd/interchange/bin/expireall -r

It will prevent the session databases from getting too large.
-------------------------- end of setup -----------------------------------
[root@wizdev /root]# ls -l /home/alex/catalogs/demo
total 64
drwxrws---    2 alex     alex         4096 Mar 13 23:19 backup
-rw-rw----    1 alex     alex        11908 Mar 13 23:19 catalog.cfg
drwxrws---    2 alex     alex         4096 Mar 13 23:19 config
drwxrws---    6 alex     alex         4096 Mar 13 23:19 dbconf
-rw-rw----    1 alex     alex            0 Mar 13 23:19 error.log
drwxrws---    2 alex     alex         4096 Mar 13 23:19 etc
lrwxrwxrwx    1 alex     alex           30 Mar 13 23:19 images -> 
/usr2/sites/Gemini/demo/images
drwxrws---    2 alex     alex         4096 Mar 13 23:19 logs
drwxrws---    2 alex     alex         4096 Mar 13 23:19 orders
drwxrws---    6 alex     alex         4096 Mar 13 23:19 pages
drwxrws---    2 alex     alex         4096 Mar 13 23:19 products
drwxrws---    2 alex     alex         4096 Mar 13 23:19 session
drwxrws---    2 alex     alex         4096 Mar 13 23:19 special_pages
drwxrws---    5 alex     alex         4096 Mar 13 23:19 templates
drwxrws---    2 alex     alex         4096 Mar 13 23:19 tmp
drwxrws---    2 alex     alex         4096 Mar 13 23:19 upload
[root@wizdev /root]# ls -l /usr2/sites/Gemini/demo
total 8
drwxrwxr-x    6 alex     alex         4096 Mar 13 23:19 images
-rw-rw-r--    1 alex     alex         2786 Mar 13 23:19 index.html

--------------------------
(Starting)
[root@wizdev /root]# su -c "/home/httpd/interchange/bin/interchange -r" httpd
Enter password:
Killing Interchange server 23623 with TERM.
Low traffic settings.
Calling UI......UI is loaded...
Interchange V4.8.3
Configuring catalog demo...
Couldn't change to /home/alex/catalogs/demo: Permission denied

demo: error in configuration. Skipping.
demo: config error -- Couldn't change to /home/alex/catalogs/demo: 
Permission denied. Skipping.
Configuring catalog sample...sample config error: Please specify the 
MailOrderTo directive in the configuration file ''



sample: error in configuration. Skipping.
sample: config error. Skipping.
Interchange server started in INET and UNIX mode(s) (process id 23660)
----------------------------------
Mark
-- 
==========================================================
Mark Jaffe          | (408) 972-9638 (home)
Chief Wizard        | (408) 807-1530 (cell/page/voicemail)
Computer Wizards    | (425) 795-6421 (FAX)
wizards@wizdev.net  | http://www.wizdev.net/
--============_-1195642296==_============
Content-Id: <a05100304b8bbeec2f60b@[10.0.1.2].0.0>
Content-Type: text/plain; name="install_log"; charset="us-ascii" ; format="flowed"
Content-Disposition: attachment; filename="install_log"
 ; modification-date="Thu, 14 Mar 2002 15:03:26 -0800"

[root@wizdev interchange]# bin/makecat

Select a short, mnemonic name for the catalog. This will be
used to set the defaults for naming the catalog, executable,
and directory, so you will have to type in this name frequently.

NOTE: This will be the name of 'vlink' or 'tlink', the link CGI
program. Depending on your CGI setup, it may also have the
extension .cgi added.

Only the characters [-a-zA-Z0-9_] are allowed, and it is strongly suggested
that the catalog name be all lower case.

If you are doing the demo for the first time, you might use "foundation".

Catalog name? demo
makecat -- Interchange catalog installation program.

*** We will be making a catalog named 'demo'. ***

######### BEGINNING CATALOG CONFIGURATION #########
# The server name, something like: www.company.com
#                                  www.company.com:8000
#                                  www.company.com/~yourname
#
Server name? [wizdev.net]

# The type of demo catalog to use. The standard one distributed is:
#
#    foundation
#
# If you have defined your own custom template catalog,
# you can enter its name.
#
# If you are new to Interchange, use "foundation" to start with.


DemoType? [foundation]

# The type of permission structure for multiple user catalogs.
# Select M for each user in own group (with interchange user in group)
#        G for all users in group of interchange user
#        U for all catalogs owned by interchange user (must be catuser as well)
#
#        M is recommended, G works for most installations.


permtype? [M]

# The user name the Interchange server runs under on this machine. This
# should not be the same as the user that runs the HTTP server (i.e.
# NOT nobody).
#


InterchangeUser? [httpd]

#
# The user name the catalog will be owned by.
#


CatUser? alex

# The group name the server-owned files should be set to.  This is
# only important if Interchange catalogs will be owned by multiple users
# and the group to be used is not the default for the catalog user.
#
# Normally this is left blank unless G mode was selected above.
#


InterchangeGroup?

# The email address where orders for this catalog should go.
# To have a secure catalog, either this should be a local user name and
# not go over the Internet -- or use the PGP option.
#


MailOrderTo? [alex]

# Where the Interchange files for this catalog will go, pages,
# products, config and all.  This should not be in HTML document
# space! Usually a 'catalogs' directory below your home directory
# works well. Remember, you will want a test catalog and an online
# catalog.
#


CatRoot? [/home/alex/catalogs/demo]

# The location of the normal CGI directory. This is a
# file path, not a script alias.
#
# If all of your CGI programs must end in .cgi, this is
# should be the same as your HTML directory.
#


CgiDir? [/home/httpd/cgi-bin]

# The URL location of the CGI program, without the http://
# or server name.
#
# http://www.virtual.com/cgi-bin/prog
#                       ^^^^^^^^^^^^^
#
# http://www.virtual.com/program.cgi
#                       ^^^^^^^^^^^^
#


CgiUrl? [/cgi-bin/demo]

#
# Additional URL locations for the CGI program, as with CgiUrl.
# This is used when calling the catalog from more than one place,
# perhaps because your secure server is not the same name as the
# non-secure one.
#
# http://www.secure.domain/secure-bin/prog
#                         ^^^^^^^^^^^^^^^^
#
# We set it to the name of the catalog by default to enable the
# internal HTTP server.
#


Aliases? [/demo]

# The base directory for HTML for this (possibly virtual) domain.
# This is a directory path name, not a URL -- it is your HTML
# directory.
#


DocumentRoot? [/home/httpd/html] /usr2/sites/Gemini

# Where the sample HTML files (not Interchange pages) should be installed.
# There is a difference. Usually a subdirectory of your HTML directory.
#


SampleHtml? [/usr2/sites/Gemini/demo]

# Where the image files should be copied. A directory path
# name, not a URL.
#


ImageDir? [/usr2/sites/Gemini/demo/images]

# The URL base for the sample images. Sets the ImageDir
# directive in the catalog configuration file. This is a URL
# fragment, not a directory or file name.
#
#         <IMG SRC="/foundation/images/icon.gif">
#                   ^^^^^^^^^^^^^^^^^^
#


ImageUrl? [/demo/images]

Interchange can use either UNIX- or internet-domain sockets.
Most ISPs would prefer UNIX mode, and it is more secure.

If you already have a program there, or use a common program
and the FullURL directive, select NONE. You will then need
to copy the program by hand or otherwise ensure its presence.

INET or UNIX mode? [UNIX]
Do you use CGIWRAP or SUEXEC? [n]
Checking directories........................................mkdir 
/home/alex/catalogs
mkdir /home/alex/catalogs/demo
mkdir /usr2/sites/Gemini/demo
mkdir /usr2/sites/Gemini/demo/images
done.
Copying demo files..........................................found more to ask.

Your company name: ...............................[Foundation Store] 
Gemini Manor

You can choose to pre-populate your Foundation template with some
data which might be illustrative. You can always delete it later
and replace it with your own.

The types are:

     tools      Construct Something, includes products, users, orders
     reports    Marketing reports, downloadable softgoods, products, users
     none       No data. Same as leaving blank.

Sample data type?: ...............................[tools]

Interchange has a workable internal database, but many things will
work better (and a few worse) if you use a SQL database. Interchange
can configure MySQL, PostgreSQL, and Oracle in a test configuration.

Set to 1 if you want to use MySQL, PostgreSQL, Oracle, or DB2: ..1

You can select this to use MySQL in your test catalog. Careful!
This requires the ability to create a database named "test_foundation",
and is highly dependent on your Perl and MySQL configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use MySQL: ...............

You can select this to use PostgreSQL in your test catalog.
This requires the ability to create a database named "test_foundation",
and is highly dependent on your Perl and system configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use PostgreSQL: ..........

You can select this to use Oracle in your test catalog. This requires
that you know your Oracle DSN and that you've already created a user and
tablespace for Interchange. You should also have the environment variables
ORACLE_BASE, ORACLE_HOME, and ORACLE_SID set. Don't be too surprised if
this doesn't work.

Set to 1 if you want to use Oracle: ..............[1] 0

You can select this to use DB2 in your test catalog. Careful!
This requires the ability to create a database named "intchg",
and is highly dependent on your Perl and DB2 configuration. Don't
be too surprised if this doesn't work.

Set to 1 if you want to use DB2: .................0

You can use Interchange's companion configuration
interface, to do upload/download of files, manipulation of
the database, reconfiguration of the catalog, and much more.

To enable the UI, you will need a "super-user" account
name that has full access.

The initial password is "pass". CHANGE IT! You can do this
by going to the admin menu and selecting the superuser and
then "Change password".

Account name that will control this catalog: .....[alex]
Administrative password: .........................[pass]
Set to 1 to display demo helper features in your store: ..1

Found system commands to run.

done.
Moving link program to /home/httpd/cgi-bin/demo.............done.
Copying share/ files to /home/httpd/html....................done.
Moving HTML files to /usr2/sites/Gemini/demo................done.
Moving image files to /usr2/sites/Gemini/demo/images........done.

Found additional system commands to run.

We need to make some directories to store sessions, logs, and such.

run "sh /home/alex/catalogs/demo/config/makedirs"? [y]
You can install some sample data to start with in this catalog.
This script will install the sample (tools) you selected.

run "sh /home/alex/catalogs/demo/config/installsample"? [y]
Add catalog to interchange.cfg? [y]

Done with installation. If my reading of your input is correct, you
should be able to access the demo catalog with the following URL:

         http://wizdev.net/demo

In any case, you should get direct access at:

         http://wizdev.net/cgi-bin/demo

That is, after you START or RESTART the Interchange server.  8-)
It is best done with:



For session expiration, you might want to place a line like this in your
crontab:

44 4 * * * /home/httpd/interchange/bin/expireall -r

It will prevent the session databases from getting too large.
-------------------------- end of setup -----------------------------------
[root@wizdev /root]# ls -l /home/alex/catalogs/demo
total 64
drwxrws---    2 alex     alex         4096 Mar 13 23:19 backup
-rw-rw----    1 alex     alex        11908 Mar 13 23:19 catalog.cfg
drwxrws---    2 alex     alex         4096 Mar 13 23:19 config
drwxrws---    6 alex     alex         4096 Mar 13 23:19 dbconf
-rw-rw----    1 alex     alex            0 Mar 13 23:19 error.log
drwxrws---    2 alex     alex         4096 Mar 13 23:19 etc
lrwxrwxrwx    1 alex     alex           30 Mar 13 23:19 images -> 
/usr2/sites/Gemini/demo/images
drwxrws---    2 alex     alex         4096 Mar 13 23:19 logs
drwxrws---    2 alex     alex         4096 Mar 13 23:19 orders
drwxrws---    6 alex     alex         4096 Mar 13 23:19 pages
drwxrws---    2 alex     alex         4096 Mar 13 23:19 products
drwxrws---    2 alex     alex         4096 Mar 13 23:19 session
drwxrws---    2 alex     alex         4096 Mar 13 23:19 special_pages
drwxrws---    5 alex     alex         4096 Mar 13 23:19 templates
drwxrws---    2 alex     alex         4096 Mar 13 23:19 tmp
drwxrws---    2 alex     alex         4096 Mar 13 23:19 upload
[root@wizdev /root]# ls -l /usr2/sites/Gemini/demo
total 8
drwxrwxr-x    6 alex     alex         4096 Mar 13 23:19 images
-rw-rw-r--    1 alex     alex         2786 Mar 13 23:19 index.html

--------------------------
(Starting)
[root@wizdev /root]# su -c "/home/httpd/interchange/bin/interchange -r" httpd
Enter password:
Killing Interchange server 23623 with TERM.
Low traffic settings.
Calling UI......UI is loaded...
Interchange V4.8.3
Configuring catalog demo...
Couldn't change to /home/alex/catalogs/demo: Permission denied

demo: error in configuration. Skipping.
demo: config error -- Couldn't change to /home/alex/catalogs/demo: 
Permission denied. Skipping.
Configuring catalog sample...sample config error: Please specify the 
MailOrderTo directive in the configuration file ''



sample: error in configuration. Skipping.
sample: config error. Skipping.
Interchange server started in INET and UNIX mode(s) (process id 23660)
--============_-1195642296==_============--