Running a Sametime Community Server as a background process on AIX

You can run Sametime as a background process on an IBM® AIX® server.

Before you begin

The operating system's IBM Domino® user actually runs the background process, and must have permission to run the script and write files to the Domino Data Directory.

About this task

To run the Sametime® server as a background process, complete the following steps:

Procedure

Open the ststart script located in the data directory, and copy the two sections that follow into the .profile of the Domino user that will run Sametime as a background process:
```
# Define variables
BINDIR=/opt/lotus/notes/latest/ibmpow/
LOTUSDIR=/opt/lotus/bin

# Export paths forNotes® user
LIBPATH=${LIBPATH}:$BINDIR
export LIBPATH
PATH=${PATH}:$BINDIR
export PATH
```
Note: The PATH environment variable cannot contain the /lotus/bin directory, which defaults to /opt/lotus/bin.
Set up the Virtual Frame Buffer, and verify that it is running.
Set the DISPLAY environment variable to the host name:
```
DISPLAY=example:1
export DISPLAY
```
From the command prompt, run the following command, which enables you to manage the server only through the IBM Notes Administration Client:
```
nohup /opt/lotus/bin/server < /dev/null > /dev/null 2>&1 &
```
If you want to use text files for stin and stout, use the following:
1. Create the following script on the server:
```
#!/usr/bin/sh
DOMINO_PROGRAM_DIR=/opt/lotus
DOMINO_DATA_DIR=/local/notesdata
exportDomino_PROGRAM_DIR
exportDomino_DATA_DIR
cd $DOMINO_DATA_DIR
if [ -f st.in ] ; then
   rm st.in
fi
if [ -f st.out ] ; then
   mv st.out st.out.bak
fi
touch st.in
$DOMINO_PROGRAM_DIR/bin/server <st.in >st.out 2>&1 &
cd -
```
  Note:
  If /usr/bin/sh does not exist, change the path for sh at the beginning of the script.
  
  If the default installation settings are not used, modify theDomino_DATA_DIR andDomino_PROGRAM_DIR environment variables at the beginning of the script.
2. Save the script on the AIX server.
3. Use the cd command to navigate to the folder where the script was saved.
4. Launch the script by typing:
```
./script_name
```
  where script_name is the file name of the script.

Results

Once the server is running, you can interact with the server console by using the Administrator Client Server console. Alternatively, you can view the console in a telnet session by issuing the following commands:

> cdDomino_DATA_DIR
> tail -f st.out

To enter commands at the server console, do the following:

> cd DOMINO_DATA_DIR
> echo {command} >>st.in

where

DOMINO_DATA_DIR is be the value for the Domino Data directory; for example, /local/notesdata,

and

{command} is a Domino Server console command such as "Show Tasks"; for example:

> echo show tasks  >>st.in