Configuring Cliettes

Use the Cliette page to add, modify, or delete Live Connection database cliettes, and you can also manage database and administrator user IDs and passwords for database cliettes. More information about cliettes is provided in Managing Connections. Figure 9 shows the Cliette page.

Figure 9. The Cliette Page of the Net.Data Administration Tool. Use this page to add, modify, and delete cliettes.


The Cliette Page of the Net.Data Administration Tool

To add a cliette:

  1. Start the administration tool.
  2. From the Cliette page, select <new...> from the Cliette name list. The Add a cliette window opens.

    Figure 10. The Add a Cliette Window of the Net.Data Administration Tool. Use this page to add cliettes.


    The Add Cliette Window of the Net.Data Administration Tool

    If you have enabled encryption, you are prompted for the encryption password the first time you create or modify a cliette. This password is saved and you will not ever have to enter it again.

  3. Select a cliette type from the Type list.
  4. Type a name for the new cliette in the Name field. The name can be the name of the database or another unique cliette name. For example: MYCLIETTE.
  5. Type the encryption password if the Encryption password field is enabled. You will not need to type the password again, as the administration tool saves the password for you.
  6. Click on the Add button.

    The new cliette is created and is added to the bottom of the cliette list. Additionally, the new name is highlighted and the default properties for the cliette are displayed in the Properties group box. You can change these values to fit your configuration.

  7. Close the administration tool, or click on another tab to complete additional configuration tasks.

To modify a cliette:

  1. Start the administration tool.
  2. From the Cliette page, select the name of the cliette that you want to change from the Cliette name list. The properties of the cliette are displayed in the Properties group box.
  3. Modify the properties from the Properties group box, as needed.
    1. The Type field displays the type of cliette that is being defined and corresponds to a language environment type name. Net.Data populates this field when you add a new cliette, and the choices are defined in the Cliette type list in the Add a Cliette window.
    2. The Name field displays the name of the cliette, which is usually the name of the database. Net.Data populates this field when you add a new cliette.
    3. Type the number of cliette process that can be started when Connection Manager is started in the Min process field. You need one unique port address for each process. See Configuring Live Connection for more information about MIN Process values.
    4. In the Max process field, type the number of cliette processes that can be run at the same time, in addition to the processes started when Connection Manager is started. You need one unique port address for each process. See Configuring Live Connection for more information about MAX Process values.
    5. Type a unique port number in the Private port field to specify the starting port number for use with the cliette processes that are started with the Connection Manager. An additional port number is used for each of the processes specified by the Min Process value. For example, if you specify the port number 7012 for Private port and the value 5 for Min process, port numbers 7012-7016 are used and must not conflict with other port assignments in the system.
    6. Type a unique port number in the Public port field to specify the starting port number used with the cliette processes that are started when additional processes are started, up to the number specified in the Max process field. An additional port number is used for each of the processes For example, if you specify the port number 7020 for Public port and the value 5 for Max process, port numbers 7020-7024 are used and must not conflict with other port assignments in the system.
    7. The Exec name field displays the name of the cliette executable file.
  4. If the cliette is being used with a database, modify the values for the Database group box, as needed:
    1. Specify the database name of the database with which the cliette is associated Database name field, for example, MYDBASE.
    2. The Bind file field contains the name and path of the bind file for the type of cliette that you are using.
    3. The Login field specifies the login user ID used to connect to the database.
    4. The Change password push button opens the Change Database Password window. Type the encryption password and the new password, twice. You can encrypt the database password by using the encryption functions specified in the Security pull-down menu.
  5. Select File and then Save to save your changes.
  6. Close the administration tool, or click on another tab to complete additional configuration tasks.

To test the DB2 database logon and connection:

  1. From the Cliette page of the administration tool, click on the DB2 test logon push button. When the test is complete a confirmation window opens, displaying the status of the connection test.
  2. Close the window to continue configuring or close the administration tool.

To delete a cliette:

  1. Start the administration tool.
  2. From the Cliette page, select the name of the cliette that you want to delete from the Cliette name list.
  3. Click on the Delete button.
  4. Close the administration tool, or click on another tab to complete additional configuration tasks.

To turn on encryption of cliette user IDs and passwords:

Encryption provides security for database connections with cliettes. When encryption is turned on, all database passwords in the Live Connection configuration file are encrypted and require an encryption password for access and decryption.

Requirement: You must use a Net.Data Version 2 Live Connection configuration file to use encryption.

  1. Important: Back up a copy of your Live Connection configuration file, <path>dtwcm.cnf. You need this file if you lose the encryption password, or want to decrypt database passwords and need to restore the passwords.
  2. From the Cliette page of the administration tool, select the Security -> Turn encryption on pull-down menu option. The Turn Encryption On confirmation window opens.
  3. Click on Yes to continue. The Encryption Password window opens.
  4. Type the password twice for authorization to work with cliettes that have encrypted passwords.
  5. Click on OK to define the new password and encrypt all of the database passwords for your cliettes.

To turn off encryption of cliette user IDs and passwords:

  1. From the Cliette page of the administration tool, select the Security -> Turn encryption off pull-down menu option. The Turn Encryption Off confirmation window opens.
  2. Click on Yes to continue. All passwords are set to *USE_DEFAULT for security reasons. You can restore your passwords from the backup copy of the Live Connection file, <path>dtwcm.cnf.

To change the password for encryption:

  1. From the Cliette page of the administration tool, select the Security -> Change Encryption Password pull-down menu option. The Change Encryption Password confirmation window opens.
  2. Click on Yes to continue. The Change Encryption Password window opens.
  3. Type the old encryption password once, and the new password twice.
  4. Click on OK to change the encryption password.

To change the database password:

  1. From the Cliette page of the administration tool, click on the Change Password push button. The Change Database Password window opens.
  2. Type the encryption password once and the new database password twice.
  3. Click on OK to change the password and close the window. The changed database password is encrypted if you have turned encryption on.


[ Top of Page | Previous Page | Next Page | Index ]