Adding a New Server in an Existing Logical Server

Overview of Adding a New Server in an Existing Logical Server

Defining a new server in an existing logical server, consists of:

Installing the new server software on the new machine with the SAS Deployment Wizard.
If you are installing a server that requires an object spawner and there is not already a spawner on the new machine, then when you install the server, you must also install and configure the object spawner.
Copying the necessary configuration directories from the existing logical server machine to the new machine.
Using the SAS Management Console to define the new servers in the metadata repository.

Add a New Server in an Existing Logical Server

You might decide that you need add another server in your logical server. The most common scenario is that you want to establish a server cluster to achieve load balancing. If you are adding one of the workspace servers or a stored process server, then you must also add an object spawner to manage it, unless there is already a spawner on the machine. Follow these steps to add a new server and—if necessary—an object spawner to an existing logical server:

The machine on which you want to add the new server should have a network connection to your site's SAS Software Depot. If it does not, then you must find a way to get the depot to the machine on which you want to create the new server.

For more information, see Overview of SAS Software Depots in SAS Intelligence Platform: Installation and Configuration Guide.
Make sure that you have first installed the new server on the new machine by referring to Adding SAS Products in SAS Intelligence Platform: Installation and Configuration Guide. When installing the new server, follow these guidelines:
1. If you are installing one of the workspace servers or a stored process server, then you also need an object spawner to be on the new machine. Do one of the following:
2. If you:
  
  Need an object spawner:
  
  then when installing the new server with the SAS Deployment Wizard, make sure that you choose both Install SAS Software and Configure SAS Software.
  
  Do not need an object spawner:
  
  then when installing the new server with the SAS Deployment Wizard, make sure that you choose Install SAS Software and deselect Configure SAS Software.
3. When you see the wizard's Specify Configuration Information dialog box, make sure that the configuration directory that you enter matches the SAS configuration directory on the machine that contains the pre-existing SAS Application Server. For example, C:\SAS\Config.
4. When you see the wizard's Select Products to Configure dialog box, check SAS Object Spawner only. Server configuration is described in later steps in this topic.
Create a configuration path on the new machine that matches the configuration path on the pre-existing machine.

For example, if the configuration path on machine 1 is C:\SAS\Config\Lev1, then create the same path on machine 2.
Copy the configuration directories of the pre-existing SAS Application Server to the new machine.

For example, on Windows, copy the following directory from machine 1 to machine 2:

C:\SAS\Config\Lev1\SASApp
Copy the configuration directories of any pre-existing logical servers to which you are adding additional servers, to the new machine.

For example, if you are adding another workspace server, copy the following directory from machine 1 to machine 2:

C:\SAS\Config\Lev1\SASApp\WorkspaceServer
Start SAS Management Console and connect to a metadata repository.
In the SAS Management Console navigation tree, select and expand the Server Manager, and locate the SAS Application Server under which you want to add the new server.
Expand the SAS Application Server and locate the logical server under which you want to add the new server.

Note: The logical server must be the same type of server as the server that you are adding. If there is no logical server, go to the following topic, Add a New Logical Server in an Existing SAS Application Server.
With the logical server selected, choose ActionsAdd Server from the menu bar.

The New Server Wizard is displayed.
Enter a name (required) and a description (optional) for the new server. The server name should indicate the machine, server type, and unique port on the new machine for the server. When you are finished, click Next.

The name that you provide will be the name of the server that is displayed in the SAS Management Console Server Manager plug-in.
Specify whatever configuration information is required for the type of server that you are adding. The number of wizard pages that you see and the information that you must supply, varies depending on the server type. Use the wizard online Help if necessary. For information about object server parameters, see OBJECTSERVERPARMS System Option.

Note: To avoid a configuration error and failed client connections, you must enter user credentials when defining a pooled workspace and a stored process server.
When you see a wizard page that states that you have successfully completed a new server definition, review the information supplied and do one of the following:
- click Finish to add the new server and close the New Server Wizard.
- click Back to go to an earlier wizard page to change an input.