Porting license types between servers

To export a license type

1. In Mid Tier, in Application Administration Console, select Custom Configuration > Asset Management > Advanced Options > Import and Export License Types, and then click Open.
2. On the AST:LicenseTypeUtility form, click the Export License Type link.

3. From the Available Licenses table, select the license types to export and click Add.

   Important

   Press the Ctrl key to select multiple license types. When you add multiple license types, each license type is exported to a separate ARX file.

4. Enter the following information:

   Field name	Description
   Short Description	Briefly describe the reason for exporting the license types.
   Export ID	Enter a unique identifier for the export. This ID is appended to the license type name, which is also the name of the exported ARX file. This identifier can include basic information about the exported files, and can be used to identify exported licenses. Example: You choose to export the Per copy and the Per copy per device license types because you have changed a compliance question for those license types. Using the License Type Import and Export tool, you export these licenses and enter ComplianceUpdt as the Export ID. The exported files are saved as PerCopy_ComplianceUpdt.arx and PerCopyPerDevice_ComplianceUpdt.arx.
   User Password	Enter the password of the logged-on user. If the logged-on user does not have a password defined, select the Confirm password is blank check box.

5. Click the Export License Type button.
   The time required to export the license types depends on the size of the ARX file.
   When the export is complete, the ARX file is displayed in the Export Result table.
6. Select the file from the list, and click Download to save the file to the local computer.
   The exported ARX files are also saved in the Export History.
7. (Optional) To view details of the exported files, click the History link. 

Troubleshooting export in a UNIX environment

Because of processing speed differences between the export tool on the server and the client, sometimes the ARX file that is available for download in the Export License Type page is incomplete.

To retrieve the complete file, get the exported ARX file located in the <ARServerInstallationDirectory>/ARSystem/bin folder. By default, this folder located at /data1/bmc/ARSystem/bin. The name of the exported file is <licenseTypeName>_<exportID>.arx.

After the export is completed, the export log file is created in the <ARServerInstallationDirectory>/ARSystem folder.

Before you begin troubleshooting

• You must have AR System Admin permissions. 
• The Data Import tool must be installed on the server where you want to import the ARX file.
• To import a license type that already exists on the destination system, you must first delete the existing license type on that system. Before you delete the license type, ensure that:
  
  • All the existing license certificates created from the license types have been removed from the contract.
  • The status of the License Certificate is set to Draft.
  • The status of the License Type is set to Offline.
    
    

To import license types

The import is a two-step process. You must first upload the import data, and then validate and import the license type to the system. After the import is complete, the import log file is created in the <ARServerInstallationDirectory>/ARSystem folder.

1. In Mid Tier, in Application Administration Console, select Custom Configuration > Asset Management > Advanced Options > Import and Export License Types, and then click Open.
2. On the AST:LicenseTypeUtility form, click the Import License Type link.
3. Click Add to select the exported file that you want to import.
   
   

4. In the Provide the import details below area, enter the following information:

   Field name	Description
   Short Description	Briefly describe the reason for importing the license types.
   File Name	Enter the name of the file to import.
   User Password	Enter the password of the logged-on user. If the logged-on user does not have a password defined, select the Confirm password is blank check box.
   ImportTool Folder Path	If you installed the Data Import tool to a folder other than the default installation folder, enter the absolute path to that folder. The default installation path, C:\Program Files\BMC Software\ARSystem\dataimporttool, is displayed in the field.

5. Click Upload Import Data.
   The import tool verifies that the license type that you are importing does not already exist on the current system. After the import data is successfully loaded, the Validate and Import button is enabled.

6. To validate and import the uploaded license type data, Click Validate and Import.
   The time required for the import depends on the size of the file. When the file is successfully imported, the license type name is displayed in the License Types on this server list.

   Tip

   Click the Refresh button in the the License Types on this server table to get the updated list of license types and verify whether the imported license type is displayed.

7. If the license type name is not displayed in the list, click View Import Log to view the log entries for the import and verify that it was successful.
   If the import was unsuccessful, repeat the entire import procedure, starting with the data upload.

To import license types in a UNIX environment

Out of the box, BMC does not provide the Data Import tool client installer for UNIX.

• Copy the exported ARX file to the UNIX machine. Then, use the following command from the command prompt to import the license type to the UNIX server:importToolInstallPath\dataImport.bat" -x “destinationServerName” -u “<adminUserName>” -p “<password>” -a <port> -o “<licenseTypearxfileName>” -e 179 -D 3 -l "logFileName.log

To verify successful export or import of the license type

1. Open the exported ARX file using a text editor.
2. Open the Export.log or Import.log file in another instance of the text editor.
   These files are created in the <ARServerInstallationDirectory>/ARSystem folder.
3. Verify that the number of forms in the log file and the ARX file are identical.
   
   

Export History

The License Type Import and Export tool maintains a history of the license types that have been exported. The History page displays the following sections:

This table displays a list the files that were exported. It displays details like the export job short description, the date the ARX file was created, the person who performed the export, and the status of the export. You have the following options:

• Download Exported File — Select a file from the list, and click this button to download the exported file.
• Delete Export History — Click this button to delete all the exported files.

Import History

The License Type Import and Export tool maintains a history of the license types that have been imported. The History page displays the following sections:

The Import history table displays a list of the files that were imported to the system. It displays details like the import job short description, the date of the import, the person who performed the import, and the name of the file that was imported. You have the following options:

• Download Import Log — Select a file from the list, and click this button to download the logs associated with the import of this file.
• View Import Log — Select a file from the list, and click this button to view the logs associated with the import of this file.
• Delete Import History — Click this button to delete the import history log.