View source for AMS - Asset Management System guideline

==Basic information==
===Scope===
This article serves as a guideline to partners, related to the ICX license process as well as the product lifecycle management of ICX systems.

==IC Asset Management System==
The IC Asset Management System (IC AMS) provides a portal for product life cycle management, as well as a tool for partners/installers for license activation and license installation for ICX systems.
===Definitions===
<ol>
<li><h4><strong>Product key</strong></h4>
A Zenitel product key is a 25-character code used to activate Zenitel licenses. A product key contains all licenses included in one invoice. A product key can be used to generate several license files, but only for one end customer. It looks like this: 
PRODUCT KEY: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX </li>

<li><h4><strong>Zenitel fingerprint file</strong></h4>
The Zenitel fingerprint file is a signed file which is generated by the ICX-500 or ICXCORE to be licensed. It serves as a way to uniquely identify the hardware on which the software/firmware is running. </li>

<li><h4><strong>Zenitel license file</strong></h4>
The Zenitel license file is a signed file to be installed on ICX-500 or ICX-Core. Each ICX-500 or ICX-Core will have its own Zenitel license file. </li>

<li><h4><strong>Site node</strong></h4>
In the IC Asset Management system, a site node is one ICX-500 or one ICX-Core. Each site will have its own license file. A site node is created from the End Customer dashboard.</li>
</ol> <br>
===IC AMS login===
To log in to IC AMS, please visit https://ams.zenitel.com/

Login credentials are the same as for Zenitel.com.
If you do not have a Zenitel.com user account, registration can be done here:
https://www.zenitel.com/user/register
====First time login====
When logging in to IC AMS for the very first time, the user will not have any affiliations. To link the user to the proper partner/company, a product key, belonging to the relevant company must be used for identification.
To get the correct affiliation, the user must enter a valid product key, select the “Register” box and press “submit”.

[[File:AMS_FirstTimeLogIn.png|700px|none]]
 

The application will then be available for a Zenitel system admin or an already existing Partner admin, via the “Manage users” link on the IC AMS dashboard. When this application is approved, next time login will direct the user to the partner dashboard of IC AMS.
====Standard login====
Standard login to IC AMS is done via https://ams.zenitel.com/, using same login credentials as for Zenitel.com.
Login will give access to the partner dashboard, which show:
<ol>
<li>End customers</li>
<li>Purchased product keys, with reference to:</li>
<li>System administration</li>
<ul>
<li>User management</li>
<li>System log</li>
<li>Reporting services</li>
</ul>
</ol>

==License activation==
License activation for ICX is done by a Partner or installer, using the IC Asset Management system, https://ams.zenitel.com/
The system provides two main options for license activation:
#License activation when logged in, typically the process when licenses are activated by a registered partner
#License activation without logging in, typically the process when licenses are activated by an installer, not registered as a user in IC AMS
<br>
Independent on the two activation alternatives, the following is required to be able to activate licenses:
#Valid product key(s) with licenses to activate – received from Zenitel CS
#Product key(s) linked to end customer – done by IC AMS registered user
#Fingerprint file for the ICX where license file is to be installed. The fingerprint file is generated via the ICX web interface


===Link product key to end customer===
To be able to link a product key to an end customer, the end customer must be defined in IC AMS.
End customers are added to IC AMS by using the “Add new end customer” link in IC AMS. When adding an end customer, the following information must be provided:
#Company name
#Company email address
#Company contact person
#Company phone

[[File:Add_endcustdata.jpg|700px|none]]


<u>A product key can only be linked to one end customer</u>. Linking a product key to end customer is done via the IC AMS partner dashboard, by selecting the correct end customer from the drop down list in the product keys table. 

[[File:Create_endcustomer.jpg|700px|none]]


===License activation when logged in===

When logging in to IC AMS to activate licenses, the main process consists of the following main steps:
<ol>
<li>Navigate to the correct end customer, by clicking the end customer name in the end customer table.</li>

[[File:end_custdashboard.jpg|700px|none]]


<li>Create a site node, selecting the “create site node” link. First step when creating a new site node, is to upload the ICX fingerprint file. Select “Choose file” and browse to the relevant ICX fingerprint file. Press “Submit file” to upload fingerprint file to IC AMS.</li>

[[File:create_sitenode.jpg|700px|none]]


<li>When fingerprint file is uploaded, a site address is required. Optionally you can also define a site label, only used for additional sorting/grouping.</li>
The number and types of licenses to activate must be selected, by entering the required number of licenses. The IC AMS will show the number of available licenses in parenthesis next to the license name.</li>

[[File:Select_licenses_to_activate.jpg|700px|none]]



When the required licenses have been selected, the EULA acceptance box must be checked, before pressing “Create license” to generate a signed license file.

[[File:create_license.jpg|700px|none]]

<li>The license file generation have now been completed.
<br>The IC AMS will then provide:
<ol><li>The signed license file in text format, which can be copied and pasted directly into the ICXweb of the ICX.</li>
<li>Download link to the license file, which in turn can be uploaded to the ICX via ICXweb.</li></ol>
</li>
</ol>
<br>

===License activation by logging in using the Product Key ===


It is also possible to activate licenses and create a license file when only the Product Key is available, this for cases when an installer is on site, and does not have the required license file.

{{note|To create a license file by logging in using the Product Key, the product key must have been linked to the "End Customer" on beforehand by a registered AMS user.}}

To activate licenses in this way, the process is as follows:

<ol>
<li>Navigate to https://ams.zenitel.com/ and click on '''Login Using Product Key Instead'''. Now enter the relevant product key and press the “Submit” button. The license activation process will then be started, and the IC AMS will display the number of licenses included on this product key. </li>

[[File:Generate_licensefile_no_login.jpg|700px|none]]


If the product key has not yet been assigned to an end customer, the process will stop, and the installer will be prompted with information that product key has not been assigned to an end customer. In this case, the installer will need to contact the partner, and make sure product key is linked to the end customer

[[File:Productkey_not_assigned.jpg|700px|none]]


<li>Next step will be to create a site node for this end customer, by uploading the ICX fingerprint file.
To complete the license activation and license file generation, the following must be provided:
<ul>
<li>	site address for the site node must be provided </li>
<li>	Optionally the site label.</li>
<li>	The correct number of licenses must be selected, </li>
<li>	EULA acceptance must be done, before pressing “Create license” button</li>
</ul>
</li>

[[File:Uploaded_fingerprint_no_login.jpg|700px|none]]


<li>The license file generation have now been completed. 
The IC AMS will then provide:
<ol>
<li>	The signed license file in text format, which can be copied and pasted directly into the ICXweb of the ICX.</li>
<li>	Download link to the license file, which in turn can be uploaded to the ICX via ICXweb</li>
</ol>
</li>

[[File:License_transaction_complete.jpg|700px|none]]
<br style="clear:both;" />

[[Category: ICX-AlphaCom Platform]]
[[Category: Licensing]]