Skip to main content
OCLC Support

Icon setup

Learn how to run the IconSetup Facility, generate encrypted RDBMS password and edit access control.

Running the IconSetup Facility 

This is used to set up PC Icons, set the Database Login, and for installing Active X.

  1. Locate the Icon Setup application (IconSetup.exe) on your Amlib server or client PC in the Drive:\Amlib\Utility\Icons folder – for example: C:\Amlib\Utility\Icons
  2. Double-click on the IconSetup.exe to open the Amlib Shared Client Installation Wizard:
  3. Click the Next button – the Setup screen will display:
  4. Enter the file path (for example: C:\Amlib or F:\Library\Amlib) to the folder containing the Amlib program files or click the Browse button and locate the folder (the Amlib program files will be located on either a mapped server drive or somewhere on the PC)
  5. Highlight the folder and click the OK button
  6. Click Next button – the Select Components screen will display:
  7. Select (tick) the following options:
    • Choose Module Icons & Functions to Install
    • Admin Tasks (to ensure the Database connection is correct in the Amlib configuration file)
  8. Click the Next button – the RDBMS Login to be used with Amlib screen will display:
    • You will be prompted for a hidden Amlib Database (DBA) Login to connect the Amlib SQL database:
      • AmlibNet DBA User
      • AmlibNet DBA Password
    • Please Note:
      • This will be the RDBMS Login that Amlib will use as a *HIDDEN* Amlib Database (DBA) Login to connect the Amlib Client to the Amlib database
      • An encrypted User and Password can be entered (generated using the Amlib nopasswd.exe utility)
      • This will be stored in within the Windows\amlib.ini configuration file
    • To accept the defaults, click the Next button (this will be most customers)
  9. The Select Start Menu Folder screen will display:
  10. Enter a Start menu folder name (or leave as Amlib Library Management System) and click the Next button – the Select Additional Tasks screen will display:
  11. Ensure the Install desktop icons for selected Components is selected
  12. Click the Next button – the Ready to Install screen will display with a summary of the installation tasks to be performed:
  13. Click the Install button – the Installing screen will display:
  14. When complete click the Finish button
  15. The setup Wizard will close 

Installation of the Amlib Client (Shared) is now complete.

Amlib Setup

When re-running Iconsetup.exe to replace missing components or running to install a new client, you need to be sure where you are accessing the Amlib programs, which will be one of the two following options:

  • Access to Amlib programs from the Server or
  • Install the programs locally and access from the new PC

If you are not sure where you currently access the Amlib program from you can find out by:

  1. Right-click on the Amlib Icon of a different Amlib Client machine and select Properties – the Amlib Toolbar Properties will display
  2. On the Shortcut tab, locate the Target field and note the file path
    • If the Target point to a different drive – for example a library drive or I:/ drive etc then you are most likely accessing Amlib from a server: follow Option 1
    • If the Target file path points to C:/Amlib/Amlibtop.exe then you are most likely accessing the program locally installed on the PC – follow Option 2

Option 1: Access the Programs from the Server

  1. In the Amlib folder on the server, navigate to Amlib > Utilities > Icons > Iconsetup.exe
  2. Copy the Iconsetup.exe file to the new PC and run the file on the PC as per the instructions above, browsing to the Amlib folder on the server

Option 2: Install the Amlib programs from the PC

  1. Copy the Amlib folder from an existing PC that is running Amlib (or from the Server). This will ensure that the programs are the version suitable for the Database.
  2. Run the Amlib > Utilities > Icons > Iconsetup.exe file on the PC and browse to the Amlib folder on the local PC where you have just saved it

Cannot Connect User

When the Amlib client iconsetup is installed on a Windows 7 machine, an amlib.ini file is placed in the C:\Windows (in older machines this may be the C:\Winnt folder). This file contains the SQL Server login details that allow the Amlib client to connect to the SQL databases.

Typically the [Special] section of the amlib.ini file would contain the following information:

  • DatabaseUser=:+,VJxUaS:ye[GLwQmJdU#V,:Z%E%?%d\xb;(6Rpv./$/SWUXB(dV]_K*}NI]R>!kQSBf.
  • DatabasePw=:+,VJxUaS:ye[GLwQmJdU#V,:Z%E%?%d\xb;(6Rpv./$/SWUXB(dV]_K*}NI]R>!kQSBf.

These settings are encrypted version of the SYSADM/SYSADM login (the default RDBMS login used for connecting the Amlib client to the SQL databases) – which are configured during installation of the Amlib client:

Occasionally (due to various permissions issues), the installer is unable to write to the amlib.ini file and the DatabaseUser and DatabasePw settings are left blank:

  • DatabaseUser=
  • DatabasePw=

If this occurs, the user has several choices:

  1. If you wish to use the default SYSADM/SYSADM login, you can copy in paste in the following settings (replacing the blank ones in the file):
    • DatabaseUser=:+,VJxUaS:ye[GLwQmJdU#V,:Z%E%?%d\xb;(6Rpv./$/SWUXB(dV]_K*}NI]R>!kQ SBf.
    • DatabasePw=:+,VJxUaS:ye[GLwQmJdU#V,:Z%E%?%d\xb;(6Rpv./$/SWUXB(dV]_K*}NI]R>!kQSB f.
  2. You can type in the RDBMS login you are using (this login must also have been setup in SQL server against the individual Amlib databases
  3. You can use the nopassword.exe application (C:\Amlib\nopassword.exe) to generate an encrypted login and copy this into the Windows amlib.ini file
    • See: Appendix C: Generate Encrypted RDBMS Password for further information

Please Note: The user may need to adjust the folder and/or file permissions to allow the login details to be written into the amlib.ini file.

  • See Appendix D: Edit Access Control for further information

Addendum: Under certain exceptional circumstances, a copy of the amlib.ini file may also be found in the Users Virtual Store folder:

  • C:\Users\User Name\AppData\Local\VirtualStore\Windows\amlib.ini

This also may need to be adjusted.

Generate Encrypted RDBMS Password

The nopasswd.exe utility is located in the C:\Amlib folder after installation.

  1. Double-click on the nopasswd.exe application to open the Encrypt/decrypt screen will display:
  2. Type in the Password (for which you would like to generate an encrypted string) – for example: DODGER
  3. Press the <Tab> key
  4. The encrypted password will display in the Code box – for example: @8eT5ZpQ^2c^Le-R+QK:|:<1hkD7/<=9c(w%gat3_9f\m+u>&;Zo[Y`>H.E6qWqZ*o."q9
  5. Copy encrypted password for use

Edit Access Control

Due to the additional extra security measures on Windows Server 2008, Windows 7 and Vista, you may need to edit the installation’s access control list settings before being able to customise the SQL.ini (and Amlib.ini) files.

  1. Locate the drive containing the Amlib Client – for example C:\
  2. Right-click on the Amlib folder and select Properties
  3. The Amlib FinTransUpgrade Properties screen will display
  4. Select the Security tab
  5. Click the Edit… button – the Permissions for Amlib FinTransUpgrade screen will display
  6. In the Group or user names: pane, click on the Users entry
  7. Then in the Permissions for Users pane, check the Allow checkbox for the Modify setting – this will give Users the necessary group permission to apply modifications to files and folders in the FinTransUpgrade folder:
  8. This action will automatically check the Allow checkbox for the Write setting:
    ​​​​​​​
  9. Click on the OK button on the Permissions for Amlib FinTransUpgrade and the Amlib FinTransUpgrade Properties screens to complete the change of permissions

 

  • Was this article helpful?