Example: Setting up a vertical scaling implementation

The following example describes how to set up a vertical scaling implementation that accomplishes the following:

• Maximizes the number of client connections supported on a single host
• Allows an administrator to specify the communications ports the Service Manager implementation uses

You can use this example to configure the implementation depicted in the Vertical scaling implementation diagram.

1. Install Service Manager on one host. For example: myserver1.
2. Log in to the operating system of the Service Manager server host and change directories to the Service Manager RUN folder. For example:

   C:\Program Files\Micro Focus\ Service Manager\server\RUN
   

3. Open the Service Manager configuration file (sm.cfg or smstart) in a text editor.
4. Add the following lines:

   sm -loadBalancer -httpPort:13080
   sm -httpPort:13081 -httpsPort:13082
   sm -httpPort:13083 -httpsPort:13084
   

   The loadBalancer parameter creates a special servlet container process to route client connection requests to other available servlet container processes. A vertical scaling implementation only needs one load balancer.
   The httpPort:13080 parameter specifies that the load balancer process listens to client connection requests on HTTP port 13080. This communications port must be unique across all hosts that you want to join the Service Manager virtual group.
   The httpPort:13081 parameter specifies that the servlet container process listens to client connection requests on HTTP port 13081. This communications port must be unique on the host on which you start the servlet container.
   The httpsPort:13082 parameter specifies that the servlet container process listens to client connection requests on HTTPS port 13082. This communications port must be unique on the host on which you start the servlet container.
   The httpPort:13083 parameter specifies that the servlet container process listens to client connection requests on HTTP port 13083. This communications port must be unique on the host on which you start the servlet container.
   The httpsPort:13084 parameter specifies that the servlet container process listens to client connection requests on HTTPS port 13084. This communications port must be unique on the host on which you start the servlet container.
5. Save the Service Manager configuration file.
6. Open the Service Manager initialization file (sm.ini) in a text editor.
7. Verify that the auth parameter has a valid authorization code.
8. Add the RDBMS connection settings. For example:

   [oracle10]
   sqldb:ora102
   sqllogin:sm7user/password
   sqllibrary:SQORACLE.OCI10.DLL
   sqldictionary:oracle10
   

9. Add the following lines:

   threadsperprocess:50
   sessiontimeout:3
   

   The threadsperprocess:50 parameter defines the number of threads each process supports. A value of 50 threads assumes that the Service Manager host has the minimum recommended system memory available for servlet container processes.
   The sessiontimeout:3 parameter defines the number of minutes that the client connection can remain unresponsive before the server closes the connection. A value of 3 minutes assumes that most network latency issues are quickly and easily resolved.
10. Save the Service Manager initialization file.
11. Start the Service Manager server.
12. Log in to the operating system of the Service Manager Web tier host and change directories to the Service Manager WEB-INF folder. For example:

    C:\apache-tomcat-5.5.12\webapps\sm\WEB-INF
    

13. Open the Web configuration file (web.xml) in a text editor.
14. Set the following parameter values:

    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.

    ...
    <context-param>
      <param-name>secureLogin</param-name>
      <param-value>true</param-value>
    </context-param>
    <context-param>
      <param-name>sslPort</param-name>
      <param-value>8443</param-value>
    </context-param>
    ...
      <param-name>serverHost</param-name>
      <param-value>myserver1</param-value>
    </init-param>
    <init-param>
      <param-name>serverPort</param-name>
      <param-value>13080</param-value>
    </init-param>
    

15. Save the Web configuration file.
16. Start the Service Manager Web tier.
17. Open Service Manager Windows clients and set the Service Manager host name and communication port values:
    
    

    Field	Value
    Server host name	myserver1
    Server port number	13080

    
    
18. Connect to the Service Manager host.

Related topics