Server Administration

This chapter describes how to manage your calendar server. All administrative tasks and procedures are executed using command-line utilities, the Admin GUI, the Web GUI, or operating system tools.

This chapter documents the following administrative procedures:

• Using the Admin GUI
• Starting and stopping the calendar server
• Checking server status
• Viewing current user activity
• Changing the SYSOP (node) password
• Other administrative tasks

Using the Admin GUI

The CorporateTime Server Administrator is an NT-based GUI used to manage the calendar server. Many administrative tasks and procedures may be performed using this tool; however, some functionality is available only through command-line utilities. All documented procedures executed through this interface are indicated by the label "Admin GUI" in bold type. Tasks exposed through the GUI include:

• Starting and stopping the calendar server (local host only)
• node creation
• node administration
• user creation and management
• resource creation and management
• node network connections
• database (node) backup
• internal and external directory synchronization (LDAP only)

The Admin GUI is included as part of the Windows NT package of the calendar server. If you wish to use this tool on a Windows NT machine to perform a limited subset of tasks on a remote UNIX installation of the calendar server, you must install it separately. See the "CorporateTime Server Administrator" section of the Readme file included with this product for more details.

Starting and stopping the calendar server

If you are using an external LDAP directory server (the unison.ini parameter [DAS] enable=TRUE), your directory server must be running before you can start the calendar server. If you have enabled e-mail notification (the unison.ini parameter [LIMITS] mail=TRUE), a mail server should be running.

Start the calendar server by using the unistart utility. Stop it by using the unistop utility. For full information on use and syntax, see Reference Appendix C, "Utilities."

Example

To start the calendar server (bringing up four daemons if using an internal directory and five daemons if using an external LDAP directory), execute the following command:

% unistart

Example

For an orderly shutdown of CorporateTime Server, execute the following command:

% unistop -y

The CorporateTime Server Administrator cannot be used to bring down processes or services on a remote server. The following procedure will control services only on the machine running the CorporateTime Server Administrator.

9. Select Services | Properties to open the Local Services dialogue box.
10. Click Start or Stop.

From the Services dialogue box (Start Menu | Settings | Control Panel | Services), stop the CorporateTime Server services: Calendar Corporate-Wide Services, Calendar Directory Access Server (external directory only), Calendar Engine, Calendar Lock Manager, and Calendar Synchronous Network Connections. Dependencies among these services may result in the termination or initiation of more than one service. For instance, select CorporateTime Lock Manager and click Stop to bring down all services in one action.

The number of client connections, the number of processes running, and the volume of network traffic all affect the amount of time that the server takes to stop.

Checking server status

To view the current status of the calendar daemons/services and servers, run the unistatus utility. For full information on use and syntax, see Reference Appendix C, "Utilities."

Example

To verify the status of the calendar server's daemons/services, run the following command:

% unistatus -d

UID	PID	PPID	STIME	TIME	COMMAND	CLASS
unison	26512	1	17:18:14	0:00	unilckd	daemon
unison	26517	1	17:18:16	0:00	uniengd	daemon
unison	26591	1	17:18:22	0:00	unidasd	daemon
unison	26669	1	17:18:24	0:00	unisncd	daemon
unison	26678	1	17:18:26	0:00	unicwsd	daemon

unistatus: the calendar server is up

Viewing current user activity

To view current logged-on users, run the uniwho utility. For full information on use and syntax, see Reference Appendix C, "Utilities."

Example

To view a list of current client connections, execute:

% uniwho

PID	ADDRESS	NODEID	XITEMID	USER
7721	193.77.49.162	20004	20004,2	CWSOP,na
14668	193.77.49.223	20004	20004,295	Alexander,James
10237	193.77.49.44	20004	20004,142	Addison,Thomas

Changing the SYSOP (node) password

To change the password of the SYSOP (the administrator of a node) or any other user, run the unipasswd utility from the command line. For full information on use and syntax, see Reference Appendix C, "Utilities."

Example

To change the password for node 34, execute:

% unipasswd -n 34

Enter old password:

Enter new password:

Re-enter new password:

unipasswd: Password changed successfully

To change the SYSOP password from the CorporateTime Server Administrator:

1. Select Node | Change Password to open the Password tab of the Node Properties dialogue box.
2. Enter the old password in the Old SYSOP Password edit box.
3. Enter the new password in the New SYSOP Password edit box.
4. Re-enter the new password in the Confirm SYSOP Password edit box.

A node created during the installation of the internal-directory version of the calendar server will not have a SYSOP password. The password must be set once the node is created. However, a SYSOP password must be set for a node created as part of the calendar server installation when using a directory server.

Other administrative tasks

Use command-line utilities for a variety of other less frequent tasks. For full information on use and syntax, see Reference Appendix C, "Utilities."

Some of the utilities that you may want to be familiar with once the calendar server is up and running are:

• UNIREQDUMP -- to view and delete requests in the Corporate-Wide Services (CWS) queue.

• UNICHECK (UNIX only) -- to verify the presence of all necessary files and directories, and check the settings for permissions, owner and group information.

• UNICLEAN (UNIX only) -- to remove or correct any problems found running unicheck. Transient files will be removed and permission and ownership settings restored to the default.

• UNICLR_IPC (UNIX only) -- to clear Inter-Process Communication (IPC) resources consumed by the calendar server.

See Reference Appendix C, "Utilities," for a description of the function and syntax of all utilities included with the calendar server.