IBM DISA e-collaboration manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of IBM DISA e-collaboration, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of IBM DISA e-collaboration one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of IBM DISA e-collaboration. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of IBM DISA e-collaboration should contain:
- informations concerning technical data of IBM DISA e-collaboration
- name of the manufacturer and a year of construction of the IBM DISA e-collaboration item
- rules of operation, control and maintenance of the IBM DISA e-collaboration item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of IBM DISA e-collaboration alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of IBM DISA e-collaboration, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the IBM service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of IBM DISA e-collaboration.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the IBM DISA e-collaboration item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    DISA e-collaboration Workstation Preparation & New User Getting Started Guide Version 1.8a Copyright IBM Corporation 2008[...]

  • Page 2

    Workstation Preparation & New User Getting Started Guide Page 1 of 51 Table of Contents 1. ................ 2 QUICK START - TO CONFIGURE YOUR WORKSTATION FOR E-COLLABCENTER 2. ........................................................................................................ 4 INTRODUCTION & OVERVIEW 3. ................................[...]

  • Page 3

    Workstation Preparation & New User Getting Started Guide Page 2 of 51 1. Quick S t art - T o Configure Y our Workst ation for E-CollabCenter NOTICE : Our Unclassified w as upgraded in August 2007 to be compliant w ith FIPS 140-2. The upgrade requires Sun Java release 1.5.0, update 12. If y ou are using the SameTime Thick Client, a compatible ve[...]

  • Page 4

    Workstation Preparation & New User Getting Started Guide Page 3 of 51 d. then click the Internet z one, then click on “Custom Level” e. go under the ActiveX controls and plugins section f. ensure the “Binary and Script behaviors” radio button is enabled g. Click OK 8. All ports necessary to access E-CollabCenter mu st be opened in your [...]

  • Page 5

    Workstation Preparation & New User Getting Started Guide Page 4 of 51 2. Introduction & Overview This document provides instructions to optimize a user’s local workstation, ensuring optimal readiness before logging in to E-CollabCenter. Once logged in, you will find a selection of training courses to take you from beginner to advanced pro[...]

  • Page 6

    Workstation Preparation & New User Getting Started Guide Page 5 of 51 3. Wo rkst ation Hardware requirements See pages 16 & 17 in the Sametime 7.5 Critic al Fix 1 (CF1) release notes on NIPRNet: http://www.elink.ibmlink.ibm.com/publicati ons/servlet/pbi.wss?CTY=CA&FNC=SRX&PBL=G325258501# The workstation (also known as client) system[...]

  • Page 7

    Workstation Preparation & New User Getting Started Guide Page 6 of 51 3.1 Additional client requirements for audio/video 3.1.1 Sound card or chip - A full-duplex sound card is required to participate in interactive audio/video meetings. Sound cards and cameras that work wi th the Multimedia Services are listed below.  CrystalWare (integrated[...]

  • Page 8

    Workstation Preparation & New User Getting Started Guide Page 7 of 51 3.2 Verifying the Sy stem Audio and Microphone are Enabled It is important that your loca l operating system has all sound devices enabled and volume levels configured properly prior to enter ing the E-CollabCenter portal. • Verify all sound peripherals (headsets, speakers,[...]

  • Page 9

    Workstation Preparation & New User Getting Started Guide Page 8 of 51 • When the Volume Control window displays 4. Verify the following settings: • Volume levels are high • All Mute boxes are unchecked 5. When the recording playback window displays: • Adjust all volume levels to a high level • Check the Select button for Microphone o [...]

  • Page 10

    Workstation Preparation & New User Getting Started Guide Page 9 of 51 4. Client Sof tware requirements This section describes the software requirement s for the workstation t hat is accessing the e- collabcenter.com web site. The workstation is sometimes referred to as a client machine . Ensuring that your workstation meets these softw are requ[...]

  • Page 11

    Workstation Preparation & New User Getting Started Guide Page 10 of 51 is based on Air Force customization of the S pecialized Security-Limited Functionality (SSLF) recommendations in NIST SP 800-68 and DoD customizati on of recommendations in Microsoft’s Security Guide for Internet Explorer 7.0. The SDC is used by the USAF as a customized ve[...]

  • Page 12

    Workstation Preparation & New User Getting Started Guide Page 11 of 51 JRE 1.5.0, Update 12 NIPRNet: http://java.sun.com/javase/downloads/index_jdk5.jsp SIPRNet: https://patches.csd.disa.sm il.mil/metadata.jsp?ID=76827 JRE 1.6.0, Update 3 (Latest version as of 20 February, 2008) NIPRNet: http://www.java.com/en/download/ SIPRNet: https://patches[...]

  • Page 13

    Workstation Preparation & New User Getting Started Guide Page 12 of 51 4.5.1 Enable TLS 1.0 in Java JRE 1.5.0 and later TLS 1.0 must be enabled in the Sun Java Control Panel. There are two ways to do this: 1) Via Java tea-cup icon To do this, right-click on the Java icon (Tea cup) and select “Open Control Panel.” Click on the Advanced Tab. [...]

  • Page 14

    Workstation Preparation & New User Getting Started Guide Page 13 of 51 2) Via Control Panel 1. Click on Start 2. Highlight Settings 3. Click on Control Panel 4. Double click on Java 5. Select the Advanced tab 6. Click the “+” sign at left of Security to expand o Once expanded the “+” changes to “-“ 7. Select/Check Use TLS 1.0 (See s[...]

  • Page 15

    Workstation Preparation & New User Getting Started Guide Page 14 of 51 Internet Explorer 4.6.1.1 Cookies You must have enabled cookies for either the www. e- c o ll ab c e nt er .c o m (NIPRNet) or the www. e- collabcenter.nces.dod.smil.mil (SIPRNet) or if you are using an enclav e have cookies enabled for the URL to that enclave site. The foll[...]

  • Page 16

    Workstation Preparation & New User Getting Started Guide Page 15 of 51 4.6.1.2 Sun Java To verify if the Internet Explorer browser is configured to use Sun Java:  Usually IE (Internet Explore r) uses Microsoft’s Virtual Machine by default. To change this, from an IE browser, click on Tools>Internet Options  Click on the ‘Advanced?[...]

  • Page 17

    Workstation Preparation & New User Getting Started Guide Page 16 of 51 4.6.1.3 TLS 1.0 Now verify that Internet Explorer has TLS 1.0 Enabled (a government requirement to satisfy FIPS 140-2 encryption) • Launch Internet Explorer • click on Tools>Internet Options • Click on the ‘Advanced’ tab and verify that TLS 1.0 is checked (by de[...]

  • Page 18

    Workstation Preparation & New User Getting Started Guide Page 17 of 51 The default IE settings have “Binary and Script Behav ior” enabled, here are instructions on how to enable it. In the Internet Explorer browser under the Ac tiveX Security controls and plug-ins area, the “Binary and Script Behav iors” must be enabled for both meeting[...]

  • Page 19

    Workstation Preparation & New User Getting Started Guide Page 18 of 51 4.6.2 Firefox 4.6.2.1 Sun Java To verify if the Firefox browser is configured to use Sun Java do the follow ing: 1. Launch Firefox , then select… 2. Tools …. Options... 3. Then make sure “Enable Java” is check ed. If not checked, check it and click OK 4. Close down a[...]

  • Page 20

    Workstation Preparation & New User Getting Started Guide Page 19 of 51[...]

  • Page 21

    Workstation Preparation & New User Getting Started Guide Page 20 of 51[...]

  • Page 22

    Workstation Preparation & New User Getting Started Guide Page 21 of 51 4.6.3 Mozilla 4.6.3.1 Sun Java To verify if the Mozilla browser is configured to use Sun Java do the follow ing: 1. Launch Mozilla , then select… 2. Edit …. Preferences... Advanced 3. Then make sure “Enable Java” is check ed. If not checked, check it and click OK 4. [...]

  • Page 23

    Workstation Preparation & New User Getting Started Guide Page 22 of 51 5. File Upload Size Limit ations In meetings, chat rooms, and instant message sessi ons, there are limits on attachment sizes. • For Web Conferences, the prac tical size limit is 20 MB. • Chat Rooms have a 10 MB file size limit that the users cannot exceed • Instant Me[...]

  • Page 24

    Workstation Preparation & New User Getting Started Guide Page 23 of 51 6. Network Requirement s The access statements (rules) for firewalls, and all packet forwarding or filtering devices, need to be in place in order to use the E- CollabCenter service are listed below. The NIPRNET Destination IP addresses are: 216.12.152.1 through 216.12.152.1[...]

  • Page 25

    Workstation Preparation & New User Getting Started Guide Page 24 of 51 For an end user to determine if their workstation can communicate to the collaboration service over UDP, have the user attend a meeting or go to the Support Tab and click on the Attend a Test Meeting. Then click View …. Meeting Room Status Log from the top menu In the brow[...]

  • Page 26

    Workstation Preparation & New User Getting Started Guide Page 25 of 51 7. T rouble Shooting If you are having problems accessing the service and you have verified you have the proper Sun JRE and you browser settings are correct please perform t he following steps. If you encounter a problem that you cannot correct using the st eps below, please[...]

  • Page 27

    Workstation Preparation & New User Getting Started Guide Page 26 of 51 1) Control Panel > Java > General tab > Delete Files... 2) All checkboxes must be checked, hit OK[...]

  • Page 28

    Workstation Preparation & New User Getting Started Guide Page 27 of 51 If problems still exist, ask the client to send the Java Console log to the NCES Help Desk . How to view the Java console log>>> Right-click on the Java icon (Tea cup) and select ‘O pen Console’ to bring up the java console log. Contact List ‘Aw areness’ doe[...]

  • Page 29

    Workstation Preparation & New User Getting Started Guide Page 28 of 51 This document is a user workstation requirements document designed to provide general software, hardware and configuration requirement s for workstations for the e-co llaboration solution that is based upon Sametime 7.5.1 FIPS. For more detailed information and support regar[...]

  • Page 30

    Workstation Preparation & New User Getting Started Guide Page 29 of 51 APPENDIX A A.1 Steps to Test your Audio/Video Capabilities Prior to Entering a Web Conference (performed within the E-CollabCenter portal) • Log into E-CollabCenter and select the Web Conferencing tab • Click the Test Meeting link • For a few second the following Test [...]

  • Page 31

    Workstation Preparation & New User Getting Started Guide Page 30 of 51 5. Click File … Leave Meeting to leave the test and close this window Please Note: The following support options are available once you have logged into E- CollabCenter • IBM E-CollabCenter Training o Log into the portal at https://www.e-collabcenter.com , then click on [...]

  • Page 32

    Workstation Preparation & New User Getting Started Guide Page 31 of 51 A.2 Additional Details on Microsoft’ s Binary and Script Behavior Internet Explorer defines "inter active controls" as Java or Ac tiveX components which provide user interfaces. IBM Lotus Sametime does not use ActiveX controls but does use Java applets for chat r[...]

  • Page 33

    Workstation Preparation & New User Getting Started Guide Page 32 of 51 B.3 Run the Group Policy Editor as an Admin Go to the “Start” menu Type in “gpedit.msc” as seen below:-[...]

  • Page 34

    Workstation Preparation & New User Getting Started Guide Page 33 of 51 Right-click on the “gpedit” program as seen below and select “Run as administrator”[...]

  • Page 35

    Workstation Preparation & New User Getting Started Guide Page 34 of 51 Click “Continue” to proceed with usi ng the Group Policy Editor as an Admin[...]

  • Page 36

    Workstation Preparation & New User Getting Started Guide Page 35 of 51 B.4 Edit Internet Explorer’s Java security settings Under the Group Policy Editor go to:- “Computer ConfigurationAdministrative TemplatesWindows ComponentsInternet ExplorerInternet Control PanelSecurity PageTrusted Sites ZoneJava Permissions” AND “Computer Con[...]

  • Page 37

    Workstation Preparation & New User Getting Started Guide Page 36 of 51 B.5 Change Java Permissions By default under FDCC, java permissions is set to “enabled”, but the permission level is set to “disable java”. This setting disables the use of any java based application on the machine as in Sun JRE, and not just Microsoft JVM. This Inte[...]

  • Page 38

    Workstation Preparation & New User Getting Started Guide Page 37 of 51 To access and use Sametime services on E-Collabc enter portal, the above Java Permission settings must be changed to either ONE of the following options 1. Java Permissions set to “Disabled” 2. Java Permissions set to “Enabled: High” (most secure and recommend option[...]

  • Page 39

    Workstation Preparation & New User Getting Started Guide Page 38 of 51 Java Permissions set to Enabled, with High, Medium, or Low B.6 Update Group Policy as an Admin Open the command prompt as an Admin, and run the following command: “gpupdate /force” For changes to take affect, a Windows restart is recommended. Refer to the screenshots bel[...]

  • Page 40

    Workstation Preparation & New User Getting Started Guide Page 39 of 51 Right-click on the “Command Prompt” shortc ut, and select “Run as administrator”[...]

  • Page 41

    Workstation Preparation & New User Getting Started Guide Page 40 of 51 If the command prompt is not listed under the Start Menu, type “cmd” under “Sta rt Search” box in the Start Menu Click “Continue” to use the Command Prompt as an Admin[...]

  • Page 42

    Workstation Preparation & New User Getting Started Guide Page 41 of 51 Type in the command “gpupdate /force” and hit Enter When the “OK to Restart?” prompt appears, type “y” and hit Enter *Note that SDC v2.0.4 a restart was not prompted or required.[...]

  • Page 43

    Workstation Preparation & New User Getting Started Guide Page 42 of 51 Click “Close” or simply wait a few seconds for the Windows OS to restart Once the FDCC/SDC machine’s Wi ndows Vista OS has been restarted, all group policy changes will have taken effect. B.7 Add E-CollabCenter to Trusted Sites in IE 7 Click on Start and type regedit i[...]

  • Page 44

    Workstation Preparation & New User Getting Started Guide Page 43 of 51 Click on “Continue”[...]

  • Page 45

    Workstation Preparation & New User Getting Started Guide Page 44 of 51 Go to HKEY_Local_Machine - Software - Policies - Microsoft - Windows - Current Version - Internet Settings (Any of the following 3 items should be = 0) - Security_HKLM_only - Security_Options_Edit - Security_Zones_Map_Edit *Note that once you are done with this appendix you [...]

  • Page 46

    Workstation Preparation & New User Getting Started Guide Page 45 of 51 Now run Internet Explorer 7 as admin and click on “Tools” then “Internet Options”[...]

  • Page 47

    Workstation Preparation & New User Getting Started Guide Page 46 of 51[...]

  • Page 48

    Workstation Preparation & New User Getting Started Guide Page 47 of 51 Click on the “Security” tab and then highlight “Trusted sites” and click on the “Sites” button[...]

  • Page 49

    Workstation Preparation & New User Getting Started Guide Page 48 of 51 Add “*.e-collabcenter.com” and make sure you uncheck the box at the bottom Now you are done adding E-CollabCenter to your trusted sites zone and ready to use E-CollabCenter![...]

  • Page 50

    Workstation Preparation & New User Getting Started Guide Page 49 of 51 Document Information and Revision History Revision Date Author / Editor Nature of Change 1.0 Feb 22, 2007 Jim Stroud Initial Draft 1.1 Feb 28, 2007 Jim Stroud Corrected information on how to determine if UDP ports are in use w/ Sametime 7.5 1.2 March 14, 2007 Jim Stroud Upda[...]

  • Page 51

    Workstation Preparation & New User Getting Started Guide Page 50 of 51 1.7h July 17, 2007 Neil Starkey Misc corrections 1.7i July 25, 2007 Ames Trebing James Stroud Added notice for network changes to network systems: firewalls, packet forwarding and filtering devices. Added TLS java setting to summary. Added info that on the conflict with IWS [...]