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.
Step 1: Verify CAM Access Point Installation
- Validate that the
CAM Access Point files were installed to
C:\Inetpub\Wwwroot\Esmweb\ExpressSoftwaremanagerAP
- 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:
- From the Start menu, select Control Panel.
- Select Administrative Tools, then select Internet Information Services (IIS) Manager.
- 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.
- 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.
- Right-click
and select Properties.
- 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.
- Click OK in the Properties dialog box, then close the IIS management console.
Step 3: Register the CAM Access Point
- 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 uselocalhost
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:For TLS environments, use https instead of http. See If Web Components Are Not Registered.http://MYIISBOX/camaccesspoint/clientservices.asmx
- 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.
- 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.
- 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 is0
, the registration succeeded. If it is1
, registration failed.- If registration failed, verify that the credentials you specified when installing the CAM Access Point are valid.
- 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:
- Open Web.config in a text editor such as Notepad.
- 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. - Verify that all entries are correct for your installation. If your database server is case-sensitive, these values are also case-sensitive.
- Save and close the file.
- 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:
- Go to the machine where you installed the proxy, and open the Registry.
- Look for the DWORD APProxyPort in HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Express Metrix\7.0
- 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.
- Run the following command from a DOS prompt:
esmsettings.exe -A=<ap-proxy-machine> -P=<AP-proxy-port> -D=<AP-virtual-dir>