EMC ® ApplicationXtender ®

Web Access
6.5

Administrator’s Quick Reference

P/N 300-010-572 A01

EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 1994-2010 EMC Corporation. All rights reserved.
Published March 2010
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO REPRESENTATIONS
OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
Introduction
This quick reference provides setup information for ApplicationXtender Web Access (AppXtender
Web) administrators. The quick reference does not take the place of the ApplicationXtender Web
Access Administrator’s Guide.

Planning AppXtender Web Deployment

AppXtender Web is closely integrated with other components of the ApplicationXtender
(AppXtender) system, and depends on those components in several ways. For this reason, prior to
installing the AppXtender Web Server software and the AppXtender Rendering Server software, you
must install ApplicationXtender Administrator (AppXtender Admin), and configure AppXtender
Web Server and AppXtender Rendering Server settings. There should be only one AppXtender
Admin per data source group. However, you can install multiple AppXtender Rendering Servers to
perform file rendering services for your AppXtender Web Server.

To set up your AppXtender Web system:

1. Perform the following preparation steps:
• Prepare the AppXtender Content Management environment.
• Prepare the AppXtender Web.NET Server computer.
• Prepare the AppXtender Rendering Server computer.
For information, refer to the “Planning” chapter in the ApplicationXtender Web Access
Administrator’s Guide.

ApplicationXtender Web Access Administrator’s Quick Reference 3

2. Configure ApplicationXtender Web Access, AppXtender Rendering Server, and AppXtender
Web Services settings in AppXtender Admin. This quick reference provides brief instructions
on this step. For more information, refer to:
• “Configuring ApplicationXtender Web Access” and “Configuring AppXtender Rendering
Server” in the ApplicationXtender Web Access Administrator’s Guide
• “Configuring AppXtender Web Services” in the ApplicationXtender Web Services Administrator’s
Guide
3. Install components:
• Install AppXtender Web.NET Server components on the AppXtender Web Server computer.
• Install AppXtender Rendering Server components on the AppXtender Rendering Server
computer(s).
For information, refer to the “Installing” chapter in the ApplicationXtender Web Access
Administrator’s Guide.
4. Register AppXtender Web components with the database:
• Run AppXtender Component Registration for AppXtender Web.NET Server on the
AppXtender Web.NET Server computer.
• Run AppXtender Component Registration for AppXtender Rendering Server on the
AppXtender Rendering Server computer.
5. Test AppXtender Web by connecting to the AppXtender Web website. By default, the URL for an
AppXtender Web.NET server is as follows:
http://<Server>/<alias>/login.aspx
• The placeholder <Server> represents the IP address or domain of the IIS server.
• The placeholder <alias> represents the AppXtender Web.NET server alias you specified
when installing AppXtender Web.NET. By default the alias is AppXtender.
For more information on use of AppXtender Web, refer to the ApplicationXtender Web Access
User’s Guide.

Required AppXtender Web Server Configuration

You must configure the User Account and Session Cache Path settings under the AppXtender Web >
Setup node before you install and register the AppXtender Web Server. If users will be using email
options in AppXtender Web, you must also configure an administrative email address for the server.

Setting the Session Cache Path for AppXtender Web

The AppXtender Web Server session cache stores AppXtender Web user session data for active
AppXtender Web sessions. Session data includes authorization and authentication data for user
sessions and user session context for operations a user is engaged in. The session cache path should
be a local path.
1. In AppXtender Admin, expand the AppXtender Web node in the left pane.

4 ApplicationXtender Web Access Administrator’s Quick Reference

2. Select the Setup node. AppXtender Web Setup options appear in the right pane of the window.
3. In the Session Cache Path section, click the Browse button to the right of the text box. The Local
Path Setup dialog box appears.
4. From the Path list, select the appropriate path for the cache used by AppXtender Web Server, or
click Browse to browse for a new path.
• If the correct credentials are not already selected, select the appropriate credentials option
for the impersonation account that is used when accessing the selected path. By default,
global credentials are set for a path.
• If the selected path already exists in the AppXtender Admin Paths table, a credentials option
may already have been selected. If you change the credentials for a path here, the change
affects the credentials used for that path in any location where it is used, and the change is
reflected in the record for that path in the AppXtender Admin Paths table.
5. Click OK to accept the path configuration and set the session cache path. The path appears
in the Session Cache Path text box.
6. Select File > Save Changes to save all changes since the last save.

Configuring the AppXtender Web Server Global Impersonation

Account

Whenever global credentials are configured for a resource, AppXtender Web uses the global
credentials you enter here to access the resource. Resources for which you can configure resources
include remote and server resources on Windows, such as the AppXtender Web Session Cache, the
data sources through which AppXtender Web connects to databases, DiskXtender (DX) document
servers, and Centera document servers. The global account is also used for impersonation if needed
when accessing the registry or the License Server. After you have created a AppXtender Web
Impersonation account, you must grant appropriate security privileges to it. For more information on
account rights, refer to the ApplicationXtender Web Access Administrator’s Guide.
You can configure credentials settings elsewhere in AppXtender Admin to override the use of the
global account for impersonation. However, any accounts that are used to provide credentials
as an impersonation context for AppXtender Web resources must have the rights to access to
those resources. To make sure you have access to all resources, the easiest approach is to use the
AppXtender Web global account to impersonate for all AppXtender Web resources, and make sure
that this account has access to all resources and appropriate rights.
It is recommended that the AppXtender Web Impersonation account be created as a domain account.
After you have added the domain account, add it to the Local Administrators group, and then
provide the Local Administrators group with Advanced Rights. By adding the domain account to the
local AppXtender Web Server, you can ensure that only one account is used.

To configure the global AppXtender Web impersonation account:

1. Under the AppXtender Web node in AppXtender Admin, select the Setup node.
2. In the Global Credentials Account section, click the Setup button. The Enter user credentials
dialog box appears.

ApplicationXtender Web Access Administrator’s Quick Reference 5

3. In the Domain\User text box, enter the full name for the user account that should be used as the
global impersonation account, using the following syntax: domain_name\username.
4. In the Password text box, enter the password for the account.
5. In the Confirm Password text box, re-enter the same password to confirm the spelling.
6. Click OK to close the dialog box and return to the Setup pane.
7. Select File > Save Changes to save changes.

Editing AppXtender Web Administrator E-Mail Information

The AppXtender Web Administrator E-Mail Information section of the E-Mail Setup page allows
you to designate the AppXtender Web Administrator Display Name and the administrator’s e-mail
address. This information is used as the “from:” line in messages sent from the system to users for
registration, and is the default e-mail address used for any mail-related error messages.
1. Expand the AppXtender Web >E-Mail node in AppXtender Admin. When the E-Mail node is
expanded the Setup subnode is automatically selected and the E-Mail Setup pane appears.
2. Click the Add button. The E-Mail Address dialog box appears.
3. In the Display Name text box, enter the name you wish to display in the From field of the email.
4. In the E-mail Address text box, enter the administrator’s e-mail address, in SMTP format
([email protected]).
5. Click the Save And Close button to apply your changes.
6. Select File > Save Changes to save changes.

Required AppXtender Rendering Server Configuration

Prior to installing the AppXtender Rendering Server and registering it with AppXtender Admin,
you must set up a login account and configure the cache location and database to be used by the
AppXtender Rendering Server. AppXtender Rendering Server settings are configured in AppXtender
Admin.

Setting the AppXtender Rendering Server User Credentials

The AppXtender Rendering Server User Name setting is used whenever the AppXtender Rendering
Server requires a security context to access a resource. The user name you enter here must have
access to any resources the AppXtender Rendering Server needs to access in order to fulfill rendering
requests. For example, the account you configure must have appropriate access rights to the
Rendering Cache Location.
1. In AppXtender Admin, expand the Servers node in the left pane.
2. Select the Rendering Server node. AppXtender Rendering Server setup options appear in the
right pane of the window.

6 ApplicationXtender Web Access Administrator’s Quick Reference

3. In the Login section, select the Setup button to the right of the Account text box. The Enter
user credentials dialog box appears.
4. In the User Name text box, enter the full name for the user account that should be used as
the global impersonation account for the rendering cache path, using the following syntax:
domain_name\username.
5. In the Password text box, enter the password for the account.
6. In the Confirm Password text box, re-enter the same password to confirm the spelling.
7. Select OK to close the dialog box and return to the AppXtender Rendering Server setup options.
8. Select File > Save Changes to save changes.

Configuring AppXtender Rendering Server Cache Settings

The AppXtender Rendering Server Cache Location settings dictate the path where rendered files
are cached for repeated access. Because the Cache Location must be available to all AppXtender
Rendering Server computers, the AppXtender Rendering Server Cache Location must be a UNC path.
The data source for the AppXtender Rendering Server database points to a database containing
tables used to manage the rendering queue for the AppXtender Rendering Server. To simplify your
configuration process, you can set up a data source pointing to an existing ApplicationXtender
Content Management database and add the AppXtender Rendering Server queue tables to that
database. If you anticipate heavy rendering queue traffic, however, you may want to set up a database
specifically for rendering queue management. The same databases and database versions supported
for the ApplicationXtender Content Management database can be used for the AppXtender
Rendering Server database. You can also use a schema user with the database if needed. For more
information on supported databases, creating a database, or using a schema with your data source,
refer to the ApplicationXtender Core Components Administrator’s Guide.

1. In AppXtender Admin, expand the Servers node in the left pane.

2. Select the AppXtender Rendering Server node. AppXtender Rendering Server setup options
appear in the right pane of the window.
3. To configure the location of the AppXtender Rendering Server cache, select the Browse button to
the right of the Location text box in the Cache section. The Browse For Folder dialog box appears.
4. You have the following choices:
• To use an existing directory for the AppXtender Rendering Server cache, browse for and
select that directory, and click OK.
• To create a new directory for the AppXtender Rendering Server cache, browse to the folder
below which the directory should be located and select that directory, then click New Folder.
Rename the new folder as appropriate, verifying that the name is reflected in the Folder text
box, then click OK. A message displays prompting you to configure the new path under
the Paths section in AppXtender Admin. For more information on configuring paths, refer
to the “Using ApplicationXtender Administrator” chapter of the ApplicationXtender Core
Components Administrator’s Guide.
5. To configure a data source to be used to hold the AppXtender Rendering Server rendering job
queue information, click the Select button to the right of the Database text box in the Cache

ApplicationXtender Web Access Administrator’s Quick Reference 7

 section. You can either select an existing database or create a new database specifically for this
purpose. When you connect to the data source for the first time from this settings page, the
AppXtender Rendering Server tables are created in the database. For more information on
creating databases and configuring data sources, refer to the ApplicationXtender Core Components
Administrator’s Guide. For information on locating existing data sources, refer to the “Managing
Data Sources” chapter in the ApplicationXtender Web Access Administrator’s Guide.

8 ApplicationXtender Web Access Administrator’s Quick Reference

ApplicationXtender Web Access Administrator Toolbar
The following table shows and describes the buttons on the AppXtender Web Administrator Toolbar.

Table 1. AppXtender Web Toolbar Buttons

Button Description
Closes the Administrator window

Opens the Session List

Opens the Full Text Job Queue List

Opens the Locked Documents List

Opens the Checked Out Documents List

Deletes the selected items

Refreshes the current list

Opens the Retention Holds Admin page

ApplicationXtender Web Access Administrator’s Quick Reference 9