Server Administration

This chapter describes how to manage the CorporateTime Server. All administrative tasks and procedures are executed using command line utilities, the CorporateTime Server Administrator (an NT-based GUI), or operating system tools.

This chapter documents the following administrative procedures:

• Starting and stopping CorporateTime Server
• Checking CorporateTime Server status
• Viewing current user activity
• Changing the SYSOP (node) password
• Other administrative tasks

Starting and stopping CorporateTime Server

If you are using the LDAP-enabled version of CorporateTime (the users/unison/misc/unison.ini parameter [DAS] enable=TRUE), your Directory Server must be running before starting CorporateTime Server. Also, if you have enabled mail notifications, a mail server should be running.

CorporateTime Server is started or stopped by executing one of the following procedures:

CorporateTime Server is started using the shell script unistart and stopped using the script unistop. For full instructions on the use and syntax of these scripts, see Appendix G.

Example

To start the CorporateTime Server (bringing up four daemons if using an internal directory and five daemons with the external directory option), you would execute the following command:

Example

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

Admin tool

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

1. Select Services | Properties to open the Local Services dialogue box
2. Select a CorporateTime service and click Start or Stop depending on the desired action.
3. Click Close

Dependencies among the five 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 the five services in one action

From the Services Control Panel (Start Menu | Settings | Control Panel | Services), stop the five CorporateTime Server services: CorporateTime Engine, CorporateTime Lock Manager, CorporateTime Corporate-Wide Services, CorporateTime Synchronous Network Connections and CorporateTime Directory Access Server (uniengd, unilckd, unicwsd, unisncd and unidasd)

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

Checking CorporateTime Server status

To view the current status of the CorporateTime Server daemons/services and servers run the unistatus utility from the command line. See unistatus in Appendix G for complete instructions and syntax.

Example

To verify the status of the CorporateTime Server and its daemons, run the following command:

unistatus: the calendar server is up

Viewing current user activity

To view the current status of connected CorporateTime users, run the uniwho utility. See uniwho in Appendix G for complete instructions and syntax.

Example

To determine the logged-on users for CorporateTime, execute:

Changing the SYSOP (node) password

To change the password of the SYSOP or any other user on a CorporateTime node, run the unipasswd utility from the command line. See unipasswd in Appendix G for complete instructions and syntax.

Example

To change the password for node 34, execute:

Enter old password: *****

Enter new password: *******

Re-enter new password: *******

Admin GUI

From the CorporateTime Server Administrator:

1. Select Node | Change Password to open the Node Properties dialogue box at the Password tab.
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.
5. Click OK.

Other administrative tasks

A number of less common CorporateTime Server administrative tasks are also performed from the command line using utilities. For full instructions on the use and syntax of these utilities, see Appendix G.

Some of the utilities that an administrator may want to be familiar with once the CorporateTime Server is up and running are:

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

• unicheck - to verify the presence of all necessary files and directories, and check the settings for permissions, owner and group information.

• uniclean - 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 - to clear IPC (Inter-Process Communication) resources consumed by the CorporateTime Server system.

See the table at the front of Appendix G for a short description of the function of all scripts included with CorporateTime Server.