User Guide for Cisco MXE 3000 Release 2.0
Performing Folder Attendant Administrative Tasks

Table Of Contents

Performing Folder Attendant Administrative Tasks

Folder Attendant Administrative Tasks

Setting Up the Folder Attendant Service

Starting the Folder Attendant Service

Shutting Down the Folder Attendant Service

Setting Up Folder Attendant to Start Automatically

Setting Up Roles

About the Role Administration Page

Creating New Roles

Updating Roles

Permissions for Roles

Setting Permissions

Deleting Roles

Setting Up Users

Creating New Users

Updating Existing Users

Permissions for Users

Setting Permissions

Deleting Users


Performing Folder Attendant Administrative Tasks


Revised: October 10, 2008, OL-16995-01

This section includes the following topics:

Folder Attendant Administrative Tasks

Setting Up the Folder Attendant Service

Setting Up Roles

Setting Up Users

Folder Attendant Administrative Tasks

The Folder Attendant Administrative tasks include setting up the Folder Attendant service, defining users and roles, and setting permissions for users and roles.


Note You must have Admin Tools permission to perform these tasks.


A user profile is created for each user who will have access to Folder Attendant. The user profile includes a user name and password, first and last name of the user, e-mail address for automatic notifications, and a User Role.

The User Role defines the level of access for each user.

The Administrative tasks that can be performed from Folder Attendant are:

Setting Up Roles

Setting Up Users

The Administrative tasks that can be performed from Windows are:

Starting the Folder Attendant Service

Shutting Down the Folder Attendant Service

Setting Up Folder Attendant to Start Automatically

Setting Up the Folder Attendant Service

This section includes the following topics:

Starting the Folder Attendant Service

Shutting Down the Folder Attendant Service

Setting Up Folder Attendant to Start Automatically

Starting the Folder Attendant Service


Note The following information is for the Folder Attendant Administrator only.


Before you start using Folder Attendant, you must start the Folder Attendant Service:

Procedure


Step 1 From the Windows Start button, open the Control Panel.

Step 2 Click Administrative Tools.

Step 3 Click Services. A list of services running on the system displays.

Step 4 Locate and select the Folder Attendant Service in the list.

Step 5 If the value listed in the Status field does not display as Started, click the blue Start link on the left side of the page.

or

Right-click Folder Attendant Service, and select Start.

The Status now displays as Started.


Shutting Down the Folder Attendant Service


Note The following information is for the Folder Attendant Administrator only.



Step 1 From the Windows Start button, open the Control Panel.

Step 2 Select Administrative Tools.

Step 3 In the list, select Folder Attendant Service.

Step 4 Click the blue Stop link on the left side of the page.

or

Right-click Folder Attendant Service, and select Stop.


Setting Up Folder Attendant to Start Automatically


Note The following information is for the Folder Attendant Administrator only.


Before using Folder Attendant for the first time, set the Folder Attendant program to start your system.

Before You Begin

Configure the Folder Attendant Service with a domain/system account that has the appropriate permissions for accessing watch folders and profiles. If the permissions are not set correctly, error messages indicating a problem with the permissions appear in the Folder Attendant Service log files located in: C:\\program files\Cisco\MXE Folder Attendant Service\logs.


Note If a watch folder cannot be accessed, the Folder Attendant Administration page indicates that the status is Offline.


Procedure


Step 1 Start the Folder Attendant Service.

Step 2 From Start > Control Panel > Administrative Tools > Services, verify that the value of the Startup Type field is Automatic, indicating that it will start automatically when the Cisco MXE 3000 is powered on. If it is not set to Automatic, right-click Folder Attendant Service, and select Properties.

Step 3 Select the General tab, from the Startup type drop-down, select Automatic.

The Startup Type now displays as Automatic, indicating that the Folder Attendant Services will start automatically when the PC/server is started.


Troubleshooting Tips

If you see such error messages, go to the Log On tab from the Properties page, and add a special account (the same user account under which the Cisco MXE 3000 is running - usually a domain account with local admin permissions), as shown in Figure 12-1.

Figure 12-1 Log On Tab: Add Account with Appropriate Permissions

Setting Up Roles

This section includes the following topics:

About the Role Administration Page

Creating New Roles

Updating Roles

Permissions for Roles

Setting Permissions

Deleting Roles

About the Role Administration Page

Each Folder Attendant user is assigned a role that controls their level of access to the various system features.

Roles are defined on the Role Administration page, shown in Figure 12-2.

Figure 12-2 Role Administration Page

In the example in Figure 12-2, during system deployment, two roles were defined: admin and user.

From the Role Administration page, you can:

Create New Roles

Update Existing Roles

Set Permissions for Roles

Delete Roles

Creating New Roles

The new role displays on the Role Administration page. The roles are sorted in alphabetical order.

Procedure


Step 1 Access the Role Administration page.

Step 2 From the menu bar, select Create. The Create a New Role pop-up displays.

Step 3 Enter a Role Name and Description, and click Create Role. The new role displays, as shown in Figure 12-3.

Figure 12-3 New Role Has Been Added


Updating Roles

Procedure


Step 1 Access the Role Administration page.

Step 2 Select the role you want to edit, as shown in Figure 12-4.

Figure 12-4 Select Role to Edit

Step 3 Select Edit from the menu bar. The Edit Role pop-up displays.

Step 4 Update the information in each of the fields, as needed. The fields marked with an asterisk (*) are required.

Step 5 Select Edit Role to save the new information.


Permissions for Roles

After creating a role, the System Administrator sets permissions for that role.

Each role is allowed or denied permission to use the following Folder Attendant features:

Admin Tools

Folder Attendant

Monitoring

Submission

The permissions for a selected role display in the lower pane, as shown in Figure 12-5.

Figure 12-5 Permissions for the Selected Role

Table 12-1 describes the columns that display the permissions for each role.

Table 12-1 Selected Permissions 

Column
Description

Default

Shows the default permissions that are shipped with Folder Attendant.

Role

Shows the permissions set for the Role. Permissions set for the role override the Default permissions.

Allow

The actual permissions set for the selected role, often the same as the Role column.


The red X indicates that permission for that feature is denied, and the green check mark indicates that the user in this role has permission to access the feature.

Read the permission table from left to right: marks in the column to the right override the previous column.

In the example in Figure 12-5, the monitor role came loaded (by default) with access to Folder Attendant, Monitoring, and Submission features. In this case, an administrator has removed, for the role called Monitor, access to Folder Attendant and Submission features. The Monitor role now allows access to Monitoring functions only.

Modify the permissions for the selected role. See also: Setting Permissions.

For each feature, you can specify whether or not to allow, deny, or remove access. You can also choose to remove all access to all features for a specific role.

Setting Permissions

Procedure


Step 1 Access the Role Administration page.

Step 2 Select the role for which you want to set user permissions. The permissions for the selected user are listed at the bottom of the page.

Step 3 Select the permission you want to modify. Your choices are the following:

Admin Tools

Folder Attendant

Monitoring

Submission

Step 4 Select one of the buttons shown in Table 12-2 for each role.

Table 12-2 Permissions Settings 

Name
Description

Allow

Allow users in this role access to the specific feature.

Deny

Deny users in this role access to the specific feature.

Remove

Remove users in this role access to the specific feature.

Remove All

Removes all access to all features for the specific role.


Step 5 Repeat Step 3and Step 4 for each feature to set all permissions for this role.


Deleting Roles

Before You Begin

You can only delete a role if it contains no users. If the role contains users and you try to delete it, an error message displays at the top of the page.

Procedure


Step 1 Access the Role Administration page.

Step 2 Select the role that you want to delete, as shown in Figure 12-6.

Figure 12-6 Select the Role to Delete

Step 3 Click Delete. A confirmation message displays.

Step 4 Select OK to continue with the deletion.

The role is removed from the list of roles on the Role Administration page.


Setting Up Users

This section includes the following topics:

Creating New Users

Updating Existing Users

Permissions for Users

Setting Permissions

Deleting Users

Creating New Users

Each person using Folder Attendant needs a user profile that controls system access.

Procedure


Step 1 Access the User Administration page.

Step 2 From the menu bar, select Create. The Create User pop-up displays.

Step 3 Enter the appropriate information in each of the fields described in Table 12-3. All fields are required.

Table 12-3 Create New User Fields 

Field
Description

User Name

Enter a name for the new user.

Password

Enter a password for the new user.

Confirm Password

Re-enter the password to confirm it.

First Name

Enter the first name of the user.

Last Name

Enter the last name of the user.

E-mail

Enter the e-mail address of the user.

Role

Select the role from the drop-down menu. The role defines the level of access the user has to Folder Attendant functions. Roles are defined at the time of deployment and are normally: Administrator and User.


Step 4 Select Create User to save the new user. A message displays indicating the new users has been successfully added.

Step 5 Select Continue. The new user displays on the User Administration page. The users are sorted in alphabetical order.


Updating Existing Users

Procedure


Step 1 Access the User Administration page.

Step 2 Select the user you want to edit, as shown in Figure 12-7.

Figure 12-7 Select the User to be Edited

Step 3 Select Edit from the menu bar. The Edit User pop-up displays.

Step 4 Update the information in any fields, as needed. The fields marked with an asterisk (*) are required.

Step 5 Click Edit User. The new information is saved, and the User Administration page is updated.


Permissions for Users

After creating a user, the System Administrator needs to set permissions for that user.

Each user is allowed or denied permission to use the following Folder Attendant features:

Admin Tools

Folder Attendant

Monitoring

Submission

The permissions for a selected user are displayed at the bottom of the User Administration, as shown in Figure 12-8.

Figure 12-8 Permissions for the Selected User

Table 12-4 describes the four columns that display the permissions for a user.

Table 12-4 Columns in the Permissions Table 

Column
Description

Default

Shows the default value for the permissions that are shipped with Folder Attendant

Role

Shows the permissions set for the Role. Permissions set for the Role override the Default permissions. The Role permissions specified in this column are set from the Role Administration page.

User

Shows the permissions set for the selected user. Permission set for the User override the Role permissions.

Allow

The actual permissions set for the selected User.


The red X indicates that permissions for that feature are denied, and the green check mark indicates that the selected user has permissions to access the feature.

Read the permission table from left to right: marks in the column to the right override the previous column.

The Default permissions are shown in the first column. These are default permissions that come loaded in the system.

The Role column shows the permissions for the Role assigned to this user. The permissions for the Role override the default permissions and are set on the Role Administration page.

The User permissions show the permissions for this specific user. These permissions override both the Default and Role permissions for this user only. Modify the permissions for the selected user shown in this column by following the procedure described below.

To quickly determine if certain permissions are allowed for a user, view the Allow column.

Figure 12-8 is an example of permissions set for the user named JSmith who has been assigned the user role. Notice that by default, those in the user role do not have access to Admin Tools (in this case) but have access to the remaining features. However, an administrator has added (overridden) the Admin Tools permission to this User's role.

For each feature, you can specify whether or not to allow, deny, or remove the user's access. You can also choose to remove all access to all features for a specific user.

Setting Permissions

Procedure


Step 1 Access the User Administration page.

Step 2 Select the User for which you want to set permissions. The permissions for the selected User are listed at the bottom of the page.

Step 3 Select the type of permission you want to modify. Your choices are:

Admin Tools

Folder Attendant

Monitoring

Submission

Step 4 Select one of the buttons described in Table 12-5 for the selected permission.

Table 12-5 Permissions Settings

Name
Description

Allow

Allow the user access to the specific feature.

Deny

Deny the user access to the specific feature.

Remove

Remove the user access to the specific feature.

Remove All

Removes all access to all features for the specific user.


Step 5 Repeat Step 3 and Step 4 for each feature to set all permissions for this user.


Deleting Users

Procedure


Step 1 Access the User Administration page.

Step 2 Select the user you want to delete, and click Delete, as shown in Figure 12-9.

Figure 12-9 Select User to Delete

Step 3 When the confirmation message displays, select OK to continue with the deletion.