Sun Java System Messaging Server 6 2005Q4 Administration Guide

ProcedureTo Configure Your HTTP service

Steps
  1. From Sun ONE Console, open the Messaging Server you want to configure.

  2. Click the Configuration tab and open the Services folder in the left pane.

  3. Select HTTP.

  4. Click the System tab in the right pane.

  5. To enable the service, check the box labeled “Enable HTTP service at port” and assign a port number.

  6. If desired, enable password-based login.

  7. Specify connection settings as follows:

  8. Specify process settings as follows:

  9. Specify Message settings as follows:

    • If desired, specify the attachment spool directory.

    • If desired, specify the maximum outgoing mail size. Note that this includes all the attachments encoded in base64, and that base64 encoding requires an extra 33% more space. Thus a 5 megabyte limit in the console results in the maximum size of one message and attachments being about 3.75M.

      When an HTTP client constructs a message with attachments, the attachments are uploaded to the server and stored in a file. The HTTP service retrieves the attachments and constructs the message before sending the message to an MTA for routing or delivery. You can accept the default attachment spool directory or specify an alternate directory. You can also specify a maximum size allowed for attachments.

  10. Specify MTA settings as follows:

    • If desired, specify an alternate MTA host name.

    • If required, specify an alternate MTA port.

      By default, the HTTP service sends outgoing web mail to the local MTA for routing or delivery. You might want to configure the HTTP service to send mail to a remote MTA, for example, if your site is a hosting service and most recipients are not in the same domain as the local host machine. To send web mail to a remote MTA, you need to specify the remote host name and the SMTP port number for the remote host.

  11. Click Save.

    Command Line. You can set values for the HTTP attributes at the command line as follows:

    To enable or disable the HTTP service:

    configutil -o service.http.enable -v [ yes | no ]

    To specify the port number:

    configutil -o service.http.port -v number

    To enable a separate port for HTTP over SSL:

    configutil -o service.http.enablesslport -v [ yes | no ]

    To specify a port number for HTTP over SSL:

    configutil -o service.http.sslport -v number

    To enable or disable password login:

    configutil -o service.http.plaintextmincipher -v value

    where value is one of the following:

    -1 - Disables password login

    0 - Enables password login without encryption

    40 - Enables password login and specifies an encryption strength

    128 - Enables password login and specifies an encryption strength

    To set the maximum number of network connections per process:

    configutil -o service.http.maxsessions -v number

    To set the maximum idle time for connections:

    configutil -o service.http.idletimeout -v number

    To set the maximum idle time for client sessions:

    configutil -o service.http.sessiontimeout -v number

    To set the maximum number of threads per process:

    configutil -o service.http.maxthreads -v number

    To set the maximum number of processes:

    configutil -o service.http.numprocesses -v number

    To specify the attachment spool directory for client outgoing mail:

    configutil -o service.http.spooldir -v dirpath

    To specify the maximum message size:

    configutil -o service.http.maxmessagesize -v size

    where size is a number in bytes. Note that this includes all the attachments encoded in base64, and that base64 encoding requires an extra 33% more space. Thus a 5 megabyte limit in the console results in the maximum size of one message and attachments being about 3.75M.

    To specify an alternate MTA host name:

    configutil -o service.http.smtphost -v hostname

    To specify the port number for the alternate MTA host name:

    configutil -o service.http.smtpport -v portnum