Sun ONE Application Server 7 Installation Guide |
Chapter 4
Completing a Solaris 9 Bundled InstallationThere are two kinds of Solaris 9 distributions for the Sun Open Net Environment (Sun ONE) Application Server: bundled and unbundled. If you received your copy of the Sun ONE Application Server as part of the Solaris 9 installation, you have the Solaris bundled version.
If you received a standalone copy of the Sun ONE Application Server, you have the unbundled version.
This chapter provides instructions for completing your Solaris 9 bundled installation.
The following topics are addressed here:
About Solaris 9 InstallationThe Sun ONE Application Server software that is installed as part of a Solaris 9 installation contains only the necessary libraries, executables and other files required to support the Sun ONE Application Server. No application server configuration exists upon installation.
To create an initial configuration, you must use the asadmin command line interface with the create-domain subcommand to create a Sun ONE Application Server administrative domain.
You will be creating both the Admin Server and application server instance configurations.
Creating an Administrative DomainWhen you create an administrative domain, you create an Admin Server. The Admin Server is a special instance of the Sun ONE Application Server that serves the Administration interface and provides administrative facilities for the command-line interface.
When you create a new domain, you specify:
- A port number for the Admin Server—The default when you install an unbundled version is 4848.
- An administration username and password—These passwords are required when you access the Admin Server, either when you access the Administration interface or when you run the command-line interface.
- The domain location—The port number associated with the Admin Server of the domain.
By default, the create-domain subcommand creates the new administrative domain configuration under /var/appserver/domains/. If you are logged in as a user that does not have write permissions to this area, you must specify a suitable location when creating the administrative domain. Specify the location in which to create the domain configuration using the --path option of the create-domain subcommand.
To create an administrative domain, perform these steps:
- Verify that the /usr/sbin directory is included in your path.
- From the command line, run the following command to create a new administrative domain called domain1:
asadmin create-domain --path <domain_config_dir> --adminport 4848 --adminuser admin --adminpassword password domain1
where domain_config_dir specifies the location under which the administrative domain configuration will be created. The --adminport, --adminuser, and --adminpassword options specify the initial settings of the new administrative server defined for the domain.
If the name domain1 has already been used, run the create-domain subcommand again with another domain name. You can use periods and other characters in your domain names. You could use your login user name as a qualifier to help ensure that your domain name is unique. For example: ckamps.domain1.
The following message should be displayed:
Created Domain domain1 successfully
- Run the list-domains subcommand to see a list of all of the domains configured for the Sun ONE Application Server installation:
asadmin list-domains
domain1 [<domain_config_dir> domain1]where the value of domain_config_dir represents either the default location for newly created administrative domains or the value specified on the --path option of the create-domain subcommand.
For more information on how to prepare your Sun ONE Application Server environment after Solaris 9 installation, consult the Getting Started chapter of the Sun ONE Application Server Administrator's Guide.
Starting the Administration ServerTo use the graphical Administration interface or to use many of the commands in the command-line interface, you must have a running Admin Server. Follow the instructions in the Sun ONE Application Administrator’s Guide to start the Sun ONE Application Server.
Creating an Application Server InstanceAfter you have created a domain and started the Admin Server, you need to create an application server instance. Each application server instance has its own J2EE configuration, J2EE resources, application deployment areas, and server configuration settings. (On the unbundled version, the server instance that is automatically created at installation is called server1. You will often see server1 used in examples throughout the documentation.)
You can create an application server instance through the Administration interface or through the command-line interface. The server instance is created in a folder within the domain.
To create an application server instance:
- Verify that the Admin Server is running.
- Run the create-instance subcommand:
asadmin create-instance --domain domain1 --instanceport 80 server1
where domain1 is the domain name specified during domain creation, 80 is the HTTP server port number of the application server instance, and server1 is the name of the instance. Specify appropriate values for these options depending on your specific environment.
If you have only a single administrative domain defined on your system, you do not need to specify the target domain name when creating an instance.
For more information on how to set up your Sun ONE Application Server environment after a Solaris 9 installation, consult the Sun ONE Application Server Administrator's Guide.