DevicesDeploy a Domino A-Series Device (Codenet Protocol)

You can use a Driver Extension Framework solution to deploy a Domino A-Series device that communicates by using Codenet protocol. Deploying this Driver Extension Framework solution requires using the Transfer utility to import it into your Loftware Enterprise SP instance. After you have imported it into Loftware Enterprise SP, you must perform initial configuration of some of the objects in Loftware Enterprise SP.

Note: This topic is provided for advanced administrators. In most cases, it is recommended that you contact your account representative about engaging Loftware Professional Services if you are interested in deploying a Driver Extension Framework solution in your environment.

Import the Driver Extension Framework Solution

An LTTClosed Loftware Transfer Tool format, a special compressed file format for Loftware data. This format is used when transferring objects between Loftware instances or when importing Loftware objects. This file format helps avoid file-naming conflicts between Windows and Loftware and prevents errors due to the Windows limit for file name length. file containing the Driver Extension Framework solution is stored on the Loftware Application Server. To deploy the Driver Extension Framework solution, you must use the Transfer utility to import the objects from the file into a Loftware Enterprise SP instance.

Tip: For more about the Transfer utility, see the Loftware Enterprise SP Data Transfer Guide, available via More Documentation.

To import the Domino A-Series device (Codenet protocol) Driver Extension Framework solution, perform the following steps.

  1. On the Loftware Application Server, open the transfer.properties file described in the Loftware Enterprise SP Data Transfer Guide in a text editor.
    1. In the Transfer data directory or file section, add # at the beginning of any existing line that begins with transfer.data.dir to temporarily disable it.
    2. Add the following lines, replacing <LOFTWARE_HOME> as appropriate. This will restrict the scope of the transfer command to the file containing the Domino A-Series device (Codenet protocol) Driver Extension Framework solution.

      # Domino A-Series Driver Extension Framework

      # IMPORTANT! Use only with import action.

      transfer.data.dir=jar:file:<LOFTWARE_HOME>/product/webapps/downloads/Codenet.ltt

      Note: <LOFTWARE_HOME> represents the folder on the Loftware Application Server in which the Loftware Enterprise SP application is installed. For example, using the syntax for the Transfer utility, in Windows Server this might be C:\Loftware\Spectrum\Spectrum, and in Linux this might be /opt/loftware/spectrum/Spectrum.

    3. Save the file.
  2. At a command prompt, run the following command.

    transfer -action=import -type=all

  3. Sign into Loftware Enterprise SP. In Access Control Access Control, navigate to the Driver Extension Framework folder and confirm that a subfolder has been created containing the objects of the Driver Extension Framework solution.
  4. Edit the transfer.properties file again, inserting # at the beginning of the line you added that begins with transfer.data.dir, and then save the file. This prevents the LTT file from being inadvertently overwritten when someone exports objects.

Configure the Driver Extension Framework Solution

Although most properties of the objects in the Driver Extension Framework solution have been configured for you, you must perform the following steps to configure the solution to support your Loftware Enterprise SP environment.

To configure a Domino A-Series device (Codenet protocol) Driver Extension Framework solution, perform the following steps.

  1. Sign into Loftware Enterprise SP.
  2. In Devices Devices, open the device that is part of the Driver Extension Framework solution.
    1. In the Connection tab, for IP Address enter the IP address or DNS name of the networked device. For a local device not accessible by IP address, enter the IP address or DNS name of the computer to which it is connected.

      Important! Do not change the Connection Type, IP Port, or any other options for the device.

    2. In the ribbon, click SaveSave to save your changes.
  3. In Process Design Process Design, open the process that is part of the Driver Extension Framework solution.
    1. For each process parameter that has a static path, change the root folder of the path to match that of your Loftware Enterprise SP instance.
    2. In the ribbon, click SaveSave to save your changes.
  4. In System System Management, click Tag Management.
    1. Click New Tag Category to add a new tag category.
    2. In the Tag Category Info panel, for Name, enter NumOfLines. No changes are needed to the Type or Class.
    3. For Description, enter the purpose of the tag category, such as "For the Domino A-Series (Codenet protocol) Driver Extension Framework solution, the number of lines in the label template."
    4. In the Tag Values panel, for Associated Values, enter a value for a valid number of lines for the label template associated with the Driver Extension Framework solution and the label format selected on the physical device, and then click Add. Repeat for each valid number of lines. (Adding 1, 2, 3, and 4 is typical.)
    5. In the ribbon, click Save Save to save your changes.
  5. In the ribbon, click New to add a new tag category.
    1. In the Tag Category Info panel, for Name, enter Codenet Label Format. No changes are needed to the Type or Class.

      2. Important: The tag category name must be exactly as shown in these instructions.

    2. For Description, enter the purpose of the tag category, such as "For the Domino A-Series (Codenet protocol) Driver Extension Framework solution, the Codenet Label Format."
    3. In the Tag Values panel, for Associated Values, add a value for each Domino Ax Series Label Format that you use.

    4. In the ribbon, click Save Save to save your changes.

You have finished the required configuration of the Driver Extension Framework solution.

Next Steps

You should review the label template or label templates included in the Driver Extension Framework solution and make any changes needed for the solution to meet your needs. Be aware that the label template associated with a Driver Extension Framework solution requires the use of a native driver and is not WYSIWYG because it must support the physical device's positioning system.

The font used is determined by what is configured on the physical device rather than what is selected in Loftware Enterprise SP. You must ensure that the number of lines in the Loftware Enterprise SP label template matches what is configured on the physical device. If you are changing the number of lines, you may need to create additional tag categories as described in the preceding section, or you may need to change the value of the NumOfLines tag on relevant objects where it is applied.