r9 - 2013-12-09 - 06:41:43 - AngelaLiYou are here: TWiki >  Deployment Web > CloudDeployment > DeployingRationalLicenseKeyServerSharedService

Deploying Rational License Key Server shared service

Authors: RayClement, RobbieMinshall, MaryYost
Build basis: IBM Software Delivery and Lifecycle Patterns v1.0

Introduction

IBM Software Delivery and Lifecycle Patterns offering is a set of IBM Rational solutions, based on best practice implementations which are ready to be imported into IBM private cloud offerings including IBM PureApplication System and IBM Workload Deployer. The solutions are delivered in the form of Virtual System Patterns or Shared Services. A shared service (SS) contains all the components of an application. Operations are also included which allow the user to interact with the shared service.

This article is part of a series of IBM Software Delivery and Lifecycle Patterns articles that covers all patterns. The series is conformed by:

  • Deploying IBM Software Delivery and Lifecycle: Overall architecture
  • Deploying IBM Software Delivery and Lifecycle: Rational License Key Server shared service
  • Deploying IBM Software Delivery and Lifecycle: Collaboration Lifecycle Management Pattern v4.0.2
  • Deploying IBM Software Delivery and Lifecycle: Rational Application Developer Pattern 8.5.1 iFix 1

The steps depicted in this article are for IBM PureApplication System but can be applied to IBM Workload Deployer as well.

IBM Rational License Key Server shared service

Rational License Key Server shared service contains the Rational License Key Server application along with seven (7) operations, which allow the user to interact with Rational License Key Server.

Importing the shared service pattern type

Follow these steps to import the shared service pattern type into IBM PureApplication System.

  1. Log into IBM PureApplication System.
  2. Click Workload Console.
  3. Click Cloud > Pattern Types.
  4. Press the green plus (+) symbol to open the Install a pattern type dialog box.
  5. Press Browse to locate the file, which must have an .tgz extension.
  6. Press OK to begin the importing process.

This work will take a while since it has to import the image into IBM PureApplication System.

01-cloud-ptype.png

Cloud > Pattern Type

02-greenplus.png

Green plus (+) symbol

03-InstallAPatternType.png

Install a pattern type dialog box

Accepting the license agreement & enabling the pattern

Once the pattern type is imported, follow these steps to accept the license agreement.
  1. Go to Cloud > Pattern Types.
  2. Look for Rational License Key Server Pattern 1.0.0.0. You can filter out the patterns for a quick search.
  3. Select the pattern and wait for the details in the pane at the right.
  4. You will see License Agreement: Not Accepted [License...] and Status: Not Accepted [Enable All...].
  5. Press [License...].
  6. Once the License agreement dialog box opens, press Accept to accept the agreement.
  7. Once that has processed, press [Enable All...] to enable the pattern type.

04-cloud-ptype-rlks.png

Rational License Key Server Pattern 1.0 before accepting license and enabling

05-license.png

License agreement dialog box

06-allgood.png

License Key Server Pattern 1.0 after accepting license and enabling

Deployment of the pattern

Deployment is the step that provides an instance. To deploy the pattern do the following steps.
  1. Go to Cloud > Shared Services.
  2. Look for License Server Shared Service 1.0.0.0. You can filter out the patterns for a quick search.
  3. Click on License Server Shared Service 1.0.0.0 and wait for the details in the pane at the right.
  4. Click on Deploy.
  5. The Configure and deploy a shared service dialog box will open.
  6. Press OK on the Configure and deploy a shared service dialog box to open the Deploy Virtual Application dialog box.
  7. On the Deploy Virtual Application dialog box, you may configure the Virtual Application.
  8. Once done configuring, press OK to start the deployment of the shared service.
07-cloud-ss.png

Cloud > Shared Services

08-cloud-ss-rlks.png

License Server Shared Service

09-deploy.png

Deploy button in upper right

10-ChooseAndConfig.png

Configure and deploy a shared service dialog box

11-DeployVirtualApplication.png

Deploy Virtual Application dialog box

Management of the instance

Once the shared service instance is deployed, follow these steps to manage the shared service.
  1. Go to Instances > Shared Services.
  2. Look for License Server Shared Service 1.0.0.0. You can filter out the patterns for a quick search.
  3. Select the pattern and wait for the details in the pane at the right.
  4. Press Manage.
  5. Once a new windows opens, you will see the Virtual Application Console.

12-instances-ss.png

Instances > Shared Services

13-instances-ss-rlks.png

License Server Shared Service instance

14-manageButton.png

Manage button in upper right

15-vac.png

Virtual Application Console window

Operations

The shared service contains seven (7) operations:
  • Start RLKS Instance
  • Stop RLKS Instance
  • Add License File
  • Activate License File
  • Delete License File
  • Get a List of License Files
  • Get Status

  1. Once in the Virtual Application Console, press the Operations tab.
  2. Press SS.RLKS and wait for the details in the pane at the right.
  3. Press the twisty to expand an operation.
  4. If parameters are required, they will appear with a red asterisks before the parameter name.
  5. Press Submit to launch an operation.
  6. Results of operations appear in the Operation Execution Results pane at the bottom.

16-operations.png

Operations tab

17-operations-rlks.png

Rational License Key Server shared service operations

Start RLKS Instance

This operation has no parameters. The operation starts Rational License Key Server. It does not start the shared service instance.

18-StartRLKS.png

Start RLKS operation with result

Stop RLKS Instance

This operation has no parameters. The operation stops Rational License Key Server. It does not stop the shared service instance.

19-StopRLKS.png

Stop RLKS operation with result

Add License File

This operation requires two parameters. Source License File is the license file to upload.
  1. Press Edit to open the Select File dialog box.
  2. On the Local tab, press Browse to open the Choose File to Upload dialog box. (Even though the HTTP/HTTPS tab appears on the Select File dialog box, HTTP/HTTPS transfer is not supported.)
  3. Once the file is located press OK on both the Choose File to Upload dialog box and then the Select File dialog box.
Destination File Name is the name to save the license file as on the shared service. This name is the only reference to license files once on the shared service. Only use alphanumeric characters as special characters can cause issues during file upload or server start.

20-AddFile.png

Add License File operation with result

21-SelectFile.png

Select File dialog box

22-ChooseFileToUpload.png

Choose File to Upload dialog box

Activate License File

This operation requires one parameter. File Name is the name of the file saved on the shared service to activate.

23-ActivateFile.png

Activate License File with result

Delete License File

This operation requires one parameter. File Name is the name of the file saved on the shared service to delete. The active license file cannot be deleted.

24-DeleteFile.png

Delete License File operation with result

Get a List of License Files

This operation has no parameters. It will return a list of license files saved on the shared service.

25-GetList.png

Get a List of License Files operation with result

Get Status

This operation has no parameters. It returns a simple message stating if Rational License Key Server is running. Additional details and the log file from RLKS (lmgrd.log) are printed in trace.log.

26-GetStatus.png

Get Status operation with result

Viewing the logs

  1. Once in the Virtual Application Console, press the Logging tab.
  2. Press the twisty on the name of the shared service instance. It will begin with SS.
  3. Press the twisty on IWD Agent.
  4. Press the twisty which ends in .RLKS.
  5. Press trace.log and wait for the details in the pane at the right.

27-Logs.png

Logging tab

28-SS-iwdagent-rlks-trace.png trace.log

Troubleshooting

Non-alphanumeric characters in license file name

Only use alphanumeric characters in the name of the license file. Special characters may cause failure during file upload or during server start.

HTTP file upload fails when adding a license file

When adding a license file, only Local file transfer is allowed. Even though the HTTP/HTTPS tab appears on the Select File dialog box, HTTP/HTTPS file transfer will fail.

Cached values cause file upload to fail

The Source License File parameter of the Add License File operation is populated with a temporary path as part of the file upload process. It is only valid for one execution of the Add License File operation. Do not use the cached value for subsequent execution of the Add License File operation.

How to see the RLKS log file (lmgrd.log)

The Get Status operation will print the contents of lmgrd.log in trace.log. See Viewing the logs above for steps to view trace.log.

Related topics: Deployment web home, Deployment web home

External links:

Additional contributors: TWikiUser, TWikiUser

Topic attachments
I Attachment Action Size Date Who Comment
Pngpng 01-cloud-ptype.png manage 132.2 K 2013-06-25 - 21:50 RaymondClement  
Pngpng 02-greenplus.png manage 25.0 K 2013-06-25 - 21:51 RaymondClement  
Pngpng 03-InstallAPatternType.png manage 31.3 K 2013-06-25 - 21:58 RaymondClement  
Pngpng 04-cloud-ptype-rlks.png manage 51.6 K 2013-06-25 - 21:58 RaymondClement  
Pngpng 05-license.png manage 55.8 K 2013-06-25 - 21:59 RaymondClement  
Pngpng 06-allgood.png manage 33.4 K 2013-06-25 - 21:59 RaymondClement  
Pngpng 07-cloud-ss.png manage 147.2 K 2013-06-25 - 22:00 RaymondClement  
Pngpng 08-cloud-ss-rlks.png manage 33.4 K 2013-06-25 - 22:00 RaymondClement  
Pngpng 09-deploy.png manage 45.7 K 2013-06-25 - 22:00 RaymondClement  
Pngpng 10-ChooseAndConfig.png manage 33.9 K 2013-06-25 - 22:00 RaymondClement  
Pngpng 11-DeployVirtualApplication.png manage 33.6 K 2013-06-25 - 22:01 RaymondClement  
Pngpng 12-instances-ss.png manage 172.0 K 2013-06-25 - 22:01 RaymondClement  
Pngpng 13-instances-ss-rlks.png manage 79.0 K 2013-06-25 - 22:01 RaymondClement  
Pngpng 14-manageButton.png manage 80.6 K 2013-06-25 - 22:01 RaymondClement  
Pngpng 15-vac.png manage 24.4 K 2013-06-25 - 22:02 RaymondClement  
Pngpng 16-operations.png manage 35.2 K 2013-06-25 - 22:02 RaymondClement  
Pngpng 17-operations-rlks.png manage 26.1 K 2013-06-25 - 22:02 RaymondClement  
Pngpng 18-StartRLKS.png manage 33.8 K 2013-06-25 - 22:02 RaymondClement  
Pngpng 19-StopRLKS.png manage 33.7 K 2013-06-25 - 22:02 RaymondClement  
Pngpng 20-AddFile.png manage 37.7 K 2013-06-25 - 22:03 RaymondClement  
Pngpng 21-SelectFile.png manage 30.8 K 2013-07-09 - 20:45 RaymondClement  
Pngpng 22-ChooseFileToUpload.png manage 108.6 K 2013-07-09 - 20:45 RaymondClement  
Pngpng 23-ActivateFile.png manage 36.0 K 2013-07-09 - 20:45 RaymondClement  
Pngpng 24-DeleteFile.png manage 34.2 K 2013-06-25 - 22:03 RaymondClement  
Pngpng 25-GetList.png manage 34.4 K 2013-06-25 - 22:04 RaymondClement  
Pngpng 26-GetStatus.png manage 33.2 K 2013-06-25 - 22:04 RaymondClement  
Pngpng 27-Logs.png manage 15.5 K 2013-06-25 - 22:04 RaymondClement  
Pngpng 28-SS-iwdagent-rlks-trace.png manage 140.6 K 2013-06-25 - 22:04 RaymondClement  
Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r9 < r8 < r7 < r6 < r5 | More topic actions
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Ideas, requests, problems regarding the Deployment wiki? Create a new task in the RTC Deployment wiki project