Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Words and Phrases
| Search for | Example | Results |
|---|---|---|
| A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
|
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Using Boolean Operators
| Search for | Operator | Example |
|---|---|---|
|
Two or more words in the same topic |
|
|
| Either word in a topic |
|
|
| Topics that do not contain a specific word or phrase |
|
|
| Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
| A combination of search types | ( ) parentheses |
|
Deploy the web tier
The Service Manager web tier contains a J2EE-compliant web application that must run on a web application server. Before you proceed, you must have a supported web application server installed. For the supported versions of different web application servers, see Service Manager Support Matrix on the Micro Focus Support matrices web site.
Once your web application server is ready for use, deploy the web tier on your web application server. Each web application server has its own method of deploying web applications. See your web application server documentation for specific instructions on deploying a web application. This section provides example implementation instructions.
Tip
Enable HTTPOnly and Secure session cookies in your web application server
Caution Be sure to set up your Web Tier with only the minimum required functionality. Enabling more functionality in web application servers (extra languages or scripts such as VB, PHP, CGI, and so on), increases the risk of security breaches. We recommend that you follow well-known best practices for a secure application server.
It is recommended to enable HTTPOnly and Secure cookies in your web application server to help prevent malicious JavaScript injection and make the browser (or other http clients) only send cookies over SSL connections. For more information, see KM02233778.
Deploy the web tier
The following table provides a summary of the deployment method required for each supported web application server.
| Web application server | Deployment method |
|---|---|
| Apache Tomcat |
Copy the webtier-9.60.war file to the <Tomcat>\webapps folder and start the web application server. For detailed steps, see Example deployment on Tomcat . |
| IBM WebSphere Application Server |
Open the administration console and install the web application from the webtier-ear-9.60.ear file. For detailed steps, see Example deployment on WebSphere Application Server . |
Web tier log files: The default log file is sm.log, located in <web app install dir>\bin. You can change the default log file and location in log4jproperties, which is located in <web app install dir>\webtier-9.60\WEB-INF.
Example deployment on Tomcat
This example describes the steps to deploy the webtier-9.60.war file on 8.x.
- Log in to the server as a user with local administrator privileges.
- Stop the Tomcat Web application server.
-
From the web tier package, copy or save the webtier-9.60.war file onto your Tomcat webapps directory. For example, C:\Program Files\Apache Software Foundation\Tomcat 8.0\webapps.
-
Make sure that you change the "protocol" attribute as the following in the conf\server.xml file on Tomcat:
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol" connectionTimeout="20000" redirectPort="8443" />
-
Start the Tomcat server. Tomcat automatically opens the webtier-9.60.war file and creates a webtier-9.60 virtual directory.
If Tomcat does not create a webtier-9.60 directory when started, check the log files and contact support with the information found in the log files.
- Edit the web.xml file located in the virtual directory to add your server connection information. The settings you define in this file determine the client preferences
for all web clients. View the Service Manager online help for a complete list and
more detailed explanation of each parameter.
- Open the web.xml file in a text editor.
Set the secureLogin, sslPort, serverHost, and serverPort parameters.
Parameter Default value Description secureLogin true Controls the encryption of network communication between the web application server and the web browser. Set it to false if you do not use Secure Sockets Layer (SSL) connections to the web server.
Note: To use secure login, you must enable SSL on your web application server. For details, refer to your web application server documentation.
sslPort 8443 This parameter is needed only when secureLogin is set to true. Set it to the SSL port of the web application server. serverHost localhost Specifies the name of the Service Manager host server. serverPort 13080 Specifies the communications port number to which the Service Manager server listens. Set other common parameters as desired. The table below lists the commonly set parameters and their default values.
Parameter Default value Description cacerts WEB-INF/cacerts Lists the path to the CA certificates required for SSL support. compress_soap true Specifies if you want to use data compression between web clients and the web tier. helpServerHost Specifies the name of the Help Server. See Web parameter: helpServerHost. helpServerPort Specifies the communications port number to which the Help Server listens. See Web parameter: helpServerPort. helpServerContext help Specify the context path of the help server home page URL. See Web parameter: helpServerContext.
showHelp false Enabling this parameter causes Web clients to display the Online Help and Shortcut List options after users click the Help (question mark) button. The Online Help option allows users to access the Help Server you define in the web.xml file.
If this parameter is set to false, clicking the Help button will directly bring up the web client keyboard shortcut list.
refreshMessages true Determines whether the browser checks for new messages from the application server. refreshMessagesInterval 15000 Determines how often (in milliseconds) the browser checks for new messages from the application server. ssl false Enables the web client to encrypt communications using the server’s demonstration certificate. viewactivenotes false Determines whether you see a pop-up message when the server sends a message.
- Save and close web.xml.
- Endorsed JAR files are no longer required. If you installed them in previous installations, remove them.
-
Restart the Tomcat server.
- Set the web application server heap size. The web application server heap size determines how many connections each web application server can handle. Most application servers require a heap size of at least 256 MB for optimal performance. If you experience poor performance from your web client connections, increase the web application server heap size. See your web application server documentation for instructions.
Example deployment on WebSphere Application Server
This example describes deploying the webtier-ear-9.60.ear file on WebSphere Application Server versions 8.5.
- Log in to the server as a user with local administrator privileges.
- From the web tier package, copy or save the webtier-ear-9.60.ear file onto your local system.
- Start the WebSphere application server.
-
Set the web application server heap size. The web application server heap size determines how many connections each web application server can handle. Most application servers require a heap size of at least 256 MB for optimal performance. If you experience poor performance from your web client connections, increase the web application server heap size. See your web application server documentation for instructions.
- Log on to the WebSphere administrative console with system administrator privileges.
-
Install the webtier-ear-9.60.ear file.
-
Go to Applications > New Application > New Enterprise Application.
-
Select Local file system, and browse to the webtier-ear-9.60.ear file.
-
Click Next. WebSphere starts uploading the web tier application. This may take a while.
-
- Click Next to accept the default settings in the next screens until you reach "Step 4: Summary", and then click Finish. The installation of the web tier ear file begins.
- When the installation is complete, click Save to save your local configuration changes to the master configuration.
-
The webtier-ear-9.60.ear file contains webtier-9.60.war. Inside of that is the web tier configuration file (web.xml). Edit it to add your server connection information. The settings you define in this file determine the client preferences for all web clients. View the Service Manager online help for a complete list and more detailed explanation of each parameter.
-
Open the web.xml file in a text editor. The web.xml file is deployed in the following folder: <WebSphere installation path>\AppServer\profiles\<Profile Name>\config\cells\<Node name>Cell\applications\Service Manager 9.60 Web.ear\deployments\Service Manager 9.60 Web\webtier-9.60.war\WEB-INF.
For example: C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\AppSrv02\config\cells\IWFVM01268Node02Cell\applications\ Service Manager 9.60 Web.ear\deployments\Service Manager 9.60 Web\webtier-9.60.war\WEB-INF.
-
Set the secureLogin, sslPort, serverHost, and serverPort parameters.
Parameter Default value Description secureLogin true Controls the encryption of network communication between the web application server and the web browser. Set it to false if you do not use Secure Sockets Layer (SSL) connections to the web server.
Note To use secure login, you must enable SSL on your web application server. For details, refer to your web application server documentation.
sslPort 8443 This parameter is needed only when secureLogin is set to true. Set it to the SSL port of the web application server. serverHost localhost Specifies the name of the Service Manager host server. serverPort 13080 Specifies the communications port number to which the Service Manager server listens. - Set other common parameters as desired. The table below lists the commonly set parameters and their default values.
- Save, close and re-archive the files.
Parameter Default value Description cacerts WEB-INF Lists the path to the CA certificates required for SSL support. compress_soap true Specifies if you want to use data compression between web clients and the web tier. helpServerHost localhost Specifies the name of the Help Server. helpServerPort 80 Specifies the communications port number to which the Help Server listens. helpServerContext help Defines the context path when deploying the Service Manager help on a web server (for example, Apache).
The context path refers to the virtual directory name where the Service Manager help is installed. It excludes the web server’s document directory path. For example, if the help is deployed in C:/Apache/2.2/htdocs/sm_help, the document directory path is C:/Apache/2.2/htdocs/ and the virtual directory name is sm_help. Therefore, the context path is sm_help.
showHelp false Enabling this parameter causes Web clients to display the help server option after users click the Help (question mark) icon, which allows users to access the Help Server you define in the web.xml file. refreshMessages true Determines whether the browser checks for new messages from the application server. refreshMessagesInterval 15000 Determines how often (in milliseconds) the browser checks for new messages from the application server. ssl false Enables the web client to encrypt communications using the server’s demonstration certificate. viewactivenotes false Determines whether you see a pop-up message when the server sends a message. -
- Configure the application properties.
- Go to Applications > Application Types > WebSphere enterprise applications.
Click Service Manager 9.60 Web to open the Configuration tab, and under Detail Properties click Class loading and update detection, and make sure the default settings are selected.
Setting Value (default) Class load order Classes loaded with parent class loader first WAR class loader policy Class loader for each WAR file in application - Click Apply.
- Configure the Service Manager module.
- Go to Applications > Application Types > WebSphere enterprise applications >Service Manager 9.60 Web > Manage Modules.
Click the Service Manager module, and select the following setting.
Setting Value Class load order Classes loaded with local class loader first (parent last)
Note Keep the other settings on the page as default.
- Click Apply.
-
Configure the default http transport port of the WebSphere application server.
Note You will use this port when launching the Service Manager web client.
- Go to Servers > Server Types > WebSphere application servers > server 1.
-
In the Communications > Ports section, make note of the WC_defaulthost port number (for example, 9082).
- You can change this port number to one that is not in use (for example, 9085). This port number is automatically synchronized to the port number in Application Servers > Server 1 > Web container transport chains > HttpQueueInboundDefault.
- Click Environment > Virtual hosts > default_host > Host Aliases, and make sure that the port number is in the Host Aliases list. If it is not, do the following to add the WC_defaulthost port number to the list.
- Click New.
- Type the following port information:
- Host Name: *
- Port: xxxx (for example, 9085)
- Click Apply and then click OK. The port number is added to the Host Aliases list of default_host.
- Click Save to save the changes to the master configuration.
- Restart the WebSphere Application Server.
Now the server will start binding to the new port.
Note If you did not change the port number, you do not need to restart the server.
- Add a Web container custom property setting. This step is required for particular error pages that match the error exception types defined in the web tier configuration file (web.xml) to display in the user's web browser.
In the administrative console, click Servers > Server Types > WebSphere application servers.
Click the server to which the custom property is to be applied.
Under Configuration > Container settings, click Web Container Settings > Web container.
Under Configuration > Additional Properties, click Custom Properties.
On the Custom Properties page, click New.
On the settings page, enter the following values in the Name and Value fields:
Name:com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst
Value: true
Click Apply or OK.
In the "Messages" box that appears, click Save.
Restart the server for the custom property to take effect.
-
Go to Applications > Applications Type > WebSphere enterprise applications, select Service Manager 9.60 Web, and click Start.
When the application is successfully started, its state changes to green.
- Launch the Service Manager web client using a URL like the following:
http://<WAS application server name>:<Port>/webtier-9.60/index.do
where: <Port> is the WC_defaulthost port number.
For example: http://abc.def.hp.net:9085/webtier-9.60/index.do
