How to Setup E-mail with StarTeam 4.0 and StarTeam 4.1



How to Setup E-mail with StarTeam 4.0 and StarTeam 4.1


Information in this Brief applies to:

  • StarTeam 4.0, 4.1
  • Windows Platforms


It is important to note that the StarTeam Server is not an e-mail server. It is only an e-mail client. Users make requests that e-mail be sent through their StarTeam clients, then the StarTeam Server sends those e-mails through an e-mail profile setup on the same machine as the StarTeam VirtualTeam Server.


  1. Make sure that the system you install StarTeam Server can connect to your e-mail server. Please use the following steps below to check if e-mail is enabled for the computer.
    • Go to Control Panel and locate Mail and FAX icon (Your icon may just be called Mail).
    • Please make sure that the Mail and FAX Services is not empty.
  2. The StarTeam Server will use the Mail and FAX user profiles stored on the computer to connect to the Mail Server. This profile must be named "StarTeam", spelled exactly that way without the quotes.
  3. The users in the User Manager need to have valid e-mail addresses in the system.
  4. Creating StarTeam profile in the Mail and FAX Icon.
    • Go to Control Panel and double click on the Mail and Fax icon.
    • Click on the Show Profiles.
    • Either copy the existing Profile and change the name to StarTeam or add a new profile in the Mail and FAX Icon.
    • Click on the Show Profiles.
    • Click on the Add button.
    • Select the Service that matches your e-mail Server.
    • Enter the Profile Name.
    • Fill-in information about your e-mail server and connect.
  5. In the StarTeam Server configuration screen, under the general Tab, make sure you have checked "Enable e-mail support".
  6. Verify that all users who will be using e-mail have a valid e-mail address specified in their user properties. The includes the user sending the mail as well as the user(s) receiving the mail.
  7. If you are going to use Microsoft"s "Internet Mail" service, or POP3, you will want to install a MAPI compliant client like Microsoft Outlook. This is due in part to the way these services work. Your MAPI client, connected to the same profile as StarTeam server (i.e. StarTeam) has to be running as an application while the StarTeam VirtualTeam Server is trying to send mail. A MAPI client is also a good way to check and see if StarTeam is sending your e-mails correctly. If you send an e-mail in StarTeam, go to your MAPI client and see if the mail is waiting in the outbox or the sent box of the MAPI client. If the email has made it that far, it is just a matter of fine tuning your profile to get the e-mail to its final destination. (There is probably a setting such as a server address that is not right in your e-mail profile).
  8. Finally, it is easier to set up e-mail and to perform e-mail tests while the StarTeam Server is running as an application. If you want to run the StarTeam server as an NT Service, try getting e-mail working as an application then start StarTeam as an NT service. Due to the limitations of the POP3/Internet service, the StarTeam server may not be able to run as an NT service at all while serving e-mail.

MS Exchange Servers

Some special care needs to be taken when setting up a StarTeam server to work with MS Exchange.

  1. Where StarTeam Server is installed please check the Mail and FAX icon in the Control Panel and make sure that MS Exchange Server item is in the Services tab. Please use the following stepa to add the MS Exchange Server to the computer if the Exchange Server Services isn"t installed.
  2. Click on the Add button; this will bring up a list of Mail Services select the MS Exchange Server Service to install the MS Exchange Server.
  3. Enter the Name of the Exchange Server and a mailbox of a user in the Exchange Server then click on OK button.
  4. Click on the Delivery tab and make sure that the system is sending mail to a mailbox on the MS Exchange Server.

StarTeam Team Requirements

  1. When you are using the Exchange Server the users in the StarTeam User Manager needs either the X400 or internet e-mail address in the users e-mail address box.
  2. You may want to create a mailbox that StarTeam can use named StarTeam.
  3. If you run the StarTeam server as an NT service. You will need to go into the services applet in control panel, select the StarTeam VirtualTeam Server 4.0 service, and click Startup. Click This Account and add a user. This user must have administrative rights to the NT machine StarTeam is running on. In addition, the name and the password of this user must be identical to the name and the password of the account created for StarTeam on the Exchange server. So if the Exchange server e-mail account is user=:StarTeam, password=:StarTeam, then the NT service must specify the same values. In addition, this user must also be created in the user manger for NT, and be a member of your domain, if you have a domain.
Old KB# 28390
Comment List