test

Sun Java System Web Server 6.1 SP10 Installation and Migration Guide

Installing Across Multiple Machines

You can install Sun Java System Web Server on multiple machines using two different methods: templatized installation and silent installation.

Templatized installation is executed from your local machine, where you run the installation program across multiple remote machines at once.

Silent installation requires that you first install the web server on a local machine, then edit the resulting log file, install.inf, to correspond to the remote machines. With silent installation, you must install the remote instances one by one.

Both methods are described in this section.

ProcedureTo install using templatized installation

To use templatized installation, enter the installation settings for each remote machine in a template file called template.inf. You can then use the template to install the web server on multiple machines from a single session on your local machine.

The template.inf file is found in the same directory as the setup program.

To run templatized installation, perform the following steps:

  1. In the /.rhosts directory of your local machine, create an entry for each remote machine where you will install the web server using the format

    remote_machine_name username

    For example, if the remote machine is host1 on the domain do gs, and you are logged in as root, enter the following information:

    host1.docs.com root

  2. In the /etc/hosts.equiv directory of your local machine, create an entry for each remote machine where you will install the web server using the format

    remote_machine_name

    For example, if the remote machine name is host1 on the domain docs, enter the following information:

    host1.docs.com

  3. In the /.rhosts directory of each remote machine where you will install the web server, create an entry for your local machine using the format

    local_machine_name username

    For example, if the local machine name is chewbacca on the domain docs and you are logged in as root, enter the following information:

    chewbacca.docs.com root

  4. In the /etc/hosts.equiv directory of each remote machine where you will install the web server, create an entry for your local machine using the format

    local_machine_name

    For example, if the local machine name is chewbacca on the domain docs, enter the following information:

    chewbacca.docs.com

  5. Create a setup directory on your local machine with a link to server root

    ln -s server_root/ setup-directory

  6. Change to the directory where setup resides.

    For the local machine share and export the directory containing the setup program via NFS:

    - For the remote machine, create a setup directory and mount via NFS mount -F nfs <local machine name >: setup-directory setup-directory

    - Finally make sure that the SetupLocation is accessible from the remote machine.

    Note –

    Remote access is only on Solaris machines. Remote access is different from platform to platform.

  7. Open the template.inf file.

  8. Enter the installation setting:

    • HostNames: the name of the host where the web server will be installed, separated by commas. For example:

      host1,host2,host3

      • Components: the components to install, separated by commas. For example:

        webcore,jdk,cleanup

      • SetUpLocation: the location of the setup program used by the template file.

        For each host, enter the following:

        • [hostname]: the name of the machine where the web server will be installed by the template.

      • InstallType: the type of installation to run: express [1], typical [2], or custom [3].

      • SuiteSpotUserID: The user ID used when running the default instance of the Sun Java System Web Server.

      • SuiteSpotGroup: The group the user running the default instance of the Sun Java System Web Server belongs to.

      • ServerRoot: the directory where your server will be installed. For example:

        /opt/SUNWwbsvr/

      • HttpDocRoot: The document root of the Sun Java System Web Server instance. For example:

        /opt/SUNWwbsvr/docs

        For the core server, enter the following:

      • AdminPort: Enter the port number for the Administration Server.

      • HttpPort: The port of the default Sun Java System Web Server instance.

      • AdminSysUser: The user id used when running the Administration Server. The user should have access permissions to use the directory Server to perform user and group management tasks. For example, root.

      • AdminName: The user name used to access the administration screens of the Administration Server. For example: admin.

      • AdminPassword: The password used to access the administration screen of the Administration Server. For example: admin.

  9. Run the installation wrapper by typing the following command at the command prompt:

    path_to_perl_executable/perl installWrapper -f template.inf

    Note –

    The installWrapper is a Perl script.

    The following is an example of the template.inf file:


    [ MachineName]
HostNames = draco.sun
Components=webcore,snmp,cleanup
SetUpLocation=/Sun/WebServer/P20030814.1
[iws-intern3]
InstallType=   2
SuiteSpotUserID= nobody
SuitespotGroup=  nobody
SecurityCheck=   False
RequireDomain=   False
InstallWhich=   1
ServerRoot=/Sun/WebServer/tmpl_inst/SUNWwbsvr
HttpDocRoot=/Sun/WebServer/tmpl_inst/SUNWwbsvr/docs
JDK_DIR=/usr/j2se
[core]
Upgrade=   False
Reinstall=   False
AdminPort= 20000
HttpPort= 20001
AdminSysUser= root
AdminName= admin
AdminPassword= admin
UgLdapUse=   No
CompVersions=   2:2:1:2:2:1:1:2:
[cleanup]
Archive=   cleanup.zip

ProcedureTo install using silent installation

Silent installation is a less efficient way than templatized installation to install multiple instances of Sun Java System Web Server because remote instances of the server are installed one by one rather than several at a time. You use silent installation to create a file of responses to the setup program’s prompts, then edit the file (install.inf) and use it to install future Sun Java System Web Server installations. With silent installation, you must first install Sun Java System Web Server on your local machine, then edit install.inf to correspond to the remote machines where you’ll install additional instances of the server. If you are installing Sun Java System Web Server on a number of remote machines, it is recommended that you use templatized installation instead.

Silent installation works best when you use the Typical installation and your installations are all similar.

Caution – Caution –

The install.inf file contains the password used to log on to the Administration Server. The password is not encrypted; it is in plain text. If you use silent installation, delete the install.inf file once you are done with it.

To use silent installation, follow these steps:

  1. Run setup with the -k option, which creates a file called install.inf that contains all your responses to the installer prompts. At the command prompt, type:

    ./setup -k

  2. Answer the installer prompts and install Sun Java System Web Server.

  3. When the server is installed, go to the server_root /setup directory, where you find the install.inf file.

  4. Copy the install.inf file to the directory where you will run setup to install your Sun Java System Web Server.

  5. Edit the values in the install.inf file to match the values of the next server you want to install.

    For example, change the machine name, port number, installation directory, etc.

  6. Run setup using the install.inf file for input. For example:

    ./setup -s -f install.inf

  7. The server is installed.

    The following is an example of an install.inf file.


    [General]
FullMachineName=   draco.india.sun.com
SuiteSpotUserID=   webservd
SuitespotGroup=   webservd
ServerRoot= /Sun/WebServer
SecurityCheck=   False
RequireDomain=   False
Components=   WebServer

[WebServer]
Upgrade=   False
SuiteSpotUserID=   webservd
SuiteSpotGroup=   webservd
AdminPort=   4600
HttpPort=   4601
HttpDocRoot= /Sun/WebServer/docs
StartOnBoot=   n
JDK_DIR= /Sun/WebServer/bin/https/jdk
JDK_LIBPATH=
AdminSysUser=   root
AdminName=   admin
AdminPassword=   admin
CompVersions=   2:2:1:0:0:
Components=   webcore,JDK,cleanup

[cleanup]
Archive=   cleanup.zip

    The following table shows some useful install.inf parameters to edit. For best results, do not edit any parameters except those listed in the table.

    Parameter Name  

    Use  

    FullMachineName

    The machine name. 

    SuiteSpotUserID

    The user ID used when running the default instance of the Sun Java System Web Server. 

    SuiteSpotGroup

    The group the user running the default instance of the Sun Java System Web Server belongs to. 

    ServerRoot

    The directory where you install the server. 

    AdminPort

    The Administration Server port. 

    HttpPort

    The port of the default Sun Java System Web Server instance. 

    HttpDocRoot

    The document root of the Sun Java System Web Server instance. 

    AdminSysUser

    The user ID used when running the Administration Server. 

    AdminName

    The user name used to access to the Administration Server’s administration screens. 

    AdminPassword

    The password used to access to the Administration Server’s administration screens. 

    JDK_DIR

    The directory where your JDK is installed.