Installing an enterprise system

Configuration types for enterprise systems

When installing an enterprise system, Lexmark Distributed Intelligent Capture can be installed using the following hardware configurations:

Configuration

Description

Advantages

Disadvantages

1-N

Database (DB) and load balancer (LB) on one computer, server on one or more additional computers (most common setup when failover is not used)

The 1-N configuration diagram

Improved performance

Increased hardware needs, no failover for database or load balancer

1-1-N

Database (DB) and load balancer (LB) on separate computers, server on one or more additional computers

The 1-1-N configuration diagram

Note: An external Microsoft SQL database may be installed in place of the standard database, resulting in an E-1-N configuration. The external database (E) and load balancer (LB) are on separate computers, and the server is on one or more additional computers.

Further improved performance

Further increased hardware needs, no failover for database or load balancer

X-N

Database (DB) and load balancer (LB) together on X computers in a Microsoft Cluster Server for failover, server on one or more additional computers (most common setup when using failover)

The X-N configuration diagram

High availability, improved performance

Increased hardware needs, cluster licensing

X-Y-N

Database (DB) on X computers in a Microsoft Cluster Server for failover, load balancer (LB) on Y other computers in a Microsoft Cluster Server for failover, server on one or more additional computers

The X-Y-N configuration diagram

Note: An external Microsoft SQL database may be installed in place of the standard database, resulting in an E-Y-N configuration. The external database (E) on X computers and the load balancer (LB) on Y other computers are in a Microsoft Cluster Server for failover. The server is on one or more additional computers.

High availability, further improved performance

Further increased hardware needs, cluster licensing


Using multiple systems for high availability

When configuring multiple Lexmark Distributed Intelligent Capture systems, you can connect them to a hardware load balancer or Global Site Selector (GSS) to provide high availability, without using clustering, as well as increased capacity.

The hardware load balancer diagram

Each system group contains two identical Lexmark Distributed Intelligent Capture systems. Jobs are balanced between these systems in each group by the hardware load balancer or GSS. If a failure occurs in one system in a group, then the other system in the group receives all incoming jobs until the failed system can be restored.

With this type of setup, you need additional computers, as well as a hardware load balancer or GSS. You also need to manually configure these systems to be identical.

Note: Printers that do not support eSF applications cannot be used with a Lexmark Distributed Intelligent Capture system that uses a hardware load balancer or GSS.

When a hardware load balancer is used with multiple Lexmark Distributed Intelligent Capture systems, the hardware load balancer must be configured as follows:

System sizing guidelines

There are two main factors for determining the number of servers required to process jobs efficiently:

Additionally, the database, when installed on the recommended hardware and connected using Gigabit Ethernet, can process 200,000 logged messages per hour, which is approximately 40,000 jobs per hour when using a typical solution (five logged messages per job). If this limit is reached, then it may be necessary to use multiple systems.

Peak demand

Use the following formulas to determine the number of servers necessary to handle peak loads for a particular solution:

(System-wide hourly job rate) = (system printer capacity) x (jobs per printer per day) / (length of business day)

(Peak demand) = 2 x (system-wide hourly job rate)

(Minimum number of servers) = (peak demand) / (single-server throughput for current solution)

Consider the following example:

Perform the following calculations:

  1. Determine the system-wide hourly job rate:

    (300 printers) x (100 daily jobs/printer) / (8 hours/day) = 3750 jobs/hour

  2. Determine the peak demand:

    2 x (3750 jobs/hour) = 7500 jobs/hour

  3. Determine the minimum number of servers:

    (7500 jobs/hour) / (3000 jobs/hour) = 2.5

    Rounding up, the system should include three servers to reliably handle the peak load for a solution with average execution time below 30 seconds.

The single-server throughput for a solution must be determined by the solution developer, though the following typical throughputs on a server with the recommended hardware may help determine a rough estimate:

Solution processing load

Functions used

Average single-server throughput

Typical

  • Some image processing

  • Printing

6000–8000 jobs per hour

Heavy

  • Extensive image processing

  • Bar codes

  • External processes

  • Small to medium Document Producer (e-forms) jobs

2000–3000 jobs per hour

Very heavy (OCR)

  • OCR

  • Large Document Producer (e-forms) jobs

100–200 jobs per hour


Note: Using less than the recommended RAM significantly reduces throughput. For example, a dual-processor server with only 2GB of RAM can process only 600–800 jobs/hour when using a “heavy” solution.

For more information, see the Lexmark Document Distributor SDK Guide.

Concurrency

Each server that meets recommended requirements can process 30 concurrent jobs from clients. The following formula determines the number of servers necessary to meet concurrency requirements:

(minimum number of servers) = (number of printers expected to submit jobs near the same time) / 30

For example, assume that 1/3 of the 300 printers in the last example might be active at the same time:

100 / 30 = 3.33

Rounding up, the system should include four servers to allow for 100 active printers for a solution with average execution time below 30 seconds.

Installation overview for an enterprise system

  1. Select a system configuration, and then configure the appropriate hardware on the network.

  2. Make sure that the time on all computers used in the Lexmark Distributed Intelligent Capture system is synchronized using a Network Time Protocol (NTP) server.

  3. Install the system components.

    Note: If you are installing Lexmark Distributed Intelligent Capture using the default database (Firebird), then the system components can be installed in any order. However, if you are using Microsoft SQL database, then see Using Microsoft SQL database before installing LDIC.
    1. Install the database.

    2. Activate and download licenses on the computer where the load balancer is installed.

    3. Install the load balancer.

    4. If you are using one or more Microsoft Cluster Servers, then extend the database and load balancer to standby nodes.

    5. Install servers.

      Note: When installing multiple servers, install one server at a time.
  4. Change the administrator password. If necessary, change the administrator user name.

  5. Temporarily set servers online to test function.

Notes:

Using Microsoft SQL database

If you are using Microsoft SQL as the back-end database, then make sure that:

For LDIC to work with Microsoft SQL, create seven databases before the load balancer and server are installed. To help the database administrator create these databases, do the following:

  1. From the Microsoft SQL server, run the command prompt as an administrator, and then type

    sqlcmd -i <installerpath>\mssql\scripts\CreateDatabase.sql -o <outputfilepath>\MyOutput.txt

    where <installerpath> is the location of the LDIC installer and <outputfilepath> is the location where you want to save the log file.

  2. Confirm that the databases are installed completely.

    1. Type sqlcmd -S . to connect to the default instance.

    2. Type select name from sys.databases to show all databases.

    Note: The CreateDatabase.sql file contains the minimum database size required for LDIC. You can increase the database size as needed.
  3. Enable TCP/IP connections and port numbers.

    In the SQL Server Configuration Manager, do the following:

    1. From the Server Network Configuration, make sure that TCP/IP is enabled and the port number is set to 1433.

      Note: To check the port numbers for the IP addresses, open the TCP/IP properties.
    2. From the Native Client Configuration, make sure that TCP/IP is enabled.

Note: You can also migrate data from Firebird to Microsoft SQL. For more information, see the Readme file for database migration at <InstallCD>\install\mssql_migration\readme_migration.txt, where <InstallCD> is the location of the LDIC installer CD.

Installing the database and load balancer without clustering (configurations 1, 1-N, and 1-1-N)

Installing the database
Note: If you are installing a Microsoft SQL database, then do not install the default database (Firebird).

From the computer where the database is running, do the following:

  1. From the installation package, run Setup.exe.

  2. From the Lexmark Solutions installation window, click Install Enterprise System > Install Database.

  3. Accept the license agreement.

  4. If necessary, specify a location for the installation, and then click Next.

    Note: The installation path cannot contain double-byte characters.
  5. Do one of the following:

    • Select the IP address of the computer that runs the database.

    • Select IP address only install to use only IP addresses without a reliable DNS.

    • Select Restore Install (RI), and then specify or locate the .ri file to install a backup recovery system.

  6. Follow the instructions on the computer screen.

Installing the load balancer

From the computer where the load balancer is running, do the following:

  1. From the installation package, run Setup.exe.

  2. From the Lexmark Solutions installation window, click Install Enterprise System > Install Load Balancer.

  3. Accept the license agreement.

  4. If necessary, specify a location for the installation, and then click Next.

    Note: The installation path cannot contain double-byte characters.
  5. Select the IP address of the computer that runs the load balancer.

    Note: Select IP address only install to use only IP addresses without a reliable DNS.
  6. Type the fully qualified domain name or IP address of the computer where the database is installed.

    Notes:

    • Do not use localhost or the loopback IP address (127.0.0.1) for the location of the database.
    • When installing any configuration other than configuration 1, set the location of the database during installation. If the database is moved, or the IP address of the database changes for any other reason, then reinstall the load balancer. For more information on changing the IP address of a Configuration 1 system, see Changing the IP address on a configuration 1 system.
  7. Select the type of database, and then click Next.

    Note: If you are installing a Microsoft SQL database, then make sure that the database is installed before proceeding with the load balancer installation.
  8. Specify the folder that contains your license files, and then click Next.

    Notes:

    • If the license files are on a network folder that requires authentication, then you may need to authenticate it before specifying the license location. To authenticate with the remote server, type the UNC path (for example, \\myserver\myshare\) in the Run dialog box, and then enter the credentials when prompted.
    • During installation, the license files are copied to the program folder. You can safely move the license files from the temporary location where you saved them.
  9. If you are installing a system to recover a backup, then select Restore Install (RI), and then specify or locate .ri file.

  10. Follow the instructions on the computer screen.

Installing the database and load balancer with clustering (configurations X-N, and X-Y-N)

Before you begin, make sure that:

Setting up firewall exceptions on a Windows Server 2008 or Windows Server 2012 cluster node
  1. Create a temporary directory.

  2. From the install\Cluster_Config_Script of the installation package, copy the batch files to the temporary directory.

  3. Run the command prompt as administrator, and then access the temporary directory.

  4. Run the batch files.

    Note: If you are using a Microsoft SQL database, then do not run the dB firewall batch file.
Installing the database

Notes:

  1. From the installation package, run Setup.exe.

  2. From the Lexmark Solutions installation window, click Install Enterprise System > Install Database.

  3. Accept the license agreement.

  4. Specify a location on a shared cluster disk for the installation, and then click Next.

    Note: The installation path cannot contain double-byte characters.
  5. Do one of the following:

    • Select the IP address or host name of the logical host of the cluster.

    • Select IP address only install to use only IP addresses without reliable DNS.

    • Select Restore Install (RI), and then specify or locate the .ri file to install a backup recovery system.

  6. Follow the instructions on the computer screen.

Installing the load balancer
  1. From the installation package, run Setup.exe.

  2. From the Lexmark Solutions installation window, click Install Enterprise System > Install Load Balancer.

  3. Accept the license agreement.

  4. If necessary, specify a location on a shared cluster disk for the installation, and then click Next.

    Note: The installation path cannot contain double-byte characters.
  5. Select the IP address or host name of the logical host of the cluster.

    Note: Select IP address only install to use only IP addresses without reliable DNS.
  6. Type the domain name or IP address of the logical host.

    Notes:

    • Do not use localhost or the loopback IP address (127.0.0.1) for the location of the database.
    • For installation on a cluster, set the location of the database during installation. If the database is moved, then reinstall the load balancer, or contact Lexmark Professional Services to help modify the current installation.
  7. Select the type of database, and then specify the folder containing the license files.

    Notes:

    • If you are using a Microsoft SQL database, then make sure that the database is installed before proceeding with the load balancer installation.
    • If the license files are on a network folder that requires authentication, then you may need to authenticate it before specifying the license location. To authenticate with the remote server, type the UNC path (for example, \\myserver\myshare\) in the Run dialog box, and then enter the credentials when prompted.
    • For cluster installation, the folder must contain the license files for all of the cluster nodes with their appropriate network card MAC addresses.
  8. If you are installing a backup recovery system, then select Restore Install (RI), and then specify or locate the .ri file.

  9. Follow the instructions on the computer screen.

Extending the database and load balancer to standby nodes

Do the following on the primary node of each failover cluster:

  1. Run the Lexmark Solutions Cluster Configuration script:

    In Windows Server 2003

    From the install\Cluster_Config_Script folder of the installation package, run the LexmarkSolutionsClusterConfigScript.vbs script.

    In Windows Server 2008 or later
    1. Create a temporary directory.

    2. From the install\Cluster_Config_Script of the installation package, copy either of the following to the temporary directory:

      • LexmarkSolutionsClusterConfigScript_WMIProvider.vbs

      • LexmarkSolutionsClusterConfigScript.vbs

    3. Run the command prompt as administrator, and then access the temporary directory.

    4. Run the VBScript file by typing either of the following:

      • cscript LexmarkSolutionsClusterConfigScript_WMIProvider.vbs

      • cscript LexmarkSolutionsClusterConfigScript.vbs

  2. Follow the instructions on the computer screen.

Installing servers

Note: When installing multiple servers, install one server at a time.

From the computer where the server is running, do the following:

  1. From the installation package, run Setup.exe.

  2. From the Lexmark Solutions installation window, click Install Enterprise System > Install Server.

  3. Accept the license agreement.

  4. If necessary, specify a location for the installation, and then click Next.

  5. Do one of the following:

    • If the computer contains multiple network adapters, then select the IP address to bind to the installed server.

    • Select IP address only install to use only IP addresses without reliable DNS.

  6. Type the fully qualified domain name or IP address of the computer or cluster logical host where the database is installed.

    Notes:

    • Do not use localhost or the loopback IP address (127.0.0.1) for the location of the database or load balancer.
    • If you are using DNS aliases for connection to a backup system during a recovery, then use the DNS aliases of the database and load balancer.
  7. Select the type of database, and then click Next.

    Note: If you are using a Microsoft SQL database, then make sure that the database is installed before proceeding with the server installation.
  8. Select Same as Database if the load balancer is installed on the same computer as the database.

    Notes:

    • If you want to type the fully qualified domain name or IP address of the computer or cluster logical host, then clear Same as Database.
    • When installing any configuration other than configuration 1, set the location of the database and load balancer during installation. If the database or load balancer is moved, or the IP address of the database or load balancer changes for any other reason, then reinstall the load balancer. For more information about changing the IP address of a Configuration 1 system, see Changing the IP address on a configuration 1 system.
  9. If you want to set the Global Site Selector (GSS) IP address, then do the following:

    1. Click Advanced.

    2. Type the GSS IP address, and then click OK.

    Note: You can type a GSS IP address only if all the printers in the system are e-Task 2 or later. GSS is not supported in e-Task and earlier printers.
  10. Follow the instructions on the computer screen.

  11. Note: After all servers are installed, log in to LMC, then change the administrator password, and then set the servers online.