LicensingServiceAdmin command reference

Run the LicensingServiceAdmin command to manage activation and deactivation of IBM® InfoSphere® DataStage® editions and feature packs after InfoSphere DataStage is installed.

Purpose

If you are entitled to certain InfoSphere DataStage editions or feature packs after you run the IBM InfoSphere Information Server installation program, run this command to activate the newly entitled items. If you no longer have entitlements for the items, run this command to deactivate them.

If you no longer have entitlement to any InfoSphere DataStage edition or feature, you must remove InfoSphere DataStage by using the InfoSphere Information Server software removal program. You cannot use the tool to deactivate all InfoSphere DataStage editions and features.

If you have implemented IBM WebSphere® Application Server clustering within your installation, the command is located on the computer that hosts the WebSphere Application Server Deployment Manager. If you have not implemented clustering, the command is located on the services tier computer.

The command can be found on the services tier computer, in the ASBServer/bin subdirectory of the directory in which InfoSphere Information Server is installed. For example:

/opt/IBM/InformationServer/ASBServer/bin
C:\IBM\InformationServer\ASBServer\bin

To use the tool, log in by using an account that has execution permission for the tools in this directory.

Command syntax

Linux cue graphic UNIX cue graphic LicensingServiceAdmin.sh [-help] [-authfile credentials_filename| [-user user] [-password password]] [-set_features featurecodes] [-list_features]

Windows cue graphic LicensingServiceAdmin [-help] [-user user] [-password password] [-authfile credentials_filename| [-set_features featurecodes] [-list_features]

Parameters

help

Displays usage information for the tool.

authfile credentials_filename

The name of the credentials file that contains the user ID and password of a user that has suite administrator authority. You can use this option in place of the user and password options.

user user

The name of a user that has suite administrator authority. You can use the -user option or its short form: -u.

password password

The password for the user. You can use the -password option or its short form: -p.

set_features featurecodes

Specifies a list of InfoSphere DataStage editions and feature packs to activate. The items are specified as a comma-separated list of codes. The following table describes valid feature codes. Feature codes are not case sensitive.

Table 1. Feature codes for LicensingServiceAdmin
Feature code	Description
DS	Activates IBM InfoSphere DataStage
DSServer	Activates IBM InfoSphere DataStage Server
DSMVS	Activates IBM InfoSphere DataStage MVS Edition
SAS	Activates IBM InfoSphere DataStage Pack for SAS
BalOpt	Activates IBM InfoSphere DataStage Balanced Optimization

Each time you run the command, specify the feature codes for all editions and feature packs to activate. Include any editions and feature packs that are already activated, that you want to remain activated. Any editions and feature packs that you do not listed in the command are deactivated.

If you are entitled to both IBM InfoSphere DataStage Server and IBM InfoSphere DataStage from DataStage Server Trade Up, specify the DS feature code but not the DSServer feature code.

You can use the -set_features option or its short form: -sf.

list_features

Causes LicensingServiceAdmin to output a list of activated editions and feature packs. If the -set_features option is also specified, the LicensingServiceAdmin command activates the specified editions and feature packs and then outputs the list. The list is output to stdout.

You can use the -list_features option or its short form: -lf.

The following command activates all editions and feature packs, and lists the activated items on a Linux or UNIX computer:

/opt/IBM/InformationServer/ASBServer/bin/LicensingServiceAdmin.sh -u myadmin -p myadminpwd -lf -sf DS,DSMVS,BalOpt,SAS,DSServer