Chapter 33 SRA Subcommands

This sections describes the following commands:

• create-sra-instance

• list-sra-instances

• delete-sra-instance

• start-sra-instance

• stop-sra-instance

• change-loguser-password

• get-attribute

• list-attributes

• set-attribute

create-sra-instance

Description

Creates a Gateway, Netlet Proxy or Rewriter Proxy instance.

Syntax

Long Format

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

Short Format

create-sra-instance -u uid -f password-filename --instance-type instance-type --instance-hostname instance-hostname --sraconfig 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.

--instance-type instance-type

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

The following options are not required:

--instance-hostname instance-hostname

Specifies the host name where the instance is located.

--sraconfig sra-config-filename

Specifies the file name of the configuration file.

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 --instance-type instance-type

Short Format

psadmin list-sra-instances -u uid -f password-filename --instance-type 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.

--instance-type instance-type

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

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 --instance-name sra-instance-name --instance-type --instance instance-type --instance-hostname instance-hostname

Short Format

psadmin delete-sra-instance -u uid -f password-filename --instance-name sra-instance-name --instance-type instance-type --instance-hostname 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.

--instance-type instance-type

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

--instance-name sra-instance-name

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

The following options are not required:

--instance-hostname instance-hostname

Specifies the hostname where the instance is located.

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 --instance-name sra-instance-name --instance-type instance-type --instance-hostname instance-hostname

Short Format

psadmin start-sra-instance -u uid -f password-filename --instance-name sra-instance-name --instance-type instance-type --instance-hostname 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.

--instance-type instance-type

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

--instance-name sra-sra-instance-name

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

The following options are not required:

--instance-hostnameinstance-hostname

Specifies the hostname where the instance is located.

stop-sra-instance

Description

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

Syntax

Long Format

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

Short Format

stop-sra-instance -u uid -f password-filename --instance-name sra-instance-name --instance-type instance-type --instance-hostname 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.

--instance-type instance-type

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

--instance-name sra-instance-name

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

The following options are not required:

--instance-hostname instance-hostname

Specifies the hostname where the instance is located.

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 --instance-name sra-instance-name --instance-hostname instance-hostname

Short Format

psadmin change-loguser-password -u uid -f password-filename --newpasswordfile new-password-filename --instance-name sra-instance-name --instance-hostname 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 new-password-filename

Specifies the new name for the password file.

The following options are not required:

--instance-hostname instance-hostname

Specifies the hostname where the instance is located.

sra-watchdog

Description

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

Syntax

Long Format

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

Short Format

psadmin sra-watchdog -u uid -f password-filename--instance-type instance-type [instance-hostname 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.

--instance-type instance-type

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

The following options are not required:

--instance-hostname 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.

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.

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.

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.