Installing Optional Servers

This chapter contains the following sections:

1. Installing Longview Grid
2. Installing Longview Data Server Web Service

Installing Longview Grid

Longview systems on Windows platforms can run the math portion of restatements across a grid computing network. This feature introduces a markedly enhanced degree of scalability to restatement functionality by allowing several computers to participate in the calculation process, which greatly increases performance.

For information on the requirements for Longview Grid, see Longview Grid Server.

Before you can set up grid nodes, you must update the Longview Server configuration file, see General System Parameters in Settings for all systems.

For more information on setting up a grid processing environment, see the Longview Server Manager Guide.

Note: 32-bit grid nodes are not supported. In addition, the server combination of Windows Server 2012 - 64-bit and Oracle 11g Release 2 - 64-bit is not supported for Longview Grid.

Installing Longview Grid consists of the following steps:

1. Installing node files
2. Installing and configuring node software

Installing node files

1. On the grid node, create the following directory structure:

   ...\Longview\<LID>

   Note: Longview Identifier, or LID, used should be the same as the host system. For example, if this node is connecting to a system named LongviewDev, the LID used should also be LongviewDev.

2. Extract the Grid_Nodes-win(x64)-23.4.zip file appropriate to your SQL Server version into the <LongviewIdentifier> directory.

   SQL Server version	ODBC Driver for SQL version	File
   2019	18	Grid_Nodes_win(x64)-23.4.zip
   2022	18	Grid_Nodes_win(x64)-23.4.zip

   The directories extracted to your system include:

   Directories	Located in…
   node binaries	...\Longview\<LongviewIdentifier>\software\servers\current
   batch file scripts to install and run the node software	...\Longview\<LongviewIdentifier>\Scripts\defaultsetup
   log files directory	...\Longview\<LongviewIdentifier>\logs

3. In the ...\Longview\<LongviewIdentifier> directory, create a directory with the name “tmp”.
4. Repeat for each node that should participate in the grid.

Installing and configuring node software

Once you have installed the node files, you must install and configure the node software on each grid node.

To install and configure node software:

1. Open the setenv.bat file located in the . \Longview\<LongviewIdentifier>\Scripts folder in your preferred text editor.
2. Update the string:

   KHALIXSERVERPATH=C:\Longview\<LongviewIdentifier>\software\servers\current

   To point to the current version of the node software binaries.

   C:\Longview\<LongviewIdentifier> with the correct path to ...\ Longview\<LongviewIdentifier>;

   for example, E:\Longview\DataServers\LongviewDEV

3. Save the setenv.bat file.
4. Open the installGridservice.bat file in your preferred text editor.
5. Make the following changes:

   Replace all instances of...	with…
   <ServiceName>	The name of the service to identify. Longview recommends that you set this value to _LIDGridNode. For example, _LongviewDevGridNode if the Longview Identifier is LongviewDev.
   <WorkDirectory>	The ...\Longview\<LongviewIdentifier> directory location.
   <BinaryDirectory>	The location of the node binaries in ...\Longview\<LongviewIdentifier>\software\servers\current
   <RemoteHost>	The master or host application server. This can be the IP address or NetBIOS name
   <RemotePort>	The GRID_LISTENER_PORT parameter set in the lvsrvr.cfg file of the host application server. The value should be the same for all nodes for the same system.
   <LongviewIdentifier>	The SERVER_NAME parameter set in the lvsrvr.cfg file of the host application server
   <MathServers>	The amount of math processors to dedicate to the node. This should be a multiple of the number of CPUs to dedicate to the node for math processing. Longview recommends that you set this value to one per dedicated CPU.
   <TempDirectory>	The ...\Longview\<LongviewIdentifier>\tmp directory location.

6. Save the batch file, and then run it.
7. If your Data Server is not running, start it.
8. Start the service to start the node software.

   Note: A node can also run through a DOS prompt window instead of a background service. This requires an active user login to run the node as an Administrator. Please contact Longview Support for instructions if running a node through a DOS prompt window.

9. Repeat for each node participating in the grid.
10. Launch the in the Longview Server Administration Console (lvmgrl).
11. Run the GET NODE CONNECTED to verify that all nodes are connected to the server.

    For more information on this command, see the Longview Server Manager Guide.

Installing Longview Data Server Web Service

The Data Server Web Service software enables users to work with SOAP web services. Be sure to complete the steps in Preparing for Longview Data Server Web Services prior to beginning installation.

To install the Data Server Web Service:

1. Double-click the Longview Data Server Web Service Setup-23.4.exe file received from Longview.
2. The Longview Data Server Web Service Installation wizard opens.
3. Click Next. The Licensing Agreement for Longview software page opens. Read through the agreement and choose your agreement option.
4. Click Yes to agree. The Check for Prerequisites page opens, indicating the success or failure of the installer to locate required resources.
5. Click Next. The Specify Installation Details screen opens.

   

6. Select New Web Service and specify the Longview Identifier (LID) for the Data Server Web Service.

   Note: Only one Data Server Web Service can be installed for each Longview Identifier.

7. Click Next. The Configure Data Server Web Service page opens.

   

8. Complete the following fields.

   Field	Description
   Data Server Host Name	Specify the Data Server host name.
   Data Server Listener Port	Specify the Data Server Listener port. Ports can be set to a value from 1000 to 65535.
   Web Service Admin Port	Specify the Admin port to use for the Web Service. By default, the Web Service Admin port is 60000. Ports can be set to a value from 1000 to 65535.
   Web Service Port	Specify the port to use for the Web Service. This is the port that Apache Tomcat will run on. By default, the Web Service port is 8080. Ports can be set to a value from 1000 to 65535.

9. Click Next. The Choose Destination Location page opens.

   

10. By default, the Longview Data Server Web Services installs in the C:\Longview directory. To select an alternate destination folder, follow these steps.
    1. Click Browse. The Browse for Folder dialog opens.
    2. Navigate to the new destination folder in the tree pane and select it.
    3. Click OK.
11. Click Next. The Start Copying Files page opens.
12. Review the settings, and then click Next. The Installing page opens, displaying the progress of the installation process.
13. After the installation process is complete, the Completing Install page opens.
14. When the install is complete, the Longview Data Server Web Service Setup Complete page opens.
15. Click Finish to exit the wizard.