Installing an enterprise system

Configuration types for enterprise systems

When installing an enterprise system, LDD 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 Server 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 Server 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 LDD 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 LDD 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 an LDD system that uses a hardware load balancer or GSS.

When a hardware load balancer is used with multiple LDD 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 LDD system is synchronized using a Network Time Protocol (NTP) server.

  3. Install the system components.

    Note: If you are installing LDD using the default database (Firebird), then the system components can be installed in any order. However, if you are using Microsoft SQL Server database, then see Using Microsoft SQL Server database before installing LDD.
    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 Server database

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

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

  1. Open the CreateDatabase.sql file at <installerpath>\mssql\scripts\CreateDatabase.sql, where <installerpath> is the location of the LDD installer.

  2. Modify the script to control the creation of the LDD databases in Microsoft SQL Server, and then save the file.

    Note: The CreateDatabase.sql file contains the minimum database size required for LDD. You can increase the database size as needed.
  3. From 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 LDD installer and <outputfilepath> is the location where you want to save the log file.

  4. 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.

  5. 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 Server. 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 LDD 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 using a Microsoft SQL Server database, then do not install the default database (Firebird) component.

From the system where you want to install the database, do the following:

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

  2. Select a language for the installation, and then click OK.

  3. From the LDD Setup window, click Next.

  4. Select Install LDD system components, and then click Next.

  5. Accept the license agreement, and then click Next.

  6. From the list of components, select Database, and then click Next.

  7. Specify a location for the installation, and then click Next.

    Note: The installation path must not contain double-byte characters.
  8. Select your database IP address, and then click Next.

    Note: If necessary, select Allow only IP address.
  9. If you are installing a backup recovery system, then select Restore Install (RI), specify or locate the .ri file, and then click Next.

  10. Review the setup information, and then click Next.

  11. Click Install.

Installing the load balancer

From the system where you want to install the load balancer, do the following:

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

  2. Select a language for the installation, and then click OK.

  3. From the LDD Setup window, click Next.

  4. Select Install LDD system components, and then click Next.

  5. Accept the license agreement, and then click Next.

  6. From the list of components, select Load balancer, and then click Next.

  7. Specify a location for the installation, and then click Next.

    Note: The installation path must not contain double-byte characters.
  8. Select your load balancer IP address, and then click Next.

    Note: If necessary, select Allow only IP address.
  9. Specify the host name or IP address of the database, select the database type, and then click Next.

    Notes:

    • If you are installing a Microsoft SQL Server database, then make sure that the database is installed before proceeding with the load balancer installation.
    • Do not use localhost or the loopback IP address (127.0.0.1) for the location of the database.
    • When you are installing a 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.
  10. If you are installing a backup recovery system, then select Restore Install (RI), specify or locate the .ri file, and then click Next.

  11. Review the setup information, and then click Next.

  12. Click Install.

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 Server database, then do not run the DB firewall batch file.
Installing the database

Notes:

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

  2. Select a language for the installation, and then click OK.

  3. From the LDD Setup window, click Next.

  4. Select Install LDD system components, and then click Next.

  5. Accept the license agreement, and then click Next.

  6. From the list of components, select Database, and then click Next.

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

    Note: The installation path must not contain double-byte characters.
  8. Select the host name or IP address of the logical host of the cluster, and then click Next.

    Note: If necessary, select Allow only IP address.
  9. If you are installing a backup recovery system, then select Restore Install (RI), specify or locate the .ri file, and then click Next.

  10. Review the setup information, and then click Next.

  11. Click Install.

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

  2. Select a language for the installation, and then click OK.

  3. From the LDD Setup window, click Next.

  4. Select Install LDD system components, and then click Next.

  5. Accept the license agreement, and then click Next.

  6. From the list of components, select Load balancer, and then click Next.

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

    Note: The installation path must not contain double-byte characters.
  8. Select the host name or IP address of the logical host of the cluster, and then click Next.

    Note: If necessary, select Allow only IP address.
  9. Type the host name or IP address of the logical host, select the database type, and then click Next.

    Notes:

    • If you are using a Microsoft SQL Server database, then make sure that the database is installed before proceeding with the load balancer installation.
    • Do not use localhost or the loopback IP address (127.0.0.1) for the location of the database.
    • If installing 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.
  10. If you are installing a backup recovery system, then select Restore Install (RI), specify or locate the .ri file, and then click Next.

  11. Review the setup information, and then click Next.

  12. Click Install.

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:

    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 an 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 screen.

Installing servers

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

From the system where you want to install the server, do the following:

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

  2. Select a language for the installation, and then click OK.

  3. From the LDD Setup window, click Next.

  4. Select Install LDD system components, and then click Next.

  5. Accept the license agreement, and then click Next.

  6. From the list of components, select Server, and then click Next.

    Note: You can install optional server components, such as Barcode Read, Barcode Write, and OCR, after the LDD installation.
  7. Specify a location for the installation, and then click Next.

    Note: The installation path must not contain double-byte characters.
  8. For multiple networks, select the IP address to which you want to bind the server, and then click Next.

    Note: If necessary, select Allow only IP address.
  9. Type the host name or IP address of the load balancer and of the database, select the database type, and then click Next.

    Notes:

    • If you are using a Microsoft SQL Server database, then make sure that the database is installed before proceeding with the server installation.
    • 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 when connecting to a backup system during a recovery, then use the DNS aliases of the database and load balancer.
    • If necessary, select Hardware Load balancer, and then type the IP address of a hardware load balancer, such as F5 or Global Site Selector (GSS). Use this setting only if all of the printers in the LDD system support eSF applications.
  10. Review the setup information, and then click Next.

  11. Click Install.

  12. Notes: