tacmd configurePortalServer

Use the tacmd configurePortalServer command to configure a user-defined portal server data source. If the data source already exists, use this command to change the configuration. If the data source does not exist, it is created by this command. You can also use this command to remove a data source. This command can only be run from a Tivoli Enterprise™ Portal Server installation.

Note:

System defined data sources cannot be edited with this command. Only user-defined data sources can be edited with this command.

CLI syntax

tacmd configurePortalServer {-s|--dataSource} datasource
{-p|--property|--properties} name=value ...
[{-d|--directory} install_dir]

tacmd configurePortalServer {-s|--dataSource} datasource
{-r|--remove}
[{-d|--directory} install_dir]

tacmd configurePortalServer {-s|--dataSource} datasource
{-v|--view}
[{-d|--directory} install_dir]

where:

-s|--dataSource datasource: The name of a new or existing data source.
-r|--remove: Removes the named data source.
-v|--view: Displays the configuration parameters for an existing data source. Run the command against an existing data source to identify configuration parameters that you can edit or to determine the configuration parameters for a new data source of the same type.
Passwords displayed by this parameter are encrypted.
-p|--property|--properties name=value ...: A list of property names and values required to configure the data source. The list can be different for each data source type but usually includes at least user ID (key name UID) and password (key name PWD). Property values are encrypted before being stored to the configuration file or the Windows® Registry.
-d|--directory install_dir: The directory where the portal server is installed.

CLI example

The following example modifies the DSUSER1 data source with user ID db2user and password db2password. The DSUSER1 data source is created if it does not already exist.

   tacmd configurePortalServer -s DSUSER1 -p UID=db2user PWD=db2password

The following example displays the configuration settings for the DSUSER1 data source:

   tacmd configurePortalServer -s DSUSER1 -v

The following output is displayed:

   DSN=DSUSER1
   UID=TEPS
   PWD={AES256:keyfile:a}HW0LxUxCJ5tj9biXUWhCIQ==
   CONNECTION_LIMIT=32

Return values

See Table 2.

Note:

To verify that the data source was properly configured, log on to the portal server, click Query in the main toolbar to open the Query editor, then click New Query to open the Create Query window. The name of the ODBC data source you configured should be in the Data Sources list.