Deploying IBM Workplace Services Express on the IBM eServer iSeries Server

106 Deploying IBM Workplace Services Express on the IBM Eserver iSeries Server

5.1 Starting and stopping a Workplace Services Express server

There are two ways you can start and stop a Workplace Services Express server. The first

method is to use the IBM Web Administration for iSeries interface. The second method is to

use Qshell scripts. The Qshell scripts start the Workplace Services Express portal server,

although they do not start the HTTP server or the document rendering server. For this reason,

we recommend that you use the IBM Web Administration for iSeries interface to start and

stop the Workplace Services Express server.

For more information about the Qshell scripts and other advanced administration topics, visit

the IBM Workplace Services Express Version 2.5.x Information Center at:

http://publib.boulder.ibm.com/infocenter/wseic/v2r5/index.jsp

5.1.1 Starting a Workplace Services Express server

Perform the following steps to start a Workplace Services Express server using IBM Web

Administration for iSeries:

1. To access IBM Web Administration for iSeries, point your Web browser to your fully

qualified iSeries host name on port 2001:

http://iSeriesHostName.domain:2001

In this example, we type:

http://rchas12.rchland.ibm.com:2001

2. When prompted, enter your i5/OS user profile and password to log on to the IBM Web

Administration for iSeries. Click OK.

3. On the iSeries Tasks menu, click IBM Web Administration for iSeries. You return to the

last server that you administered.

4. To manage your Workplace Services Express server, select your server by performing the

following steps:

a. Click the Manage tab.

b. Click the Application Servers tab.

c. In the Server drop-down list, select your Workplace Services Express server name.

Note: The windows shown in this chapter were taken after i5/OS V5R3 PTF SI20496 was

installed. If you do not have this PTF installed on your system, you might notice slight

variations on some windows. Due to the performance improvement included with PTF

SI20496, we recommend that you apply this PTF. For additional information, refer to 9.5.4,

“X virtual frame buffer verses virtual network computing” on page 299.

Important: The Lightweight Directory Access Protocol (LDAP) server must be started

before the Workplace Services Express server is started. If it is not started, the

Workplace Services Express server will not start.

Chapter 5. Administering Workplace Services Express 107

5. In the upper left corner, click the green square with a white triangle, as shown in

Figure 5-1, to start the Workplace Services Express server.

Figure 5-1 Starting a Workplace Services Express server

6. Select the Document Rendering server of your choice and click Start. If you have PTF

SI20496 installed, you see these options:

– XVFB

–VNC

If the PTF is not installed, you can only select the virtual network computing (VNC) server

as the document rendering service. In that case, make sure that the VNC server is

selected and click Start. See Figure 5-2.

Note: We suggest that you select all options to be sure that your Workplace Services

Express server functions properly. However, be aware that the Server1 server is only

used to access the WebSphere Application Server Administrative Console and thus is

not required to be started in most cases. For further information, refer to 9.5.1, “Startup

performance tuning” on page 277.

Tip: The XVFB option was created to eliminate a known performance issue with the

VNC server. We recommend that you start your server with the XVFB option.