Web Crossing


Introduction

Installation & Upgrade

Web Crossing Features

Customizing & Scripting

User & Access Issues

Data Organization & Management

Performance Issues

Appendix

Appendix

Site Map

webx.set

Introduction
The Contents of webx.set

Introduction

What would you do if you needed to turn off direct web service mode, or change the direct web service port number, because every time you started Web Crossing you found it was conflicting with an already existing service, such as an Apache web server? How would you get in to your Web Crossing server to make the change if merely attempting to start the server caused a conflict?

There are many reasons you might want to override the default settings of your Web Crossing server, including wanting to change your Images directory location, or adjusting your port or IP address to avoid conflicts between all the services that Web Crossing provides with services that might already be running on your Unix server (and to a lesser extent on your Windows or Mac server).

The solution to this problem is Web Crossing's external settings file - webx.set.

When you first start your Web Crossing server, your webx.set file is created for you, using the default settings according to the installation you chose. If you should accidently delete your webx.set file for some reason do not be concerned. The next time you start your Web Crossing server it will be created automaticaly using the current settings stored in your Web Crossing database.

In other words, webx.set is not an absolutely required settings file. It is there for your convenience. Every time you make a change in your Web Crossing settings, the changes are written to webx.set.

In addition, if you stop the Web Crossing server, make a manual change to a setting in webx.set and then restart Web Crossing, the settings in webx.set override the settings stored in the Web Crossing database. This allows you to make changes, such as changing a port number, without needing access to the Control Panel (which may be difficult if you are experiencing port number conflicts).

Note: The webx.set file replaces the old webPort file, which did the same thing, but only for the web port setting.



The Contents of webx.set

Here are the contents of webx.set, with some typical settings, much like those we use here at Web Crossing Harbor. Items that are blank just use the default settings as defined in the Control Panel.

  • images=/Images : the location of your Web Crossing image files
  • help= : the location of your Web Crossing help files, if different from the location of your image files
  • search= : pathname for the search index (to be used in Web Crossing 4)
  • backup= : pathname for the backup files (to be used in Web Crossing 4)
  • Web CrossingScript=Web Crossing : the name of your Web Crossing script
  • useTemplates=1 : 1 if templates are on, 0 if off
  • useBannerFooter=1 : 1 if banners and footers can be used, 0 otherwise (useful for testing/debugging problems with your banners and footers)
  • httpBasic=0 : 1 for implementing HTTP basic mode (for direct web service only), 0 otherwise
  • smallObjectHeap=6144000 : the size of your small object heap, in bytes
  • diskCache=1500 : the size of your disk cache, in kilobytes
  • isMaster=0 : 1 if this server is a master server in a mirrored master/slave configuration, otherwise 0
  • isSlave=0 : 1 if this server is a slave server in a mirrored master/slave configuration, otherwise 0
  • masterIp= : the IP address of the master server when in a master/slave configuration
  • slaveIps= : the IP address of the slave servers when in a master/slave configuration
  • webEnabled=1 : 1 if direct web service is enabled, otherwise 0
  • webPort=211.225.166.204:80 : the current IP address and web port. The full IP address is needed when there is more than one IP address on the same server machine (multihoming)
  • cgiPort= : CGI port number for the new webx-cgi2 cgi-->FastCGI interface
  • masterSlavePort=1431 : the port number for mirroring when in a master/server configuration
  • useChat=1 : 1 if chat services are enabled, otherwise 0
  • isChatControlRoom=1 : 1 if this server is acting as a chat control room, otherwise 0
  • isChatFanout=1 : 1 if this server is acting as a chat fanout server, otherwise 0
  • controlRoomIp=211.225.166.204 : the IP address of the chat control room
  • liveServerIp=211.225.166.204 : the IP address of the chat server; used for multi-homing chat
  • controlRoomWeb CrossingIp=3133 : the port number for the chat control room
  • controlRoomFanoutIp=3134 : the port number for the chat fanout server
  • chatClientIp=80 : the port number for chat clients (if you are running in direct web service mode you should set this to 80 to enable users behind fire walls to access your chat services more easily)
  • fanoutRelayIp=3136 : the port number for chat fanout server connections
  • directAccessIp=0 : the port number for direct database access connections (0 if direct database access is turned off)
  • directAccessSessions=5 : the maximum number of simultaneous direct database access connections
  • dbAccessAll=0 : 1 if direct database access is allowed, 0 otherwise
  • useFcgi=0 : 1 if FastCGI is used, 0 otherwise
  • fcgiPort=3137 : the port number for FastCGI connections
  • fcgiIps= : the IP address for FastCGI connections (If you are using Fast CGI, the Web Crossing server and Web Server may be on different server machines)
  • fcgiMaxConnects=10 : the number of simultaneous connections permitted for FastCGi
  • fcgiMaxReqPerConnect=100 : the maximum number of requests per FastCGI connection
  • httpToFcgi= : 1 if HTTP to FastCGI requests are supported
  • useNntp=1 : 1 if NNTP services are turned on, 0 otherwise
  • nntpMirror=1 : 1 if new server (NNTP) mirroring is used, 0 othewise
  • nntpIp=119 : the port number for NNTP services
  • nntp8Bit=0 : 1 if NNTP transfers use 8-bit characters, 0 otherwise
  • emailPush=1 : 1 if the site sends web forum messages to mailing lists, 0 otherwise
  • emailPull=1 : 1 if the site receives email from mailing lists (mailing list archiving), 0 otherwise
  • smtp8Bit=0 : 1 if 8-bit character encoding is used for outgoing mail messages, 0 if 7-bit encoding is used
  • ldapEnabled=0 : 1 if LDAP services are enabled, 0 otherwise
  • ldapServerEnabled=1 : 1 if Web Crossing is acting as an LDAP server, 0 otherwise
  • renameEnclosuresOnDelete=1 : 1 if attachments are renamed when the accompanying message is deleted, 0 if the attachments are deleted along with the message
  • siteCharset=ISO-8859-1 : the site character set, typically ISO-8859-1 for Latin character sets or ISO-2022-JP for Japanese character sets
  • searchIx=1 : 1 if index searching is enabled, otherwise 0


A Non-Programmer's Guide to Web Crossing
by Sue Boettcher and Doug Lerner

© 2000 Web Crossing, Inc.