Deployment Example: Sun Java Communications Suite 5 on a Single Host |
Deployment Example: Sun Java Communications Suite 5 on a Single Host
Part Number 820-0086-11
This deployment example describes how to install Sun Java Communications Suite 5 software on one computer for a functioning deployment. This document is intended for any evaluator, system administrator, or installation technician who wants to install and evaluate the services delivered by these components.
Caution
This evaluation has been verified in many different environments. However, every deployment is unique, so you may not experience a completely trouble-free installation. See Known Issues and Limitations for known problems.
This deployment example contains the following sections:
Deployment Example Revision History
Table 1 Revision History
Date
Description of Changes
May 30, 2007
Fixed commands to stop and start the Web Server Administrator in Starting and Stopping Communications Services.
March 2007
Initial release of this document.
Summary of ChangesThe following describes the changes that have occurred from the Sun Java System Communications Services 6 2005Q4 single host installation example (as described in Deployment Example: Sun Java Communications Services 2005Q4 on a Single Host):
- Portal Server is no longer installed.
- Solaris Operating System (OS) 10 is used.
- Hosted domains are now configured.
- All Communications Express UI rendering elements are now deployed in the same web container to support Single Sign-On. As a result, Access Manager is no longer required for Communications Express and there are fewer configuration settings that you have to enter
About This Deployment ExampleThis section provides an overview of this deployment scenario, the hardware and software used, and the procedures you follow to install, configure, and use this deployment.
This section contains the following topics:
Installation Overview
This scenario results in a functioning deployment suited for the evaluation and testing of Sun Java Communications Suite 5. These instructions are not intended to act as a replacement for the individual component documentation, but to merely guide the evaluator through an initial installation.
What Components Are Installed?
This example guides you through installing the following Communications Suite and Java Enterprise System components:
- Sun Java System Messaging Server 6.3
- Sun Java System Calendar Server 6.3
- Sun Java System Instant Messaging 7.2
- Sun Java System Communications Express 6.3
- Sun Java System Directory Preparation Tool 6.4
- Communications Services Delegated Administrator 6.4
- Sun Java System Web Server 7.0
- Sun Java System Message Queue 3.7 UR1
- Sun Java System Access Manager 7.1
- Sun Java System Directory Server Enterprise Edition 6.0
- All Shared Components
The example installation in this document uses the following data that you change according to your installation and test machine:
This example installs all of the software on a single system. Adjust host names accordingly if you install the components on multiple systems.
Recommended Ports
For convenience, this example uses a set of recommended ports. If you use different ports, be sure to make the changes consistently throughout the installation. For example, this document uses port 8800 for the Web Server admin port. If you decide to use port 3333 instead, be sure to change it everywhere 8800 occurs in the deployment example. See Table 4 for more information.
Note
Unless otherwise indicated, all of the examples and instructions in this document assume that you are logged in as root.
Implementation Specifications for This Example
This section describes implementation specifications for this example.
Table 3 Client Software Requirements
Component
Platform Requirement
Browser
Netscape Communication 7.1, Internet Explorer 6.0 sp4+, or Mozilla 1.7.12, Firefox 1.0.7
Installation Time Estimates
The following table provides time estimates for installing this example.
Table 5 Installation Time Estimates
Phase
Number of Hours
Solaris 10 OS with Language Support
2
Software installation
1
Software configuration
2
Total
5 hours (average)
As part of the configuration, you will use Delegated Administrator to add data to Messaging Server and Calendar Server.
Installation Notes and Recommendations
Expected User Input
During installation, your are prompted for various input. User input is indicated by text of the form <user-input>. The following table helps you plan for the types of information you must provide during installation.
Summary of Installation and Configuration
Installing and configuring this example involves the following high-level steps:
- Preparing the system for Sun Java Communications Suite
- Running the Java ES installer and selecting the necessary components
- Installing Messaging Server, Calendar Server, Communications Express, Delegated Administrator, Instant Messaging, Web Server, Directory Server, and Access Manager software
- Configuring Delegated Administrator
- Configuring Messaging Server
- Configuring Calendar Server
- Configuring Communications Express
- Configuring Instant Messaging
- Configuring users
Installing the ExampleThis section describes how to install and configure components on a single machine for evaluation purposes. Some components are configured after installation, using component configuration tools.
This section contains the following topics:
Checking Installation Requirements
Before you install components, use the steps in this section to make sure the computer on which you are installing is ready.
To Check System Requirements
The computer should meet the following requirements:
To Check DNS
Verify that DNS is running and configured properly:
- Make sure that the /etc/resolv.conf file has name server entries with the IP addresses of valid name servers. For example:
domain comms.beta.com
nameserver 192.168.100.22
nameserver 192.168.100.23
nameserver 192.168.100.24
nameserver 192.168.100.25
- Make sure that the /etc/hosts file has an entry for the fully qualified host name of the server. This fully qualified host name should be listed before the non fully qualified host name. For example:
- Make sure that the /etc/nsswitch.conf file is configured to use files first to resolve host names. The hosts line in the nsswitch.conf file should list files first in its entry:
To Unzip the Sun Java Communications Services Zip Files
Installing the Components
You install Communications Suite components by running the Java Enterprise System installer.
To Start the Installer
- Log in as root to the machine on which you are installing Communications Suite software.
- Change to the /tmp/JCS5 directory where you stored and unzipped the Communications Suite zip files.
- Change to the java_es-5_commsuite directory
- Change to the Solaris_sparc platform directory.
- Start the Java Enterprise System installer in graphical mode.
./installer &
- Click Next at the Welcome page.
- Accept the license.
Note
Solaris OS 10 installs an earlier version of the Message Queue (and possibly other software). You may need to upgrade this product prior to installing Communications Suite software. The Java ES installer detects that your system has an earlier version of a product and may present you with an option to Upgrade Existing Software. If you are presented with this option, continue with Step 8 that follows this note. If you are not presented with this option, skip to Step 19. If you are presented with the upgrade option, simply select the item to be upgraded and run the Java ES installer to upgrade the component. After the installer upgrades the component (or components), you can quit the installer then restart it to install the remaining Communications Suite components. Then you need to repeat the preceding steps.
- Select the Upgrade existing software radio button then click Next to continue.
- Select the following products then click Next:
- Click Next to upgrade shared components.
- The installer verifies system requirements. When the installer finishes, click Next.
The installer displays the Ready to Upgrade window.
- Click Next.
- Deselect the registration checkbox then click Install.
The upgrade begins. When the upgrade finishes, the Installation Complete page appears.
- Click Close to exit the installer.
- Restart the Java Enterprise System installer in graphical mode.
./installer &
- Click Next at the Welcome page.
- Accept the license.
The Choose to Upgrade window appears.
- Select the Install new software radio button then click Next to continue.
- Select the following products then click Next to Continue.
- Sun Java System Messaging Server 6.3
- Sun Java System Calendar Server 6.3
- Sun Java System Instant Messaging 7.2
- Sun Java System Communications Express 6.3
- Sun Java System Directory Preparation Tool 6.4
- Communications Services Delegated Administrator
- Sun Java System Web Server 7.0
- Sun Java System Message Queue 3.7 UR1
- Sun Java System Access Manager 7.1 (only the required software; no Client SDK)
- Sun Java System Directory Server Enterprise Edition 6.0 (Core, Control Center, Command-Line Utility)
- All Shared Components
- Some versions of Solaris require that the Java SE SDK be upgraded prior to installation. If you are prompted to upgrade the Java SE SDK, choose the default selection to automatically upgrade the SDK to the version included with the installer. Then click Next to continue.
- Click Next to upgrade shared components.
- Specify the installation directories.
Locations:
- Directory Preparation Tool: /opt/SUNWcomds
- Directory Server: /opt/SUNWdsee
- Access Manager: /opt (will create /opt/SUNWam)
- Web Server: /opt (will create /opt/SUNWwbsvr7)
- Web Server Instance: /var/opt/SUNWwbsvr7
- Instant Messaging Server: /opt (will create /opt/SUNWiim)
- Messaging Server: /opt/SUNWmsgsr
- Calendar Server: /opt (will create /opt/SUNWics5)
- Delegated Administrator: /opt/SUNWcomm
- Communications Express: /opt/SUNWuwc
- Accept the target directories for each product and click Next.
- The installer verifies system requirements, such as memory, disk space, and operating system patches. When done click Next.
- Choose Configure Now then click Next.
- The installer lists the components that must be configured after installation. This document informs you of the order in which to do so.
- Click Next to configure the remaining components. You configure these components as part of the installation process.
Continue with the following procedures to input the appropriate information for each of these products when prompted by the installer.
To Select Common and Web Server Settings
This installation assumes the use of Sun Java System Web Server. You can choose an alternate web container but that is beyond the scope of this document.
- In the Account Preferences Panel, you are asked whether or not you want to use your UserID and Password information for all administrator accounts, or if you want to provide administrator account information for each component.
Choose the All Administrator Accounts option and type admin for the Administrator User ID and adminpass for the Administrator Password then click Next.
- The installation script prompts for a series of options. The following table shows how to respond to the Common and Web Server configuration options.
To Select Directory Server Settings
- The following table shows how to respond to the Directory Server configuration options.
To Select Access Manager Settings
- The following table shows how to respond to the Access Manager configuration options.
To Install the Software
To Verify the Installation
Once the installation has completed, start LDAP and verify that it works.
- Verify that you can log in to the Access Manager console as amadmin. The URL for the Access Manager console is:
http://fully-qualified-hostname:web-server-port/amconsole
In this example, type:
http://wireless.comms.beta.com/amconsole
Use amadmin and adminpass as the user ID and password.
- After verifying that you can log in to the Access Manager console, log out.
- Proceed to Configuring Components for instructions on how to configure Communications Suite components.
Uninstalling the Components
After you complete your evaluation, you can use the Java Enterprise System uninstaller to remove the components that you installed. See the Sun Java Enterprise System 5 Installation Guide for UNIX:
Configuring ComponentsThis section describes how to configure and start the components that you use in this example deployment.
This section contains the following topics:
Before You Begin
Before you configure the Messaging Server software, you need to create the mailsrv user and disable the sendmail process. The mailsrv user is used in Configuring Messaging Server.
To Create the mailsrv User
- Messaging Server requires a mail server user, which must exist before you can finish the installation. You can skip this step, because the group and user are created during the configuration time. However, you might want to create the mailsrv user yourself as shown below. For this installation, use the useradd command to create a user with username mailsrv and group mail. You use this ID in Step d (under Step 2).
Type the following commands to create the user mailsrv with a user ID of 7633, a group ID of mail, and a user home directory of /export/home/mailsrv. (This assumes the /export/home directory already exists.)
To Disable sendmail
Preparing the Directory and Configuring Messaging Server
This section explains how to prepare the Directory Server LDAP schema and configure Messaging Server.
To Apply Schema 2 to Your Directory Tree
- Run the comm_dssetup.pl script:
cd /opt/SUNWcomds/sbin
/usr/bin/perl comm_dssetup.pl
- Type y to continue.
The perl script prompts for a series of options. The following table shows how to respond to the prompts.
- Confirm your choices and type y to continue. The comm_dssetup script proceeds.
- When prompted, type y to continue with script.
Continue with the next section after the comm_dssetup script finishes and displays its “Successful Completion” message.
Configuring Delegated Administrator and Communications CLI
This section describes configuring Delegated Administrator console and utility, which provide user management.
To Configure Delegated Administrator
- Run the configurator script:
cd /opt/SUNWcomm/sbin
./config-commda
- Click Next in the Welcome window.
- Accept the default for the Directory to store User Mgmt data files: [/var/opt/SUNWcomm]
If the directory does not exist, click Create Directory to create the directory.
- Install Delegated Administrator Utility, Console, and Server.
The installation script prompts for a series of options. Use the following table to respond to the configuration options:
- Select Configure Now.
The script begins to run.
- When the panel displays “All Tasks Passed,” click Next to continue.
Two warnings appear: one is remind you to restart Web Server; the other is to remind you to enable the mail and calendar services in the domain. The next steps correct these problems.
- Click Close to complete the configuration.
- Restart Web Server:
cd /var/opt/SUNWwbsvr7/https-wireless.comms.beta.com/bin
./stopserv
./startserv
- Modify the mail and calendar domains, and create users by using the commadmin utility:
Create as many users as you need. Steps later in this document show how to add Presence and Instant Messaging services to those users.
Configuring Messaging Server
This section describes configuring Messaging Server, including configuring the Webmail port.
To Configure Messaging Server
- Run the Messaging Server configure script:
cd /opt/SUNWmsgsr/sbin
./configure
The Configuration Wizard appears. Read the introductory information and proceed by clicking Next.
- Verify the following:
- Fully qualified host name of Messaging Server, FQHN: [wireless.comms.beta.com]
- Directory to store config/data files: [/var/opt/SUNWmsgsr]
When prompted, choose to create the new directory.
- Install MTA, Message Store, and Webmail Server. There is no need to install the Multiplexor for this deployment.
- Name of the mail server Unix user: Unix username [mailsrv]
- Unix group: [mail]
- The installation script prompts for a series of options. Use the following table to respond to the configuration options:
Table 12 Values for Messaging Server configure Script
Option
[Default Value]
Enter:
User/Group Server LDAP
[ldap://wireless.comms.beta.com:389]
accept default
Bind As
[cn=Directory Manager]
accept default
Password
--
adminpass
Postmaster email address
--
foo@wireless.comms.beta.com
Password for Messaging Server accounts
--
adminpass
Default email Domain
[comms.beta.com]
accept default
Organization DN
[o=comms.beta.com,o=isp]
accept default
- Click Next, then click Configure Now.
You will receive an error about the Webmail port being in use. Click OK to acknowledge this message. The configuration begins. The following step corrects the Webmail port problem.
- When the configuration is finished, click Next to continue, then click Close to exit.
Note
You might observe a failure such that not all the messaging configuration tasks have passed. If this is the case, rerun the Messaging Server configuration script by repeating all the steps above. When prompted for the directory to store configuration or data files, use the same directory as before. A popup window will state that this directory already exists. Click Accept Anyway to verify that the same directory will be used.
- Configure the Webmail port:
/opt/SUNWmsgsr/sbin/configutil -o service.http.port -v 8080
- Start Messaging Server:
/opt/SUNWmsgsr/sbin/stop-msg
/opt/SUNWmsgsr/sbin/start-msg
- Continue with the next section to configure Calendar Server.
Configuring Calendar Server
This section shows you how to run the Calendar Server configuration script and how to verify the Calendar Server configuration.
To Configure Calendar Server
- Run the Calendar Server configurator script:
cd /opt/SUNWics5/cal/sbin
./csconfigurator.sh
- Click Next at the Welcome page.
- The installation script prompts for a series of options. Use the following table to respond to the configuration options:
Table 13 Values for Calendar Server csconfigure Script
Option
[Default Value]
Enter:
LDAP Server Host Name
[wireless.comms.beta.com}
accept default
LDAP Server Port
[389]
accept default
Directory Manager DN
[cn=Directory Manager]
accept default
Directory Manager Password
--
adminpass
Enable Virtual Domains support
[Checked]
accept default
Virtual Domains setting: Default domain
[comms.beta.com]
accept default
Calendar Administrator Username
[calmaster]
accept default
Calendar Administrator Password
--
adminpass
Calendar Administrator Email address
[calmaster@comms.beta.com]
accept default
Site administrator
[Yes]
accept default
Set up a Front End/Back End deployment
[Unchecked]
accept default
Email Alarms
[Enabled]
accept default
Administrator Email Address
[calmaster@comms.beta.com]
accept default
SMTP Host Name
[wireless.comms.beta.com]
accept default
Service Port
[80]
3080
Maximum Sessions
[5000]
accept default
Maximum Threads
[20]
accept default
Number of server processes
[1]
accept default
Runtime User ID
[icsuser]
accept default
Runtime Group ID
[icsgroup]
accept default
Start Calendar Server after Successful Configuration
[Unchecked]
accept default
Start Calendar Serve on System Startup
[Checked]
Unchecked
Configuration Directory
[/etc/opt/SUNWics5/config]
accept default
Database Directory
[/var/opt/SUNWics5/csdb]
accept default
Attachment Store Directory
[/var/opt/SUNWics5/astore]
accept default
Logs Directory
[/var/opt/SUNWics5/logs]
accept default
Temporary Files Directory
[/var/opt/SUNWics5/tmp]
accept default
Enable Archive
[Checked]
accept default
Archive Directory
[/var/opt/SUNWics5/csdb/archive]
accept default
Enable Hot Backup
[Checked]
accept default
Hot Backup Directory
[/var/opt/SUNWics5/csdb/hotbackup]
accept default
Keep archives for (in days)
[Minimum: 3, Maximum: 6]
accept default
Keep hot backups for (in days)
[Minimum: 3, Maximum: 6]
accept default
Same as archive checkbox
[Checked]
accept default
- Click the Configure Now button to configure Calendar Server.
The Configuration begins and takes less than two minutes.
- Click Next when the configuration is complete.
- Click the Details button to verify that all packages configured correctly. Click the Close button to exit the configurator.
- Start the Calendar Server daemons:
cd /opt/SUNWics5/cal/sbin
./stop-cal
./start-cal
- Continue with the next section to configure Communications Express.
Configuring Communications Express
This section shows you how to run the Communications Express configuration script.
To Configure Communications Express
- Run the Communications Express configurator script:
cd /opt/SUNWuwc/sbin
./config-uwc
- Click Next at the Welcome page.
- Accept the default for Directory to store configuration and data files: [/var/opt/SUNWuwc]
Choose to create the directory when prompted.
- Install the Mail and Calendar Components.
The installation script prompts for a series of options. Use the following table to respond to the configuration options:
Table 14 Values for config-uwc Script
Option
[Default Value]
Enter:
Hostname
[wireless]
accept default
DNS Domain
[comms.beta.com]
accept default
Web Container
[Web Server]
accept default
Web Server Root Directory
[/opt/SUNWwbsvr7]
accept default
Web Server Config Root Directory
[/var/opt/SUNWwbsvr7]
accept default
Web Server Instance Identifier
[wireless.comms.beta.com]
accept default
Virtual Server Identifier
[wireless.comms.beta.com]
accept default
HTTP Port
[80]
accept default
Administration Server Port
[8800]
accept default
Administrator User ID
[admin]
accept default
Administrator Password
--
adminpass
Secure Administration Server Instance
[Unchecked]
accept default
Web Container User ID
[webservd]
accept default
Web Container Group IP
[webservd]
accept default
URI Path
[/uwc]
accept default
Enable Hosted Domain Support
[Unchecked]
Checked (Yes)
URL of Directory Server
[ldap://wireless.comms.beta.com:389/]
accept default
Bind DN
[cn=Directory Manager]
accept default
Password
--
adminpass
DC Tree suffix
[o=isp]
accept default
Default Domain
[comms.beta.com]
accept default
Enable Access Manager for Single Sign-On
[Unchecked]
accept default (not enabled)
Webmail Server Host Name
[wireless.comms.beta.com]
accept default
Webmail Server Port Number
--
8080
Enable login in secure mode
[Unchecked]
accept default (not secure)
Webmail Server SSL Port Number
--
Leave blank
Webmail Admin User ID
--
admin
Admin Password
--
adminpass
Calendar Server Hostname
[wireless.comms.beta.com]
accept default
Calendar Server Port
[9004]
3080
Calendar Admin User ID
[calmaster]
accept default
Calendar Administrator User Password
--
adminpass
URL of PAB Directory Server
[ldap://wireless.comms.beta.com:389]
accept default
Bind As
[cn=Directory Manager]
accept default
Password
--
adminpass
- Click the Configure Now button to configure Communications Express.
- After the configuration is finished, click Next to continue.
The system displays a message to restart the Web Server instance.
- Click OK.
- Click Next to continue.
- Click Close to quit the Communications Express configurator script.
- Restart Web Server:
cd /var/opt/SUNWwbsvr7/https-wireless.comms.beta.com/bin
./stopserv
./startserv
- Continue with the next section to configure Instant Messaging.
Configuring Instant Messaging
Configuring Instant Messaging is important for the completeness of the Sun Java Communications Suite but is not necessary for Communications Express.
To Configure Instant Messaging
- Run the Instant Messaging configurator script:
cd /opt/SUNWiim
./configure
- Read the Software Requirements and click Next to continue.
The Components Selection page appears.
- Verify that both Server components and Client components are selected for configuration then click Next to continue.
The installation script prompts for a series of options. Use the following table to respond to the configuration options:
Table 15 Values for Instant Messaging configure Script
Option
[Default Value]
Enter:
Use Access Manager for Single Sign-On
[Unchecked]
Checked
Use Access Manager for Policy
[Unchecked]
Checked
Where to Store Instant Messaging User Data
On the file system
This selection is disabled
User ID
[root]1
accept default
Group ID
[root]2
accept default
Runtime Directory
[/var/opt/SUNWiim]
accept default
Domain Name
[comms.beta.com]
accept default
XMPP Port
[5222]
accept default
Multiplexed XMPP Port
[45222]
accept default
Disable Server (enable only multiplexor)
[Unchecked]
accept default
LDAP Host Name
[wireless.comms.beta.com]
accept default
LDAP Port Number
[389]
accept default
Base DN
[dc=comms,dc=beta,dc=com]
o=isp
Bind DN
--
cn=Directory Manager
Bind Password
--
adminpass
Enable Email Integration
[Checked]
accept default
SMTP Server
[wireless.comms.beta.com]
accept default
Enable Email Archiving
[Checked]
accept default
Deploy Messenger Resources
[Checked]
accept default
Codebase
[http://wireless.comms.beta.com:80/im]
accept default
Web Administration URL
[https://wireless.comms.beta.com:4849/]
https://wireless.comms.beta.com:8989/
Web Administrator User ID
[admin]
accept default
Web Administrator Password
--
adminpass
Deploy Instant Messaging HTTP Gateway
[Checked]
accept default
Context Root
[http://wireless.comms.beta.com:80/httpbind]
accept default
Web Administration URL
[https://wireless.comms.beta.com:8989/
accept default
Web Administrator User ID
[admin]
accept default
Web Administrator Password
--
adminpass
Enable Calendar Agent
[Unchecked]
Checked
Notification Server Host Name
[wireless.comms.beta.com]
accept default
Notification Server Port
[57997]
accept default
Calendar Alarm URL
[enp:///ics/customalarm]
accept default
Start Services After Successful Configuration
[Checked]
accept default
Start Services When System Starts
[Checked]
accept default
1Access Manager requires that Instant Messaging services be installed and run as user root.
2Access Manager requires that Instant Messaging services be installed and run as group root.
- Click Next to configure Instant Messaging.
It could take a while to complete the configuration.
- At the Configuration Summary page, click Close to exit.
- Continue with the next section to verify the configuration.
Verifying the Configuration
This section describes how to verify the configuration for Communications Express client, Delegated Administrator, and Instant Messenger. You simply verify that you can log in to the various services. After you are satisfied that you can log in, log out.
- In your web browser, open the following URL for the Communications Express client:
http://wireless.comms.beta.com/uwc
- Log in as one of the users created earlier.
If you created a user according to the previous steps, type jdoe for the user name, and demo for the password.
- In your web browser, open the following URL for Delegated Administrator:
http://wireless.comms.beta.com/da/DA/Login
Log in as user admin. The password is adminpass.
- In your web browser, open the following URL for Instant Messenger:
http://wireless.comms.beta.com/im/en/im.jnlp
Login in as user jdoe and password demo.
Note
If you cannot log into Instant Messaging as a user, you might need to manually add the Instant Messaging and Presence Services to the user. See To Add Services to the Lower Level Organization for more information.
- Continue with the next section to configure Access Manager.
Configuring Access Manager
The following procedures enable Access Manager authentication with Instant Messaging, and enable the Instant Messaging services for all users.
To Log In to Access Manager
To Add Services to the Lower Level Organization
If you set your Organization DN to o=comms.beta.com,o=isp, you need to add IM and Presence services to the comms.beta.com organization. Once these services have been added to the suborganization, you add the necessary services to each user in this suborganization.
Note
Previously, you created a set of users with the commcli command. These users exist in the comms.beta.com organization. At this point, there are no Services defined for these users. You need to register the services with these users for them to be able to log in to Instant Messaging.
- Upon logging into the Access Manager console, you are presented with a view of all your organizations. The comms.beta.com organization is listed. Click the link to comms.beta.com.
- In the right pane, you see a list of General Properties. One of these properties is Domain Name. Verify the Instant Messaging domain name that you specified during the Instant Messaging configuration.
In this example, the domain name is comms.beta.com. If the field is blank, type this domain then click the Save button.
- Choose Services from the View menu in the left pane.
- Click the Add button.
- Either click the individual services to add to this organization, or click the box at the top of the list that shows two checkboxes. This selects all the services. Upon selecting all the services, click the OK button to add all the services to the suborganization.
- Within this same suborganization, click the properties icon next to the name of Authentication Configuration.
You see that a template does not exist for these services. Create a new template.
- Click the New button to define a new service instance.
- Type the Instance Name ldap1, then click the Submit button.
The ldap1 service instance is created.
- Click the ldap1 link.
- Click Edit besides Authentication Configuration.
A new window appears.
- Click the Add button to add the LDAP module of this new ldap1 instance and select the LDAP Module Name from the pulldown menu. The Enforcement Criteria should be REQUIRED. Click OK to add the module, then click OK again to save the module properties. Then click Cancel to close the window.
- Click the properties icon next to Core, just below Authentication Modules.
You need to select the ldap1 service for both Administrator Authentication Configuration and Organization Authentication Configuration.
- Click Save.
- Choose Users from the View menu in the left pane.
A list of users is presented. You need to add the services you just registered in this suborganization to each user.
- Click the property icon beside a user.
- In the right pane, open the View drop-down menu and choose Services.
No services are listed.
- Click the Add button.
A list of services appears.
- Click the double-checked box at the top of the list of services to add all services. Then click the OK button.
To Configure User Services
Use this procedure if you want Access Manager services to automatically be added upon user creation. This is useful if you want the Instant Messaging, Presence, and Portal services to be automatically created for each user you create through Delegated Administrator (either the command-line utility or console).
Caution
Try this on a test system first to verify that you don’t have subsequent performance issues.
- In the Access Manager console, from within the comms.beta.com organization, select the Service Configuration tab.
- Click the properties icon beside Administration service.
- In the right pane, scroll down until you see Required Services.
- Add the following services by typing the name of the service in the entry box and clicking Add.
- Add any other services you choose.
- Click Save.
To Configure User Services for All Users in a Given Domain
You can also configure the IM and Presence services for all users in a given domain at once by using the imadmin assign_services command, instead of manually adding the services in the Access Manager console or automatically adding the services upon user creation.
- Run the following commands to add IM and Presence services for all users in a given domain:
# cd /opt/SUNWiim/sbin
# ./imadmin assign_services
Please enter base DN:
o=comms.beta.com,o=isp
Assigning IM and Presence services to users under baseDN: o=comms.beta.com,o=isp ...
Done.
- Restart the web container.
Creating Additional User Accounts and Groups
This section describes how to create additional users accounts and groups. Users and groups created in this fashion work with both Communications Services products and Portal Server (if you add Portal Server to this deployment at a later date).
To Create End User Accounts and Groups
- The following example shows how to create users using the Delegated Administrator command-line utility and also how to create a group consisting of the users created.
/opt/SUNWcomm/bin/commadmin user create -D admin -F Demo -l demo1 -L One -n comms.beta.com -p 80 -w adminpass -W demo -X wireless.comms.beta.com -S mail,cal -E demo1@comms.beta.com -H wireless.comms.beta.com
/opt/SUNWcomm/bin/commadmin user create -D admin -F Demo -l demo2 -L Two -n comms.beta.com -p 80 -w adminpass -W demo -X wireless.comms.beta.com -S mail,cal -E demo2@comms.beta.com -H wireless.comms.beta.com
/opt/SUNWcomm/bin/commadmin group create -D admin -G Demostaff -n comms.beta.com -p 80 -w adminpass -X wireless.comms.beta.com -S mail -E Demostaff@comms.beta.com -H wireless.comms.beta.com -o calmaster -m demo1 -m demo2
To Create User Accounts by Using Delegated Administrator Console
An alternative to using the Delegated Administrator command-line utility to create users is to use the Delegated Administrator console. The high-level steps to create users with Delegated Administrator console are the following:
Prior to using Delegated Administrator, check the resource.properties file to make sure users will be created using options consistent with your usage. Because this example uses a hosted domain scenario, you do not need to edit this file to make changes. If you do want to make changes, perform the following steps.
- Change directories to /var/opt/SUNWcomm/WEB-INF/classes/sun/comm/cli/server/servlet and edit the resource.properties file.
The default settings for servicepackage refresh rates are as follows:
servicepackage-ttlhours=5
servicepackage-ttlminutes=0
These settings establish the time between refreshes of service packages. In a demo scenario, service packages do not change very often so there is no need to refresh them every five minutes. Instead, they are refreshed every five hours. This improves Delegated Administrator performance. If you later decide to change the refresh rate, for example, to 20 hours, then make this change:
servicepackage-ttlhours=20
The default setting for calendar ID type is set using the switch-caltype variable as follows:
switch-caltype=hosted
The caltype can either be hosted or legacy. When you set caltype to hosted, users are created as uid@domain rather than uid, when you use Delegated Administrator to create them.
- The first time you use Delegated Administrator console, you must add service packs to the organization that contains your users. In a web browser, open the URL for the Delegated Administrator console and log in as amadmin (password is adminpass):
http://wireless.comms.beta.com/da/DA/Login
- Click the check box next to the comms.beta.com organization, then click the Allocate Service Package button.
The Allocate Service Package window appears. Service packages are organized within a set of three pages.
- Click the Single Page button (to the right of the Compare button) to map the three pages into a single page view.
- Select the desired service packages.
Choose from among earth, mars, mercury, and venus, because they have mail and calendar services enabled. Each service package has a different mail quota.
- Click Next to continue.
- Accept the Mail Service defaults, then click Next.
- If you chose a service package that contains Calendar, type the Calendar Host wireless.comms.beta.com and Anonymous Login Yes. Then click Next.
- Select the quantity of each service pack desired then click Next.
A quantity of 100 is adequate for demo purposes.
- Review your choices and click Finish.
The service packages are created.
- Once the service packs have been allocated for the domain, you can now add users to the domain. Click the domain link, comms.beta.com.
- Click the New button to create a new user account within this domain.
- Type a First Name (such as Demo), Last Name (such as Five), Display Name (such as Demo Five), then click Next.
- There is no need to type postal information, so click Next.
- Select a service pack for this user, for example, earth, then click Next.
- Type the email address, for example, demo5@comms.beta.com. Mail Delivery Option should be Local Inbox. Leave the other fields blank.
- Click Next.
- Choose your calendar preferences and pick your preferred timezone. Then click Next.
- Type Login ID and Password. In this example, Login ID is demo5 and password is demo.
- Click Next to continue.
- Verify the user information then click Finish to create the user account.
- Log in to Access Manager as amadmin and verify that the IM and Presence services have been added to the newly created user. If not, assign services to those users as described previously in To Add Services to the Lower Level Organization.
Starting and Stopping Communications ServicesThis section describes the commands needed to start and stop all the Communications Services.
To Start and Stop Services
You should stop services before attempting to start them.
- To stop all services:
Table 16 Commands to Stop Communications Services
Service
Command
Instant Messaging
/opt/SUNWiim/sbin/imadmin stop
Access Manager
/etc/init.d/amserver stop
Web Server
/var/opt/SUNWwbsvr7/https-wireless.comms.beta.com/bin/stopserv
Web Server Administrator
/var/opt/SUNWwbsvr7/admin-server/bin/stopserv
Calendar Server
/opt/SUNWics5/cal/sbin/stop-cal
Messaging Server
/opt/SUNWmsgsr/sbin/stop-msg
Directory Server
/opt/SUNWdsee/ds6/bin/dsadm stop /var/opt/SUNWdsee/dsins1
- To start all services:
Table 17 Commands to Start Communications Services
Service
Command
Directory Server
/opt/SUNWdsee/ds6/bin/dsadm start /var/opt/SUNWdsee/dsins1
Messaging Server
/opt/SUNWmsgsr/sbin/start-msg
Calendar Server
/opt/SUNWics5/cal/sbin/start-cal
Web Server Administrator
/var/opt/SUNWwbsvr7/admin-server/bin/startserv
Web Server
/var/opt/SUNWwbsvr7/https-wireless.comms.beta.com/bin/startserv
Access Manager
/etc/init.d/amserver start
Instant Messaging
/opt/SUNWiim/sbin/imadmin start
Evaluating the DeploymentNow that you have installed and configured your single host deployment example, you can begin evaluating and using the email, calendar, and instant messaging services both as an end user and as an administrator.
To use and learn about the Sun Java Communications Suite, see the Sun Java Communications Suite Evaluation Guide at http://docs.sun.com/doc/819-6321. This guide provides a tutorial-type walk through of the key features of the Sun Java Communications Suite, including the Connector for Microsoft Outlook plug-in, the messaging, calendaring, and address book components of the Communications Express UI, and Instant Messaging.
Known Issues and LimitationsThe beta version of Sun Java Communications Suite 5 contains the following known problems:
For more information about known issues, see the Sun Java Communications Services Release Notes at the following URL:
Accessing Sun Resources OnlineThe docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. Books are available as online files in PDF and HTML formats. Both formats are readable by assistive technologies for users with disabilities.
To access the following Sun resources, go to http://www.sun.com:
Sun Welcomes Your CommentsSun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Deployment Example: Sun Java Communications Suite 5 on a Single Host, and the part number is 820-0086-11.
�2007 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, docs.sun.com, AnswerBook, AnswerBook2, Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. This product includes software developed by Computing Services at Carnegie Mellon University (http://www.cmu.edu/computing).
The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
DOCUMENTATION IS PROVIDED ”AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
@2007 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95954 U.S.A. Tous droits res�rv�s.
Ce produit ou document est prot�g� par un copyright et distribu� avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la d�compilation. Aucune partie de ce produit ou document ne peut �tre reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation pr�alable et �crite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel d�tenu par des tiers, et qui comprend la technologie relative aux polices de caract�res, est prot�g� par un copyright et licenci� par des fournisseurs de Sun.
Des parties de ce produit pourront �tre d�riv�es du syst�me Berkeley BSD licenci�s par l’Universit� de Californie. UNIX est une marque d�pos�e aux Etats-Unis et dans d’autres pays et licenci�e exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, docs.sun.com, AnswerBook, AnswerBook2, Java et Solaris sont des marques de fabrique ou des marques d�pos�es, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont bas�s sur une architecture d�velopp�e par Sun Microsystems, Inc. Ce produit comprend du logiciel d�velop� par Computing Services � Carnegie Mellon University (http://www.cmu.edu/computing).
L’interface d’utilisation graphique OPEN LOOK et Sun a �t� d�velopp�e par Sun Microsystems, Inc. pour ses utilisateurs et licenci�s. Sun reconna�t les efforts de pionniers de Xerox pour la recherche et le d�veloppement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun d�tient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant �galement les licenci�s de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences �crites de Sun.
CETTE PUBLICATION EST FOURNIE “EN L’ETAT” ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.