Appendix C   iPlanet Portal Server 3.0 Third-Party Software CD-ROM


This appendix describes the third-party applications available on the iPlanet Portal Server Third Party CD labeled, "Contains 3rd Party Software Only." The next sections include procedures for installing and configuring the following third party applications:

• Samba client for NetFile's connections to Samba file servers

• GO-Joe server-side software

• pcANYWHERE PC-based software

  
  

  ---

  Note	There is no server-side component for Citrix servers. The Citrix applet connects directly to Citrix-enabled machines.

  ---

  
  

Samba

Samba is an open source software suite that provides seamless file services to SMB/CIGs clients. If you want to allow end users access to Microsoft Windows networks through the NetFile applet or NetFile Lite (HTML) client), you must install the Samba client on the iPlanet Portal Server. For more information about Samba, see the URL:

http://us1.samba.org/samba/about.html

iPlanet Portal Server supports Samba version 2.0.4.

To Install Samba Software

1. Mount the iPlanet Portal Server CD-ROM, "Contains 3rd Party Software Packages Only."

2. Become root on the iPlanet Portal Server.

3. Change to the directory on the CD-ROM:

   # cd /cdrom/cdrom0

4. Run the install_3ps script.

   # install_3ps

   This adds the package SUNWsrsmb to the iPlanet Portal Server platform server.

5. Eject the CD-ROM:

   # cd / # eject dcrom0

   Any process started when the current working directory is /cdrom/cdrom0 must be stopped before you can eject the CD-ROM.

GO-Joe

GO-Joe is a thin client X server for all Java-enabled displays. It provides access to UNIX/X without software rewriting or a fat X server on the desktop. It is available from the GraphOn Corporation.

After you have installed the GO-Joe server software, you can control a desktop UNIX machine remotely over the Internet. You can find more information on GO-Joe at the URL:

http://www.graphon.com/

Five licenses are included in the package that is supplied. If you want more than five licenses or have any question about the licensing, you must contact the GraphOn Corporation.

---

Note	You must purchase a copy of GO-Joe for each desktop that you want to control remotely with more than five users.

---

GO-Joe consists of a client-side and server-side component. The client-side component is an applet that iPlanet Portal Server downloads through a pre-configured Netlet rule. The applet is installed on the iPlanet Portal Server when you install iPlanet Portal Server 3.0. The Netlet is also pre-configured to proxy connections from the applet to target machines running Solaris. The target Solaris machines must have the SUNWgjvxs package installed on them to be controlled by the applet.

iPlanet Portal Server end users are given access to Solaris machines through the Netlet provider on the iPlanet Portal Server Desktop. To add Solaris machines to a user's list, you edit the user's Netlet targets. Or, the users can add Solaris machines by editing the Netlet provider window.

Installing GO-Joe on the Machine You Want to Control

If your end users want to have remote X-Window control of a machine, you or they must install the package SUNWgjvxs from the iPlanet Portal Server Third Party CD-ROM on the machines that they want to control.

To Add the SUNWgjvxs Package

1. Mount the iPlanet Portal Server CD-ROM, "Contains 3rd Party Software Packages Only," on the machine that you want to control remotely.

2. Become root and go to the directory on the CD-ROM for your OS:

   #cd /cdrom/cdrom0

3. Add the package SUNWgjvxs:

   #pkgadd -d . SUNWgjvxs

4. Eject the CD-ROM:

   # cd / # eject cdrom0

   You must stop any process started when the current working directory is /cdrom/cdrom0 before you can eject the CD_ROM.

Using GO-Joe With Browsers

GO-Joe has no known problems with Netscape. Internet Explorer may hang if you are using it with GO-Joe. The following procedure may prevent this difficulty.

To Use GO-Joe With Internet Explorer

1. Press the Tab key until you reach the Start Session button.

2. Press Space bar, Enter key, or click the Start Session button.

   
   

   ---

   Note	More recent versions of Internet Explorer may not have this problem.

   ---

   
   

   By default, the startup file for the GO-Joe client sets the virtual display size to 100 percent of the width and height of the browser when end users start the applet.

Because the browser's resolution size for the virtuality display has already been negotiated with the window server, resizing the window will not help.

End users should set the fonts for the window manager to a small font size, if they use this feature often from systems that have lower resolutions so as not to limit the screen real estate in which to operate.

pcANYWHERE

Symantec's pcANYWHERE provides fast, easy access to office PCs from remote locations. After you have installed pcANYWHERE on an office system, you can control that system remotely from the Internet.

pcANYWHERE consists of a client-side component and a PC-based component. The client-side component is an applet that iPlanet Portal Server downloads through a pre-configured Netlet rule. The applet is installed on the iPlanet Portal Server when you install iPlanet Portal Server 3.0. The Netlet is also pre-configured to proxy connections from the applet to target PCs. The target PCs must have the PC side component installed on them to be controlled by the applet.

iPlanet Portal Server end users are given access for PCs through the Netlet provider on the iPlanet Portal Server Desktop. To add PCs to a user's list, you edit the user's Netlet targets. Or, the users can add PCs by editing the Netlet provider window.

An evaluation version of pcANYWHERE 32 version 8.0 software for PCs is included in the iPlanet Portal Server software distribution on the "Contains 3rd Party Software Only" CD. You can purchase the full version from Symantec or through commercial software dealers, and can find more information on pcANYWHERE at the URL http://www.symantec.com/pcANYWHERE.

---

Note	If you want to use pcANYWHERE after the trial version on the CD expires, you must purchase a copy of pcANYWHERE for each desktop that you want to control remotely.

---

To install the Trial Version of pcANYWHERE on the CD

The iPlanet Portal Server third part CD includes a 30-day trial version of pcANYWHERE.

1. Insert the iPlanet Portal Server CD-ROM "Contains 3rd Party Software Only" in the CD-ROM drive of the computer to be controlled remotely.

2. Follow the instructions given by the pcANYWHERE wizard.

To Configure the Trial Version of pcANYWHERE

Follow the procedure below to configure the trial version of pcANYWHERE.

1. Restart your computer.

2. Choose Start | Programs | pcANYWHERE32 | pcANYWHERE.

   pcANYWHERE starts.

3. Click the I Agree button to accept the evaluation license agreement.pcANYWHERE Evaluation Agreement

4. Click Cancel to exit from the Smart Setup Wizard.

   The Smart Setup Wizard starts when you first run pcANYWHERE and configures items that are not necessary to run pcANYWHERE with the iPlanet Portal Server product.

5. Choose Quick Start | Add Be a Host PC Item shown in Figure C-1.

   The Quick Start wizard walks you through the configuration steps.

   
   
   

Figure C-1    Quick Start with Add Be a Host PC Item

6. Provide a name (for example, iPlanet Portal Server) for the connection as shown in Figure C-2 and click Next.

   
   
   

Figure C-2    Provide a Name for the Connection

7. Select TCP/IP for the connection device shown in Figure C-3 and click Next.

   
   
   

Figure C-3    Specify TCP/IP for the Connection Device

You must select TCP/IP from the drop down list to use pcANYWHERE with iPlanet Portal Server.

8. Click Finish as shown in Figure C-4 to complete the pcANYWHERE Wizard.

   
   
   

Figure C-4    Last Screen of the Quick Start Wizard

---

Caution

Do NOT check the option "Automatically launch after wizard."

---

The installation program returns you to the pcANYWHERE Main Window. You now must configure the properties for iPlanet Portal Server.

9. Right-click the iPlanet Portal Server icon, and choose Properties from the pop-up menu.

   
   

   ---

   Caution

   Do NOT double-click the iPlanet Portal Server icon.

   ---

   
   

   The iPlanet Portal Server Properties window appears, as shown in Figure C-5.

   
   
   

Figure C-5    iPlanet Portal Server Properties Window

10. Verify that TCP/IP is checked and highlighted in the Device List.

    If it is not checked and highlighted, click the box before TCP/IP to check and highlight it.

11. Click the Settings tab at the top of the iPlanet Portal Server Properties window to move to the next set of options.

12. Configure the Settings shown in Figure C-6 according to the table belowTable C-1.

    
    
    

Figure C-6    Specify the Settings for Your Connection

Table C-1 (Only the possible choices are shown)

Section	Option	Value
Host Startup	·    Launch with Windows	Yes
	·    Use Windows screen saver	No
	·    Run Minimized	Yes
Abnormal End of Session	·    Wait n Minutes for User to       Reconnect	1
Then	·    Wait for Anyone	Yes
In Session	·    Keyboard/Mouse Active       During Session	Host and Remote
After A Normal End of Session	·    Wait For Anyone	Yes

13. Click the Callers tab at the top of the iPlanet Portal Server Properties window shown in Figure C-7 to move to the next tab.

14. Choose Specify individual caller privileges.

    
    
    

Figure C-7    Callers Tab for Individual Caller Privileges.

15. Double-click the Add Caller icon to start the Add Caller Wizard.

16. Type the caller's name as shown in Figure C-8.

    This is typically your user name for your system. It identifies you when you connect from the Internet.

    
    
    

Figure C-8    Specify the Name for the Caller.

17. Click Next.

18. Specify the caller's login name as shown Figure C-9.

    
    
    

Figure C-9    Specify the Login name and Password.

This is the same name or user ID that you typed in the previous screen shown in Figure C-8.

19. Type the password that you want to use, and then confirm the password by typing it again in the next field as shown in Figure C-9.

20. Click Next when you have finished.

21. Click Finish to complete the New Caller Wizard as shown in Figure C-10.

    
    
    

Figure C-10    Last Screen of the New Caller Wizard.

22. Click the Security Options tab at the top of iPlanet Portal Server Properties window.

23. Configure the Security Options as shown in Figure C-11 according to Table C-2.

    
    
    

Figure C-11    Specify the Security Options for the Connection.

Table C-2 (Only the possible choices are shown)

Section	Option	Value
Connection Options	·    Blank This PC Screen After Connection	Yes
	·    Log Failed Connection Attempts	Yes
	·    Prompt To Confirm Connection	No
Login Options	·    Make Passwords Case Sensitive	No
	·    Limit Login Attempts Per Call	Yes
	·    Maximum	3
	·    Limit Time To Complete Login	Yes
	·    Time-out n Minutes	3
Encryption Level	·    pcANYWHERE	pcANYWHERE
Session Options	·   Disconnect if Inactive n Minutes	any value; value required, but not restricted.

You must type a value for the Disconnect if Inactive n Minutes option. You can, however, type whatever value you want. A good value for this option is typically five to ten minutes. There is a trade-off between typing a value that is too large or too small. If you specify a large value and are unexpectedly disconnected from the Internet, you cannot connect back to your PC for remote control until the time expires. If, on the other hand, you choose a value that is too small, you may be unexpectedly disconnected, for example, while you are reading a long document

24. Click OK.

25. Double-click the new iPlanet Portal Server icon to start host mode on your PC and wait for connections.

    
    

    ---

    Tip	Turn off any animated screen saver on the desktop PC. Using an animated screen saver delays logging in because the PC has to send all the image data from it over the network.

    ---