IBM Support

Setting up a Domino server on a UNIX-based system

Technote (FAQ)


Question

You attempt to set up a Domino server on a UNIX-based system, but you receive the following error:


    "Please edit your shell's DISPLAY environment variable to reflect an unlocked terminal that you would like to launch the Domino Setup Program on."

This is a sample of the output you might see in <setuplog.txt>:

    Startup arguments = -data /local/notesdata
    Creating new WizardData instance
    argument 0 -data
    Processing -data parameter
    About to wait on DominoAPIThread.callAPI()
    dominoAPI.run.init
    About to notify api caller
    About to wait on run
    Woke in DominoAPIThread.callAPI()
    detected jsetdom JNI interface
    launch path= /local/notesdata
    Set writable helpdir /local/notesdata
    Can't connect to X11 window server using ':0' as the value of the DISPLAY variable
    endWizard
    About to wait on DominoAPIThread.callAPI()
    Woke up from wait on run
    dominoAPI.run.endNotes
    DominoAPI - endNotes terminating notes
    Thread= Thread[Thread-0,5,main]
    Deleting setup db
    DominoAPI - deleteDB
    Thread= Thread[Thread-0,5,main]
    EndNotes Error - Can't delete setup database
    About to notify api caller
    About to wait on run
    Woke in DominoAPIThread.callAPI()
    About to wait on DominoAPIThread.callAPI()
    Woke up from wait on run
    dominoAPI.run.term
    About to notify api caller
    Woke in DominoAPIThread.callAPI()
    DominoConstants.getWritableDirectory()
    writable directory = /tmp

Answer

There are two ways to set up Domino. The first is if you are running setup from the server on which you installed the code. You can do this just by starting up the Domino server (i.e., run /opt/lotus/bin/server as the user created to run Domino).


Since the Domino server setup launches a Java client, in some cases, you may need to set up the DISPLAY environment variable and allow xhost permission to the GUI as well:

1.  Log in as root to the graphical desktop environment of your choice. Most people use KDE or Gnome. Then add your server to the access control list of xhost. This will give permission to your server to send a display to your screen:

    /usr/X11R6/bin/xhost <hostname>

2.  Switch to the user account for Domino and set the DISPLAY environment variable to your local screen:
    su - <Domino user>
    export DISPLAY=<hostname>:0
Note: Be sure to not omit the colon and zero (:0) after the hostname/IP address.

3.  Make sure that you are located in the data directory, and launch the server:
    pwd
    /opt/lotus/bin/server



The second method of setting up a UNIX server is to do it remotely:

After you install the program files for a Domino server on a system, you can use either a Windows client system or another Domino server to run the Server Setup program remotely. Running the Server Setup program from a Windows client is easier if the client has Domino Administrator installed -- to run the program from a client without Domino Administrator, you need the Java runtime environment plus some files from the program directory of an installed Domino server.

Whenever the following procedures include instructions for entering system commands, make sure you understand the terms "Domino program directory" and "Notes program directory" as they apply to your operating system. For more information, refer to the Administrator Help topic "Entering system commands correctly".

To run the Server Setup program from a Windows client with Domino Administrator

1. Make sure that you:

  • Selected "Remote Server Setup" when you installed Domino Administrator on the client system (on the Windows desktop, choose Start - Programs - Lotus Applications and see if Remote Server Setup appears in the list)
  • Know the host name or network address of the remote system

2. Install the Domino server program files on a server system, but do not run the Domino Server Setup program.

3. At the command prompt on the server system, from the Domino program directory, do one of the following:

  • On a Windows server, enter nserver -listen
  • On a UNIX server, enter server -listen

4. On the client system, choose Start - Programs - Lotus Applications - Remote Server Setup.

5. In the Connect to Remote Domino Server dialog box, click Ping to ensure that you can connect to the remote server.

6. Enter the host name or network address of the remote server.

7. Click OK to start the Domino Server Setup program.

To run the Server Setup program from a Windows client without Domino Administrator, or from a UNIX workstation

1. Make sure that you know the host name or network address of the remote system.

2. Install the Domino server program files on a server system, but do not run the Domino Server Setup program.

3. At the command prompt on the server, from the Domino program directory, do one of the following:

  • On a UNIX server, enter /lotus/bin/server -listen
  • On a Windows server, enter nserver -listen

4. On the client system, install the Java runtime environment.

5. Create a temporary directory on the client system. For example, enter the following at the command prompt:

  • On a Windows client: mkdir c:\temp
  • On a UNIX workstation: mkdir /temp

6. Do one of the following:
  • From a Windows client, copy the remote setup files CFGDOMSERVER.JAR, JHALL.JAR, and REMOTESETUP.CMD from the server to the directory you created on the client system. These files are in C:\Domino program directory on the server.
  • From a UNIX workstation, copy the remote setup files CFGDOMSERVER.JAR, JHALL.JAR, and REMOTESETUP from the server to the directory you created on the workstation. These files are in /Domino program directory/lotus/notes/latest/ibmpow/ on an AIX server, /Domino program directory/lotus/notes/latest/linux/ on a Linux server, and /Domino program directory/lotus/notes/latest/sunspa/ on a Solaris server.

7. At the command prompt on the client system, from the directory you created, do one of the following:
  • On a Windows client, enter remotesetup.cmd
  • On a UNIX workstation, enter remotesetup

8. In the Connect to Remote Domino Server dialog box, click Ping to ensure that you can connect to the remote server.

9. Enter the host name or network address of the remote server.

10. Click OK to start the Domino Server Setup program.

To run the Server Setup program from another server system

1. Install the Domino server program files on both server systems, but do not run the Domino Server Setup program.

2. Make sure that you know the host name or network address of the remote system.

3. At the command prompt on the local server system, from the Domino program directory, do one of the following:

  • On a Windows server, enter nserver -listen
  • On a UNIX server, enter server -listen

4. Do one of the following:
  • On a Windows server, enter nserver -remote
  • On a UNIX server, enter server -remote

Tip Entering nserver -help or server -help displays all parameters available for working with remote server setups.

5. In the Connect to Remote Domino Server dialog box, click Ping to ensure that you can connect to the remote server.

6. Enter the host name or network address of the remote server.

7. Click OK to start the Domino Server Setup program.


For more information see the IBM Redbooks publication Lotus Domino 6 for Linux, SG24-6835-00.


Document information

More support for: IBM Domino
Deployment

Software version: 6.0, 6.5, 7.0, 8.0, 8.5

Operating system(s): AIX, Solaris

Reference #: 1107421

Modified date: 25 August 2010