APPX Connection Manager For Unix/Linux

The following types of remote APPX clients are supported:

• Windows Client (Win32)
• Character mode client (Unix/Linux Curses)
• APPX ODBC connections (Windows Desktop)

• User Authentication
  • O/S Authentication
  • HT Authentication
  • APPX Authentication

• SSL Support
  • Anonymous
  • Server Certficates
  • Client Certificates

• Environment Specification
  • Inherit from service
  • Explicitly specified

Synopsis - Service Configuration

The appxdsvc service configuration commands are used to create, configure, and remove an instance of an APPX Connection Service.

Configuration - Commands 

The -install command is used to configure a new instance of an APPX Connection Service. Either form of the install command may be used.

The first form of the -install command requires only that a service name be specified.  All other options are optional including the TCP/IP port.  Any option not specified will be configured with an appropriate default value.

The -modify command is used to modify the configuration of an existing Connection Service. The specified options will be updated in the service configuration files. Any options not specified will not be changed.  After updating the configuration files, the -modify command restarts the service.

The -replace command is used to replace an existing Connection Service with a new Connection Service with the same name. The -replace command is effectively the same as a -remove command followed by an -install command.  After updating the configuration files, the -replace command restarts the service.

The -remove command is used to remove an existing Connection Service. The -remove command will remove the configuration files (ini and env) and the corresponding operating system service. If the service is running when the -remove command is executed, the -remove command will first stop the service and then remove the service.

Configuration - Options

This option identifies the method by which the user ID and the password are to be validated when a connection request is received.  If 'OS-User' authentication is specified, the user ID and the password are validated by the connection service using the operating system's authentication service. If 'Appx-User' authentication is specified, the user ID and the password are validated by APPX using the user file which is maintained in APPX System Administration. If 'HT-User(HTFILENAME)' authentication is specified, the user ID and the password are validated by the connection service using the HTFILENAME file is maintained with the htpasswd utility. If you specify 'Appx-User' authentication or HT-User authentication, the user being validated does not need an OS user account.  If no authentication method is specified, the default authentication method is OS-User.

-ServiceType=Login

This option can be used to temporarily disable or "turn off" the connection service.  If set to true, the connection service will still run but it will not accept login requests.

When a file is created, the default permissions set by Unix/Linux are 666 (-rw-rw-rw-). When a directory is created, the default permissions set by Unix/Linux are 777 (drwxrwxrwx). If the umask option is specified, the FILECREATIONMASK value will modify the default permissions of files or directories that are created by the APPX session. The value of FILECREATIONMASK must be a decimal, hex, or octal number whose bits will be used to mask or turn off the corresonding bits of the default file creation permissions. For example, if you want files to be created with permissions of 644, the appropriate FILECREATIONMASK value would be 022 (octal). If you want files to be created with the default permissions of 666, the appropriate FILECREATIONMASK value would be 000 (octal). For more information on umask values, please refer to your Unix/Linux system documentation.