Difference: APPXLoginManagerForUnixLinux (45 vs. 46)

Revision 462008-07-02 - JoeOrtagus

Line: 1 to 1
 
META TOPICPARENT name="APPXConnectionManager"

APPX Connection Manager For Unix/Linux

This page describes how to install the APPX Connection Manager command and how to use it to install, configure, and manage APPX Connection Services on Unix/Linux systems.
Line: 34 to 34
 
    • Service configuration
    • Client request
Changed:
<
<

Installing the APPX Connection Manager Command ( appxloginmgr)

The APPX Login Manager ( appxloginmgr) command is installed automatically when you install APPX on your system. The installer sets the necessary owner and group permissions for the appxloginmgr command. So, there is nothing additional that you need to do to install the appxloginmgr command. However, after you install APPX, you will need to run the appxloginmgr command to configure and start an instance of the APPX Connection Service before any remote client connections may be established.
>
>

Installing the APPX Connection Manager Command ( appxLoginMgr)

The APPX Login Manager ( appxLoginMgr) command is installed automatically when you install APPX on your system. The installer sets the necessary owner and group permissions for the appxLoginMgr command. So, there is nothing additional that you need to do to install the appxLoginMgr command. However, after you install APPX, you will need to run the appxLoginMgr command to configure and start an instance of the APPX Connection Service before any remote client connections may be established.
 
Changed:
<
<
The appxloginmgr command is installed into the "tools" subdirectory of the directory where you installed APPX. So, if you installed APPX in "/usr/local/appx", the full pathname of the appxloginmgr command will be "/usr/local/appx/tools/appxloginmgr".
>
>
The appxLoginMgr command is installed into the "tools" subdirectory of the directory where you installed APPX. So, if you installed APPX in "/usr/local/appx", the full pathname of the appxLoginMgr command will be "/usr/local/appx/tools/appxLoginMgr".
 
Changed:
<
<
The appxloginmgr command must run with the permissions of the root user because it will be spawning appx processes running as each logged in user. Therefore, the owner of the appxloginmgr command should be the root user and the SUID bit should be set so that the appxloginmgr command can be run by users other than root but still be run with the permissions of root.
>
>
The appxLoginMgr command must run with the permissions of the root user because it will be spawning appx processes running as each logged in user. Therefore, the owner of the appxLoginMgr command should be the root user and the SUID bit should be set so that the appxLoginMgr command can be run by users other than root but still be run with the permissions of root.
 
Changed:
<
<
In the event that it is necessary to reset the permissions on the appxloginmgr command, the following commands can be run by the root user to set the necessary owner and group permissions for the appxloginmgr command.
>
>
In the event that it is necessary to reset the permissions on the appxLoginMgr command, the following commands can be run by the root user to set the necessary owner and group permissions for the appxLoginMgr command.
 

cd /usr/local/appx/tools

Changed:
<
<
chown root appxloginmgr chgrp appxgrp appxloginmgr chmod 4775 appxloginmgr
>
>
chown root appxLoginMgr chgrp appxgrp appxLoginMgr chmod 4775 appxLoginMgr
 
Changed:
<
<
You can check the permissions of the appxloginmgr command by running the following command:
>
>
You can check the permissions of the appxLoginMgr command by running the following command:
 

Changed:
<
<
ls -l appxloginmgr
>
>
ls -l appxLoginMgr
 

The recommended permissions should be as follows:


Changed:
<
<
-rwsrwxr-x 1 root root 636843 Jul 11 07:31 appxloginmgr
>
>
-rwsrwxr-x 1 root root 636843 Jul 11 07:31 appxLoginMgr
 

Creating and Configuring an APPX Connection Service

Changed:
<
<
On Unix/Linux systems, an instance of the APPX Connection Service is initially created, configured, and started by running the appxloginmgr command with the -install option. At least one appropriately configured instance of the APPX Connection Service must be created, configured, and started before a remote APPX Client can initiate an APPX session. You may create, configure, and start as many different instances of the APPX Connection Service as you desire. However, each concurrently running instance must be configured to listen for connection requests on a different TCP/IP port.
>
>
On Unix/Linux systems, an instance of the APPX Connection Service is initially created, configured, and started by running the appxLoginMgr command with the -install option. At least one appropriately configured instance of the APPX Connection Service must be created, configured, and started before a remote APPX Client can initiate an APPX session. You may create, configure, and start as many different instances of the APPX Connection Service as you desire. However, each concurrently running instance must be configured to listen for connection requests on a different TCP/IP port.
 

Creating a Connection Service

Before remote clients can connect to an APPX system, at least one instance of an APPX Connection Service must be configured and started.

Changed:
<
<
The -install option of the appxloginmgr command is used to initially create, configure, and start an instance of the APPX Connection Service. The following steps are performed:
>
>
The -install option of the appxLoginMgr command is used to initially create, configure, and start an instance of the APPX Connection Service. The following steps are performed:
 
  1. A configuration file (ini) is created
  2. An environment file (env) is created
  3. A service is created, including required init files and links. ( On Red Hat, /etc/init.d/ )
  4. The service is started
Changed:
<
<
For compete information on using the -install option of the appxloginmgr command, please refer to the usage section of this page.
>
>
For compete information on using the -install option of the appxLoginMgr command, please refer to the usage section of this page.
 

The Name of the Service

Line: 83 to 83
 

Changing a Connection Service

Two methods are available for modifying an existing instance of an APPX Connection Service.
Changed:
<
<

Method 1 - The Connection Manager Command (appxdsvc)

The -modify command and the - replace command of the appxdsvc connection manager can be used to modify or replace a previously configured instance of the APPX Connection Service. These options update the existing APPX Connection Service configuration files (ini and env) with the options specified.
>
>

Method 1 - The APPX Login Manager Command (appxLoginMgr)

The -modify command and the - replace command of the appxLoginMgr tool can be used to modify or replace a previously configured instance of the APPX Login Manager. These options update the existing APPX Login Manager daemon configuration files (ini and env) with the options specified.
 

Method 2 - Text Editor

Changed:
<
<
A text editor can be used to directly edit the APPX Connection Service configuration files (ini and env). The configuration files include comments to help you make the desired changes. If you use this method to modify an existing configuration, you should exercise care to ensure that the syntax is correct. The preferred method for modifying a connection service is with Medhod 1 above.

Managing an APPX Connection Service

>
>
A text editor can be used to directly edit the APPX Login Manager daemon configuration files (ini and env). The configuration files include comments to help you make the desired changes. If you use this method to modify an existing configuration, you should exercise care to ensure that the syntax is correct. The preferred method for modifying an APPX Login Manager daemon is with Medhod 1 above.

Managing an APPX Login Manager Daemon

 Two methods are available for managing an existing instance of the APPX Connection Service.

Method 1 - appxLoginMgr command

Line: 112 to 112
 

Synopsis - Service Configuration

The appxLoginMgr service configuration commands are used to create, configure, and remove an instance of an APPX Connection Service.
Changed:
<
<
appxloginmgr -install -SockPort=[TCP-Port] [options]... [VARIABLE=VALUE]...
>
>
appxLoginMgr -install -SockPort=[TCP-Port] [options]... [VARIABLE=VALUE]...
 
Changed:
<
<
appxloginmgr -modify -serviceName=SERVICENAME [options]... [VARIABLE=VALUE]...
>
>
appxLoginMgr -modify -serviceName=SERVICENAME [options]... [VARIABLE=VALUE]...
 
Changed:
<
<
appxloginmgr -replace -serviceName=SERVICENAME [options]... [VARIABLE=VALUE]...
>
>
appxLoginMgr -replace -serviceName=SERVICENAME [options]... [VARIABLE=VALUE]...
 
Changed:
<
<
appxloginmgr -remove -serviceName=SERVICENAME
>
>
appxLoginMgr -remove -serviceName=SERVICENAME
 

Configuration - Commands

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback