Chapter 14 Portal Server Secure Remote Acess Subcommands

This chapter describes the following commands:

• psadmin create-sra-instance

• psadmin list-sra-instances

• psadmin delete-sra-instance

• psadmin start-sra-instance

• psadmin stop-sra-instance

• psadmin change-loguser-password

• psadmin sra-watchdog

• psadmin get-attribute

• psadmin list-attributes

• psadmin set-attribute

psadmin create-sra-instance

Description

Creates a Gateway, Netlet Proxy or Rewriter Proxy instance.

Syntax

Long Format

create-sra-instance --adminuser uid --passwordfile password-filename --type instance-type --hostname instance-hostname --sraconfig sra-config-filename

Short Format

create-sra-instance -u uid -f password-filename -t instance-type -h instance-hostname -S sra-config-filename

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[--passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t] instance-type

Specifies the type of the SRA instance. Enter: gateway, nlproxy, or rwproxy.

The following options are not required:

[--hostname | -h] instance-hostname

Specifies the host name where the instance is located.

[--sraconfig |-S] sra-config-filename

Specifies the file name of the configuration file.

psadmin list-sra-instances

Description

Lists all instances of Gateway, Netlet Proxy, and Rewriter Proxy.

Syntax

Long Format

psadmin list-sra-instances --adminuser uid --passwordfile password-filename --type instance-type

Short Format

psadmin list-sra-instances -u uid -f password-filename -t instance-type

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[--passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t] instance-type

Specifies the type of Secure Remote Access instance. Enter: gateway, nlproxy, or rwproxy.

psadmin delete-sra-instance

Description

Removes a Gateway, Netlet Proxy, or Rewriter Proxy instance.

Syntax

Long Format

psadmin delete-sra-instance --adminuser uid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

Short Format

psadmin delete-sra-instance -u uid -f password-filename -N sra-instance-name -t instance-type -h instance-hostname

Options

The following options are required:

[--adminuser | -u]uid

Specifies the administrator's distinguished name (dn) or user ID.

[--passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t]instance-type

Specifies the type of the Secure Remote Access instance. Enter: gateway, nlproxy, or rwproxy.

[--name | -N]sra-instance-name

Lists the instance names for Gateway, Netlet Proxy and Rewriter Proxy.

The following options are not required:

[--hostname | -h] instance-hostname

Specifies the hostname where the instance is located.

psadmin start-sra-instance

Description

Starts a Gateway, Netlet Proxy, or Rewriter Proxy instance.

Syntax

Long Format

psadmin start-sra-instance --adminuser uid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

Short Format

psadmin start-sra-instance -u uid -f password-filename -N sra-instance-name -t instance-type -h instance-hostname

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[--passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t]instance-type

Specifies the type of the SRA instance. Enter: gateway, nlproxy, or rwproxy.

[--name | -N]sra-instance-name

Lists the instance names for Gateway, Netlet Proxy and Rewriter Proxy.

The following options are not required:

[--hostname | -h]instance-hostname

Specifies the hostname where the instance is located.

psadmin stop-sra-instance

Description

Stops a Gateway, Netlet Proxy, or Rewriter Proxy instance.

Syntax

Long Format

stop-sra-instance --adminuser uid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

Short Format

stop-sra-instance -u uid -f password-filename -N sra-instance-name -t instance-type -h instance-hostname

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[-passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t] instance-type

Specifies the type of Secure Remote Access instance. Enter: gateway, nlproxy, or rwproxy.

[--name | -N] sra-instance-name

Lists the instance names for Gateway, Netlet Proxy and Rewriter Proxy.

The following options are not required:

[--hostname | -h] instance-hostname

Specifies the hostname where the instance is located.

psadmin change-loguser-password

Description

Changes the Gateway logging user password.

Syntax

Long Format

psadmin change-loguser-password --adminuser uid --passwordfile password-filename --newpasswordfile new-password-filename --name sra-instance-name --hostname instance-hostname

Short Format

psadmin change-loguser-password -u uid -f password-filename -F new-password-filename -N sra-instance-name -h instance-hostname

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[-passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

--newpasswordfile | -F] new-password-filename

Specifies the new name for the password file.

The following options are not required:

[--hostname | -h] instance-hostname

Specifies the hostname where the instance is located.

psadmin sra-watchdog

Description

Configures watchdog for the Gateway, Netlet, Netfile, Proxylet, and Accesslist.

Syntax

Long Format

psadmin sra-watchdog --adminuser uid --passwordfile password-filename --type instance-type [--hostname instance-hostname ]on|off

Short Format

psadmin sra-watchdog -u uid -f password-filename -t instance-type [-h instance-hostname] on|off

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name (dn) or user ID.

[-passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--type | -t] instance-type

Specifies the type of the SRA instance. Enter: gateway, nlproxy, or rwproxy.

The following options are not required:

[--hostname | -h] instance-hostname

Specifies the hostname where the instance is located.

The following operand is available:

on|off

Specifies to switch watchdog on or off for the particular instance.

psadmin get-attribute

Description

Gets an attribute for a Portal Server Secure Remote Access component: Gateway, Netlet, Netfile, Proxylet, or Accesslist. If the component is gateway, use the --gateway-profile gateway-profile-filename option to specify the name to obtain the value of the attribute.

psadmin list-attributes

Description

Lists all attributes for a Portal Server Secure Remote Access component: Gateway, Netlet, Netfile, Proxylet, or Accesslist. If the component is gateway, use the --gateway-profile gateway-profile-filename option to specify the name to obtain the value of the attribute.

psadmin set-attribute

Description

Sets an attribute value for a Portal Server Secure Remote Access component: Gateway, Netlet, Netfile, Proxylet, or Accesslist. If the component is gateway, use the --gateway-profile gateway-profile-filename option to specify the name to obtain the value of the attribute.