Use this task to practice configuring WebSphere Application Server
for z/OS. If you are installing the product for the first time without migration
from an earlier version, it is helpful to install a practice application serving
environment in order to learn the customization process.
Before you begin
Note the following when you install your practice runtime:
- Be careful when typing and following the instructions in the customization.
- Note the user ID requirements in the generated instructions. If your user
IDs are not configured correctly, the jobs might not run successfully.
- Keep track of each step so that you do not skip or repeat any steps.
- Examine each job's output (not only the return code) to confirm that everything
is configured correctly. Sometimes, the return code indicates no problems
but the job output contains errors. For a proper configuration, you should
have no errors in your job output unless the instructions specifically describe
errors in the job output.
About this task
You should install a practice runtime when you install WebSphere
Application Server on z/OS for the first time and want to learn the steps
for installing and customizing it.
Procedure
- Print a copy of the Customization tool worksheet: Security Domain and fill it
out using Customization Dialog variables: Security domain as
a guide. When filling out the worksheet, use default values wherever
possible.
Note: Make sure that the user ID names, group names, and UID/GID
values that you specify are not already being used on your z/OS system.
- Print a copy of the Customization tool worksheet: Stand-alone application server cell and fill it out using Customization variables: Stand-alone application server cell as a guide.
Note: Make
sure that the user ID names, group names, UID/GID values, and TCP/IP port
numbers that you specify are not already being used on your z/OS system.
- Read the topic in Using the Customization Dialog.
- Start the Customization Dialog, and follow
the steps in Creating a security domain.
View and follow the generated instructions, which involve executing
the BBOSBRAJ and BBOSBRAK jobs.
Note: Be sure to save your security domain
variables and record the name of the saved variable data set on the security
domain worksheet.
- Follow the steps in Creating a stand-alone application server cell. View and follow the
generated instructions, which tell you how to:
- Troubleshoot any problems you encounter while customizing your
application server.
If you encounter problems while customizing
your application server, review the steps that you have performed--especially
regarding such things as specific user IDs under which jobs must be run. Check
all job output for any error messages that you might have missed. See Troubleshooting installation and configuration for additional
advice.
Watch out for these common mistakes:
- Navigating the configuration HFS with a UID of "0"
can alter files or their ownership and permission attributes, making them
inaccessible to the WebSphere Application Server for z/OS runtime servers
and administrators. To avoid this problem, use the WebSphere Application Server
for z/OS administrator user ID.
- If you decide to change any of the customized variables after you submit
any of these jobs, do not make manual modifications to the generated jobstreams
or data. Cancel the installation, and start over by regenerating all the jobstreams
and start over from the BBOWHFSA job.
Results
After you have successfully followed the instructions, you will have
set up a WebSphere Application Server for z/OS stand-alone application server.
See
Working with your new server for more information.
What to do next
Read the concept articles under Planning for product configuration and plan one or more application
serving environments that fit your system environment and business needs.
You
might want to delete the practice application server that you just set up
in order to save space on your system, to clean up your data sets, or for
other reasons. Follow these steps to delete it from your system:
- Stop the server.
- Unmount and delete the configuration file system.
- Delete the cataloged procedures.
- Remove any TCP/IP port reservations for the practice application server.
- Delete the RACF user IDs, groups, and profiles that you have created unless
you use the same security domain for a different WebSphere Application Server
for z/OS cell.