Installing Virtual Office 1.5 for the Forgotten Password Portal.

(Last modified: 04Aug2005)

This document (10098494) is provided subject to the disclaimer at the end of this document.

goal

Installing Virtual Office 1.5 for the Forgotten Password Portal.

fact

Novell OES for Linux

Novell OES for Netware

Novell eDirectory 8.7.3 for NetWare 6.5

Novell Virtual Office

Novell iManager 2.5

symptom

Forgotten Password link is no longer seen after upgrading iManager to version 2.5.

cause

The Forgotten Password link is now handled via Virtual Office

fix

Explaination

The Forgotten Password link is no longer seen from the nps link once iManager has been upgraded from 2.02 to 2.5.  To regain this functionality it must be enabled from Virtual Office 1.5.  If VO 1.3 is installed it must be upgraded to 1.5.  If it does not exist VO 1.5 must be installed.  Further VO's 1.5 administration is no longer performed from iManager but rather from its own administration page, https://x.x.x.x/vo.  This is also the url that your users will go to in order to see the Forgot Password link as well as to set up or change their challenge responses.

Installation Steps

1. If Universal Password is enabled and a password policy is assigned such that it will flow down to where the extend VO container will be created (normally under the container where the server object exists) , temporarily disable it.   For example, if the policy is assigned to the partition root that holds this server's object the policy should be unassociated from it temporarily. 

NOTE: If this is not done the policy will stop the VO pco object from either being created or interferring with its ability to complete the installation of VO.  This will result in a 500 error when attempting to go to the VO admin page: https://x.x.x.x/vo.  You will also get a error: 669 exception, unable to authenticate.  This can also be verified by examining the Virtual Office container created by the installation below the context of the server object.  You would only see a teams container and possibly the pco object.  None of the gadgets would have been created.  For more information on how to clean up after this has occurred, please view TID NOVL102715.

2. Install VO:
- Mount the 6.5 OES Product cd. 
- load startx at the console
- Select Install - Add - Browse to the POSTINST.NI file at the root of the CD and select OK.
- Select VO - Accept all defaults and install the product.  Reset Apache when prompted.
- Finally on NetWare verify via the logger screen that the server is once again listening on its Tomcat ports.  This is done via netstat on OES Linux.

3. Re-enable the Password Policy within iManager by re-associating it to the object or container it was previously unassociated from.

4. Enable the Forgot Password servlet from VO.
- Use a browser to connect to https://x.x.x.x/vo .  Login as admin or the admin equivilant you used to install VO in the earlier steps.
- In the right frame select Services.  Select the Change Password tab in the middle of the screen.  Select the Change Universal Password Link and save the change by clicking on the OK button.

5. Once completed verify that the Password Policy has been linked to the Challenge Set and is associated at a level in the tree which flows to a user object or is assigned to a user object itself.  Users will now use the https://x.x.x.x/vo url to both login and setup his challenge answers as well as to access the Forgot Password link.

Some useful TIDs in troubleshooting Virtual Office Forgotten Password Integration:

- Getting an error: "Could not complete request.   Challenge Questions authentication unsuccessful" when clicking on the Forgot Password link -  NOVL102998

- Recovering from a failed VO installation due to a password policy being in place - NOVL102715

- After selecting the Forgotten Password link the user gets a blank screen - NOVL102521

- Trying to change a password via the Forgotten Password link results in a error: Universal Password Not Available - NOVL102784

- Main Password Management TID (primarly for iManager 2.02 issues) - NOVL95990

document

Document Title: Installing Virtual Office 1.5 for the Forgotten Password Portal.
Document ID: 10098494
Solution ID: NOVL102997
Creation Date: 02Aug2005
Modified Date: 04Aug2005
Novell Product Class:Novell Directory Services

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.