Registering the CAM Access Point

Normally, the CAM Access Point is registered during the setup process; however, there are times you may need to re-register it.

On-premises Installations

If you run the Setup Wizard and it fails because there is no CAM Access Point, follow these instructions to register it.

Check the Status panel to see whether a CAM Access Point is properly set up.

Step 1: Verify CAM Access Point Installation

  1. Validate that the CAM Access Point files were installed to C:\Inetpub\Wwwroot\Esmweb\ExpressSoftwaremanagerAP
  2. If this folder does not exist on your system, re-run the Setup program.

Step 2: Check the CAM Access Point Virtual Directory

Setup creates a virtual directory (a mapping between a name and a physical disk location) to reference the CAM Access Point. To verify that this was created properly, do the following:

  1. From the Start menu, select Control Panel.
  2. Select Administrative Tools, then select Internet Information Services (IIS) Manager.
  3. In the tree view on the left, open the machine's node, then under Sites, select Default Web Site. This will list all virtual directories defined for your website.
  4. Locate camaccesspoint (version 12.2 and later) or expresssoftwaremanagerap (earlier versions and upgrades) in the list.
    • If it is not there, uninstall the CAM Access Point and reinstall it.
    • If it is shown with , verify that it is pointing to the correct folder (see Step 1).
    • If it is shown with , the CAM Access Point has been created properly and you can proceed to Step 3: Register the CAM Access Point.
  5. Right-click and select Properties.
  6. Select the Virtual Directory tab and verify that the Local Path setting points to where the CAM Access Point files were installed. If it doesn't, browse to the installed location and select OK.
    Even if the path is correct, you may want to select Browse and verify it. If the folder is correct, the icon should change.
  7. Click OK in the Properties dialog box, then close the IIS management console.

Step 3: Register the CAM Access Point

  1. Open a browser window on the CAM Access Point machine and enter the following URL:
    http://<ap-machine>/camaccesspoint/clientservices.asmx

    (for version 12.2 and later)

    http://<ap-machine>/expresssoftwaremanagerap/clientservices.asmx

    (for earlier versions and upgrades)

    where <ap-machine-name> is the name of the machine on which the CAM Access Point is installed.

    Do not use localhost for the machine name, as the CAM Access Point will not get registered properly. For example, if your CAM Access Point machine is MYIISBOX, enter:
    http://MYIISBOX/camaccesspoint/clientservices.asmx
    For TLS environments, use https instead of http. See If Web Components Are Not Registered.
  2. A list of the functions provided by the CAM Access Point should be listed. (If you do not see a list, please contact technical support.) Click RegisterAccessPoint.
  3. Select Invoke.
    If you do not see the Invoke button, you may not be running the browser on the CAM Access Point machine, which is required in order to register the CAM Access Point.
  4. When you select Invoke, a new browser window will appear in which the status of the registering process is displayed. There should be two lines, the second of which includes an <int> </int> tag enclosing a status value. If the value is 0, the registration succeeded. If it is 1, registration failed.
    1. If registration failed, verify that the credentials you specified when installing the CAM Access Point are valid.
    2. If registration succeeded, you're finished, and can now go back and run CAM Administrator. To get started, select Setup Wizard from the Help menu.

Step 4: Verify the CAM Access Point's Database Credentials

If you were able to successfully display the CAM Access Point function list but the registration process failed (a 1 was returned by Invoke), the CAM Access Point was not able to contact the CAM database. If you installed the CAM Access Point separately, this is most likely caused by an incorrect CAM username or password during Setup. (The CAM database account information must match what was specified during database creation.) Unencrypted database access credentials are stored in this file on the CAM Access Point:

                            C:\Inetpub\Wwwroot\Esmweb\ExpressSoftwaremanagerAP\Web.config
                        

If you check the Web.config file and the credentials are incorrect, change them as follows:

  1. Open Web.config in a text editor such as Notepad.
  2. Locate the <DBInfo> tag in the file. In this section of the file, you'll see the database server name, database name, username, and password.
  3. Verify that all entries are correct for your installation. If your database server is case-sensitive, these values are also case-sensitive.
  4. Save and close the file.
  5. Follow the steps in Step 3: Register the CAM Access Point.

Hosted Installations

If you need to manually register the CAM Access Point proxy, you can use the settings utility. The utility is available in the folder from which you installed the on-premises components of your installation.

You need the machine name and port you used during the installation process.

To find the port:

  1. Go to the machine where you installed the proxy, and open the Registry.
  2. Look for the DWORD APProxyPort in HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Express Metrix\7.0
  3. If you're upgrading from a pre-12.2 version of Cherwell Asset Management, enter your virtual directory name. You can find this value in the APProxyVirtualDir field, from the same Registry where you found your value for APProxyPort.
  4. Run the following command from a DOS prompt:
    esmsettings.exe -A=<ap-proxy-machine> -P=<AP-proxy-port> -D=<AP-virtual-dir>