Clarity Service Management

Upgrading CA SAM from 4.0.x 

06-09-2016 08:40 AM

This document describes upgrading CA Software Asset Manager from 4.0 upward from within the SAM User Interface.

This document cannot be followed to upgrade any SAM version prior to 4.x to 4.0.2 (or above) as that requires an upgrade of PHP server to 5.6.

The Upgrade guide to upgrade any SAM version prior to 4.x to 4.0.2 (or above) is available at the following link.


1. Ensure PHP is at the correct version

Ensure that your PHP system is at version 5.6

Start IIS Manager (InetMgr.exe) and find the CA SAM web site:

Click the PHP Manager

Verify the version:

If it is 5.6 you can continue. If not you need to follow the Upgrade document described above.

2. Prepare for the update

ADMIN-> Maintenance->System Update

You will be presented with an upload screen that will list items that should be reviewed and remediated before the update is completed.

Example: The above case tells you that write permissions are currently denied but needed for the install.

Once installed, the rights can be reduced to read-only.

Note: If you do not change the security, the screen will return to the above screen, after the upload.


3. Give Write permissions to the IUSR on the htdocs folder

a.    Navigate to the app folder, e.g.  C:\Program Files (x86)\CA\SAM\app

            b. Right click on the htdocs folder and ensure that IUSR (IIS_IUSRS) (Or the user configured as IIS server user) has write access, in this case a Deny                policy has been added to protect the folders.



               c. Remove or add the Write permission and refresh the WEB page.

If you get this error:

                    It could be that you have tried the upload before allowing the Write access.

               d. Remove the Install folder from the ***\SAM\app\htdocs\{tag}. E.g. : C:\Program Files (x86)\CA\SAM\app\htdocs\prod\install and refresh the browser                     again. You might need to re-login and select system update.


Verify/Modify MaxAllowedContentLength = 1000000000


4. Start the Update

Admin-> Maintenance -> System Update


  1. Download the ZIP file from :

    b. Place the file so it can be browsed from the Browser.

    c. Press ‘Choose File’ and select the ZIP file

     d. Select ‘Carry out update’

     e. Click ‘Ok’ to start the system update

     You will first see that the ZIP file is uploaded

     The install will start


     f. Press ‘Next’

          g. Verify that all is good, if you see errors try to correct them and retry

          h. Press ‘Next’

          i. Verify data and press ‘Next’

        Note: Any errors that are returned need to be corrected


          j. Click ‘Retry’

          k. Click ‘Next’


     l. This is a screen just to ensure that the Pre install conditions are met.    If you are sure the prerequisites are met,   press ‘Skip step’ or check the 3 check boxes      and press ‘Next’


               This is a drive space check.

     m. Press next – Accept to continue.

          It will now move the existing installation to ***\{tag}_old folders for the 3 main folders: htdocs, includes and uploads, and copy the new files to the original           folder  names.


Note this can take a couple of minutes…

     n. Once the copy is done you need verify the configuration. You should not need to change anything as this is an upgrade, but verify the database password is           populated

          Note:  This is important information as the config_soap.ini and the custom_config.ini, we use this information in the post update tasks.

     o.    Press ‘Next’

          The Setup will look at the database version and update it if needed. In this case it is needed.

          p. Press ‘Next’

               Note this can take a couple of minutes as well.

     q. Run a System check or Skip the step. You can run the System Check afterwards if you like from Admin -> Maintenance -> Check Installations

     r. Press ‘Next’ to test

Note: The test can take a couple of minutes.



     s. Similar to step l above, this is just a maintenance check list. It can be skipped or check all boxes and press ‘Next’.


     t.  If you leave the Cleanup install checked it will remove the ZIP files from the install but not the {tag}OLD folders created during the install.  It is recommended to           check the box and clean up the Installation.

          Press ‘Next’

     u.  At the SAM Login screen,  sign in to CA SAM

          v. click ‘Run Checks’ to verify the installation.

               The check can take some time (5-10 minutes). And it will present you with a status like this:



5. Finalizing the Upgrade

Post update steps

a. Change the Security back to Read Only

     Deny Write to the Program Files (x86)\CA\<tag>\htdocs and Program Files (x86)\CA\<tag>\includes


b.  Update the config_soap.ini

As noted in the installation you need to check the SOAP configuration. By default SOAP is disabled.

  • Open the file at the following location:

Program Files (x86)\CA\<tag>\includes\prod\st


  • Copy the login and password from the  old config_soap.ini at includes_old\st\config_soap.ini folder into the new folder
  • Remove the comments on  line 8 and on line 170


6. Update the license

In some cases you will see that the license file has been overwritten. If you have other Modules enabled than the Base CA-SAM modules you need to copy the license file from

Program Files (x86)\CA\<tag>\includes\prod_old\st\custom\ca\license_file.ini to


Program Files (x86)\CA\<tag>\includes\prod\st\custom\ca\license_file.ini

Note: There is no need to restart SAM as the license file will be noticed on the next navigation within CA SAM.

0 Favorited
1 Files
docx file
Upgrading SAM 4.docx   1.23MB   1 version
Uploaded - 05-29-2019

Tags and Keywords


06-09-2016 10:20 AM

Thanks for sharing this with the community Debbie!

Upgrading CA SAM from 4.0.x

Related Entries and Links

No Related Resource entered.