Sun Java System Web Server 7.0 Installation and Migration Guide

Installing in Command-Line Mode on Windows

The following procedure describes how to install the Web Server in command-line mode on Windows. You must be logged in with administrator privileges. Non-administrator installation is not supported on Windows.

ProcedureTo Install in Command-Line Mode on Windows

  1. Download the installer file to a temporary directory. The file format is:

    sjsws-7_0-windows.zip

  2. Unzip the server files. You will see the following:

    • Legal directory

    • README.txt

    • setup.exe

    • WebServer directory

  3. Start the installation with the following command:

    setup --console

    The command-line installation interface displays. General navigation is as follows:

    • Press Enter or Return to move forward in the installation.

    • Type < to move back in the installation.

    • Type ! to exit the installation.

    • Default values are shown in brackets: [ ]. To accept the default, press Enter or Return. To provide a different value, type the value at the command prompt and then press Enter or Return.

  4. Proceed through the introductory information and then accept or decline the software license agreement. You must accept the agreement to continue with the installation.

  5. Specify the installation directory. The default is C:\Program Files\Sun\WebServer7.

    Web Server components are installed in the directory specified. If the directory does not exist, you have the option to create it. If a Web Server installation exists in the directory, you have the option to upgrade that installation. Otherwise, you must uninstall the existing installation. Only one Web Server 7.0 installation is permitted.

  6. Specify the installation type, Express (the default) or Custom. For more information about each type, see Installation Types.

  7. Proceed based on the installation type:

    • For Express installations, specify the user name (admin by default) and password for the Administration Server user, press Enter, and then go to Step 14 to finish the installation. Steps 8–13 pertain to Custom installations only. For more information about the default settings used for Express installations, see Express Installation.

    • For Custom installations, go to Step 8.

  8. Specify the components to install, separated by commas.


    Note –

    You can install the administration command-line interface without the installing server core, but you cannot install server core without installing the administration command-line interface.


    • Server Core. Installs the core binaries needed to set up the Web Server environment.

    • Administration Command Line Interface. Installs the command-line administration client used to manage and configure Sun Java System Web Server and its hosted applications from the command line. If Administration Command Line Interface is selected and Server Core is not, specify Java configuration information as described in Step 9, and then go to Step 14 to finish the installation.

    • Sample Applications. Installs the sample applications that demonstrate Web Server features and functionality.

    • Language Pack. There are two language packs: Servercore and Administration Client. The components that you select determine which pack is installed.

    For more information about each component, see Web Server Components.

  9. Specify Java configuration information.

    Choose to install the JDK bundled with Web Server 7.0 (the default) or specify the absolute path to an existing JDK.

  10. Specify configuration settings.

    Specify whether to configure the administration instance as the Administration Server (the default) or the Administration Node (as described in Server Core). For more information about these choices, see Web Server Components.

    • If you select Configure Administration Instance as Administration Server (the default), go to Step 11.

    • If you select Configure Administration Instance as Administration Node, specify whether the Web Server and its associated Administration Server should be started and stopped automatically on system startup (the default is No), specify the Administration Node settings listed below, and then go to Step 14 to finish the installation.

      • Host Name. Specify the fully qualified domain name of the computer on which you are installing the Administration Node instance.

      • SSL Port. Specify the SSL port for the Administration Node instance or accept the default. The default is 8989 unless that port is unavailable, in which case this defaults to the next highest available port.

      • Register Node with Remote Administration Server. Specify whether this Administration Node instance should be registered with the Administration Server instance at the time of installation (the default), or later (as described in Registering the Administration Node From the Command-Line). If registration is selected, specify the following settings and then go to Step 14 to finish the installation. If registration is not selected, go to Step 14 to finish the installation.


        Note –

        When registering an Administration Node with an Administration Server, ensure that the system date and time of the Administration Node is same as or later than that of the Administration Server.


        • Administration Server Host Name. Specify the fully qualified domain name of the remote host on which the Administration Server is installed.

        • Administration Server SSL Port. Specify the SSL port on which the remote Administration Server is listening. The default is 8989.

        • Administrator User Name. Specify the administrator user name used to log in to the remote Administration Server.

        • Administrator Password. Specify the administrator user password used to log in to the remote Administration Server.

  11. Specify whether the Web Server and its associated Administration Server should be started and stopped automatically on system startup and shutdown (the default is No).

  12. Specify Administration Server settings.

    • Server Host. Specify the fully qualified domain name of the computer on which you are installing the Administration Server.

    • SSL Port. Specify the SSL port for the Administration Server or accept the default. The default is 8989 unless that port is unavailable, in which case this defaults to the next highest available port.

    • Non-SSL Port. To create Non-SSL port, select the checkbox Create non-ssl port for the Administration Server. The default is 8800 unless that port is unavailable, in which case this defaults to the next highest available port.


      Note –

      SSL port is default for Administration Server. However, you can also choose to use the Non-SSL port. When you choose to install through SSL port, use https:// to access the Administration Server.


    • Administrator User Name. Specify the Administration Server user name to use for authentication. The default is admin.

    • Administrator Password. Specify the Administration Server user password to use for authentication.

    • Retype Password. Retype the Administration Server user password.

  13. Specify Web Server settings.

    • Server Name. Specify the fully qualified domain name of the computer on which you are installing the default Web Server instance.

    • HTTP Port. Default value depends upon the runtime user ID of Admin Server instance. If the Administration Server instance's runtime user ID is non-root, the default is 8080. If the Administration Server instance's runtime user ID is root, the default is 80.

    • Document Root Directory. Specify the document root directory. The default is install_dir\https-server_name\docs. The server's content files reside in this directory.

  14. Specify whether you want to install the product (the default), start over, or exit the installation.

    Following installation, text displays indicating whether the installation succeeded or failed, and providing information about using the Administration Server and reviewing the installation log file. Make note of this information for future reference.

    If you have completed installation successfully. For more information see Chapter 3, Getting Started