Installation and Administration Guide

Transcription

1 SWIFTNet Interfaces SWIFTAlliance Workstation 6.0 Installation and Administration Guide This guide is intended for the person responsible for installing and administering SWIFTAlliance Workstation. Prior knowledge of using a Windows application is assumed in this guide. 2 January 2007

2 SWIFTAlliance Workstation 6.0 Legal Notices Copyright Copyright S.W.I.F.T. SCRL ("SWIFT"), avenue Adèle 1, B-1310 La Hulpe, Belgium, or its licensors, All rights reserved. You may copy this publication within your organisation. Any such copy must include these legal notices. Confidentiality This publication may contain SWIFT or third-party confidential information. Do not disclose this publication outside your organisation without the prior written consent of SWIFT. Disclaimer SWIFT supplies this publication for information purposes only. The information in this publication may change from time to time. You must always refer to the latest available version. Translations The English version of SWIFT documentation is the only official version. Trademarks SWIFT, S.W.I.F.T., the SWIFT logo, Sibos, SWIFTNet, SWIFTAlliance, SWIFTStandards, SWIFTReady, and Accord are trademarks of S.W.I.F.T. SCRL. Other SWIFT-derived service and product names, including SWIFTSolutions, SWIFTWatch, and SWIFTSupport are tradenames of S.W.I.F.T. SCRL. SWIFT is the trading name of S.W.I.F.T. SCRL. Other product or company names in this publication are tradenames, trademarks, or registered trademarks of their respective owners. 2 Installation and Administration Guide

3 Preface Preface Welcome Welcome to the SWIFTAlliance Workstation Installation and Administration Guide. About SWIFTAlliance Workstation SWIFTAlliance Workstation is a simple, cost-effective way to send and receive messages over the SWIFT network (or telex network, if licensed) using a PC. Computers installed with SWIFTAlliance Workstation can connect to any SWIFTAlliance server running under UNIX or Windows About this guide This guide is intended for the person responsible for installing and administering SWIFTAlliance Workstation. Prior knowledge of using a Windows application is assumed in this guide. This guide is structured as follows: "Introduction" details the requirements that must be met in order to install SWIFTAlliance Workstation. "Installing SWIFTAlliance Workstation" describes the installation and product upgrade steps. "Administration Tasks" describes how to update and configure SWIFTAlliance Workstation. "Troubleshooting" helps to resolve initial problems with SWIFTAlliance Workstation setup and usage. Conventions used in this guide Before you start using SWIFTAlliance documentation, it is important that you are familiar with the following notational conventions: Menu names and field names within windows are printed in bold type, for example, the File menu Window names are printed in bold type and begin with uppercase letters, for example, the Access Control window Source code is printed in Courier font The word "select" means that you select an item in a list or execute a command The word "click" means that you position the cursor on an item and press the left mouse button Reference to titles of other manuals appear in italics 2 January

4 SWIFTAlliance Workstation Installation and Administration Guide

5 Table of Contents Table of Contents 1 Introduction Preliminary Checks System Requirements for SWIFTAlliance Workstation Testing TCP/IP Connectivity With the Server Host Checking Hardware Requirements Windows Group and User Accounts Windows Security Enhancement for SWIFTAlliance Workstation File Permissions Registry Permissions Installing SWIFTAlliance Workstation Installing Workstation for the First Time Installing Workstation and Replacing an Existing Version Installing Workstation and Retaining a Previous Version Administration Tasks Installation Application Window SWIFTAlliance Control Main SWIFTAlliance Control Window TCP Configuration on the SWIFTAlliance Workstation Adding or Modifying an Instance Activating an Instance Removing an Instance Displaying the Active Instance on the Sign-on Window Adding a Server to the "Hosts" File Patches Patch/Upgrade Program Installing Patches Removing Patches Version Info Report Command Prompt Selecting an Earlier Version of Workstation Disabling Microsoft Internet Information Server (IIS) Restarting Microsoft Internet Information Server (IIS) Removing SWIFTAlliance Workstation Removing a Workstation Removing Previous Versions of SWIFTAlliance Workstation Troubleshooting Problems with Workstation/Server Connectivity Problems Logging In When First Using SWIFTAlliance January

6 SWIFTAlliance Workstation Printing Problems on Windows Installation and Administration Guide

7 Introduction 1 Introduction 1.1 Preliminary Checks System Requirements for SWIFTAlliance Workstation Overview The following table describes the system requirements for SWIFTAlliance Workstation: Category Hardware Local area network Peripherals (local or network) Operating system SWIFT Message Standards context sensitive Field Help Paging Space Requirement Intel Pentium III or higher processor. Minimum 17" colour monitor with SVGA resolution (at least 1024 x 768 pixels). A hard disk with a partition of 100 MB (NTFS recommended) of free space (either locally or on a networked file server) to contain SWIFTAlliance Workstation. A LAN adapter (Ethernet or Token Ring) to enable TCP/IP protocol. A CD drive. 3.5 inch diskette drive. Printer. Windows XP Professional. Note: For details of Service Pack levels, please see the release letter of the latest patch. For the SWIFT Message Standards Field Help in the Message Creation, or Message Modification applications, and so on. To function (invoked by pressing F1 function key in a message field), Microsoft Internet Explorer must be installed. For Paging Space, use Microsoft guidelines (1.5 times the RAM of your system). System RAM for SWIFTAlliance Workstation Operating System Minimum Memory Size (MB) Advised Memory Size (MB) Windows XP Professional Minimum Disk Space for SWIFTAlliance Workstation Minimum Software Disk Space (MB) Minimum Database Disk Space (MB) Advised Database Disk Space (MB) 250 not applicable not applicable Testing TCP/IP Connectivity With the Server Host Introduction Ensure that you have TCP/IP connectivity between the workstation and the computer where the SWIFTAlliance servers are installed. 2 January

8 SWIFTAlliance Workstation 6.0 Note If DNS is enabled on your network, TCP/IP connectivity is automatically checked. To test the connection: 1. Start a Command Prompt window. (To start a Command Prompt window, click Start and then select Run. In the Run dialog box, type cmd and click OK ). 2. Type ping <hostname> where <hostname> is the name of the server component. 3. If the TCP/IP connection is working correctly, a response like the following is shown: Pinging <hostname> [IP Address] with 32 bytes of data Reply from [hostname IP Address] If the response fails, contact your Windows system administrator Checking Hardware Requirements Introduction The Setup program checks for the minimum requirements (see "System Requirements for SWIFTAlliance Workstation" on page 7). Before you start installing SWIFTAlliance Workstation, you can also run a program to check that the machine you are installing on meets the minimum requirements. If any problems are detected, you must resolve them before you can install Workstation software. Note SWIFTAlliance Workstation has been qualified on Windows XP Professional in "single user mode". To configure this mode: 1. Log on as Administrator 2. Select Start/Control Panel/User Accounts and Change the way users log on or off 3. Clear Use the Welcome screen 4. Click Apply Options. To check requirements: 1. Log on to Windows as Administrator or as another Windows user that is a member of the local administrator group. 2. Insert the SWIFTAlliance Access/Entry/RMA/Workstation release CD into the CD drive. If the computer you are installing SWIFTAlliance Workstation on does not have a CD drive, you can connect to one over the network. To do this, select Map Network Drive from the Tools directory of Windows Explorer. Confirm beforehand that the target drive on the host machine is set up for sharing. 3. Click Start and Run. 8 Installation and Administration Guide

9 Introduction 4. Type the following command: <drive>:\win32\checkhw WORKSTATION where <drive> is the appropriate drive name, either locally or on the network. An example is shown here: Note Please note that WORKSTATION must be typed in capital letters. 5. After a few moments, a window appears with the results: If the message Not OK to install appears, take the corrective action indicated. A red check mark appears to indicate what failed. For example, if there is a red check mark beside Running as Administrator, it means that you are not signed on with rights as an Administrator. You must sign off and then sign on as a different Windows user with the appropriate rights. If there is a red check mark beside TCP/IP Software Installed, ensure that there is a TCP/ IP connection between the computer where you want to install SWIFTAlliance Workstation and the SWIFTAlliance server. Close the window to terminate the program. 2 January

10 SWIFTAlliance Workstation 6.0 Note Unless stated otherwise, you cannot install SWIFTAlliance Workstation until all the checks are passed. 1.2 Windows Group and User Accounts Description The SWIFTAlliance Workstation software provides the option during installation to allow the configuration of group and user accounts for the Windows operating system. If this option is chosen, two groups are created, and each group has one user. The groups are Alliance Administrators and Alliance Users. The users are AllAdm and AllUsr. Both users get the Windows right to log on locally to the PC where SWIFTAlliance is installed. Furthermore, AllAdm is a member of the Windows administrators group. Note If group or user accounts already exist with these names, they are not updated during installation. When someone logs on to SWIFTAlliance Workstation using AllAdm as the user name, the SWIFTAlliance control window appears. When logging on with AllUsr, the Access Control application starts automatically after successful entry of operator name and password. Further maintenance of these accounts is the responsibility of the Windows administrator. For example, you can configure a screen saver to automatically lock a workstation, restrict logon hours, keep track of recently used passwords, and so on. 1.3 Windows Security Enhancement for SWIFTAlliance Workstation Introduction The overall system security is the responsibility of the system owner. The actual installation of the SWIFTAlliance software does not modify the security settings of the Windows system. The SWIFTAlliance software provides its own internal protection mechanisms. This is in the form of detection and reporting of any system changes or tampering that can result in an unusable system. To enhance security further, the users and user groups created by the SWIFTAlliance software during installation can be set up for exclusive use of the SWIFTAlliance software. This prevents use by users that are not part of the Alliance user groups. This can be achieved by modifying the file and registry permission as described in the following procedures. The SWIFTAlliance installation procedure creates two users and two groups on the local machine: Users: AllAdm and AllUsr. AllAdm belongs to the Alliance Administrators and the Local Administrators groups and AllUsr belongs to the Alliance Users group. Groups: Alliance Administrators and Alliance Users. When AllAdm is used to log on to Windows, the SWIFTAlliance Control application is automatically started. When AllUsr is used to log on to Windows, the access control application is automatically started. The local administrator can add more users to the Alliance Users group, thus allowing multiple users to access and run the SWIFTAlliance Workstation. Note that in this section, AllUsr can represent any user that is a member of the Alliance Users group. 10 Installation and Administration Guide

11 Introduction The following procedure disallows the use of the SWIFTAlliance software by any other user than AllAdm or AllUsr. Also, AllAdm is the only Windows user that is able to install/deinstall patches or deinstall the SWIFTAlliance software. Modification or deletion of elements in the SWIFTAlliance release-tree or registry by another user is prevented File Permissions To change the file permissions: 1. Log on as Alliance Administrator AllAdm, on your machine. This must be the Alliance Administrator created during installation of the SWIFTAlliance software (the default is AllAdm). 2. Stop the SWIFTAlliance Control application. 3. Using Windows Explorer, move to the top level of your installation directory, (for example \Win32app\SWIFT\Alliance\Workstation) and right-click on directory-file (for example \Workstation). 4. From the drop-down menu, select Properties and in the window that appears select the Security tab. Click Advanced and in the window that appears select the Owner tab: Select AllAdm as owner of the directory-file, ensure Replace owner on subcontainers and objects is selected and then click OK to carry out the operation. 5. The Properties Window for the directory is now displayed: 2 January

12 SWIFTAlliance Workstation Click Advanced and clear Inherit from parent the permission entries that apply to child objects. Include these with entries explicitly defined here. Then click OK. 7. Click Remove in the Security dialog box. Click OK in the Advanced Security Settings dialog box. Confirm the changes when prompted by selecting Yes. 8. In the Workstation Properties dialog box, add user AllAdm and group Alliance Users Security tab. Click Add and then select Alliance Administrator (AllAdm) and then Alliance Users. 12 Installation and Administration Guide

13 Introduction For Alliance Administrator (AllAdm) check Full Control, and for Alliance Users, check Read & Execute, List Folder Contents, and Read Registry Permissions Introduction Using the regedt32 program, change the security on the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\S.W.I.F.T.\SWIFTAlliance\6.0.0 To change the registry permissions: 1. Log on as Alliance Administrator AllAdm, on your computer. Note This must be the Alliance Administrator created during installation of the SWIFTAlliance software. The default is AllAdm. 2. Stop the SWIFTAlliance Control application. 3. From the Windows Start menu select Run and then type in the program name: regedt32 Then click OK. 4. The Registry Editor window appears: 5. Select the registry key for SWIFTAlliance Release (HKEY_LOCAL_MACHINE \SOFTWARE\S.W.I.F.T.\SWIFTAlliance\6.0.0): 6. Change the owner to AllAdm by clicking (using the right mouse button) the key and selecting Permissions from the menu. 2 January

14 SWIFTAlliance Workstation 6.0 In the window that appears click Advanced. Finally, select the Owner tab: Select AllAdm as owner of the registry key. Ensure Replace owner on subcontainers and objects is selected and then click OK to carry out the operation. 7. The Permissions window Security tab for the directory is now displayed: 8. Click Advanced and clear Inherit from parent the permission entries that apply to child objects. Include these with entries explicitly defined here. 14 Installation and Administration Guide

15 Introduction 9. Click Remove. Click OK in the Advanced Security Settings window. Confirm the changes when prompted by clicking Yes. 10. Next add user AllAdm, SYSTEM, and group Alliance Users in the Permissions window Security tab. Click Add and then select Alliance Administrator (AllAdm). Repeat this step to add SYSTEM and group Alliance User. 11. Next check the permissions. They must be: Alliance Administration(AllAdm) Alliance Users SYSTEM Full Control and Read Read Full Control and Read 12. Repeat the procedure for the Alliance Users Registry subkey Operator Settings permissions: Select the registry subkey and set the permissions of Alliance Users to "Full Control" as described earlier. 13. Log on as AllUsr. 14. Close the sign-on window and take ownership of the operator settings key using the procedure described earlier. 2 January

16 SWIFTAlliance Workstation Installation and Administration Guide

17 Installing SWIFTAlliance Workstation 2 Installing SWIFTAlliance Workstation Introduction The procedure to follow for installing Workstation depends on whether you already have Workstation installed or not. If you already have Workstation 5.5 or 5.9 installed on a machine: you can remove 5.5 or 5.9 and then install you can have 5.5, or 5.9, and available on the same machine (it may be useful for testing purposes). The sequence of tasks in installation varies somewhat, depending on which approach you choose. Within this section, there are steps to follow for each installation scenario. 2.1 Installing Workstation for the First Time Introduction Procedure Follow these instructions only if a previous version of Workstation is not installed. If an earlier version of SWIFTAlliance Workstation is installed, remove it before continuing. 1. Log on to Windows as Administrator or as another Windows user that is a member of the local administrator group. 2. Ensure that the correct Service Pack for Windows is installed. See the Release Letter for details. To find out which service pack is installed use the winver command. Open a Command Prompt window and type: winver The dialog box that appears shows various information about the Windows operating system including the service pack version. 3. Insert the SWIFTAlliance Access/Entry/RMA/Workstation release CD into the CD drive. If the computer you are installing SWIFTAlliance Workstation on does not have a CD drive, you can connect to one over the network. To do this, select Map Network Drive from the Tools directory of Windows Explorer. Confirm beforehand that the target drive on the host machine is set up for sharing. 4. Click Start, select Run and then type the following: <CD drive>:\win32\setup Where <CD drive> is the drive letter of the CD. 5. The Setup program runs and the Welcome window is displayed: 2 January

18 SWIFTAlliance Workstation 6.0 Click Next. 6. The License Agreement window is displayed. Read the License Agreement and then click the appropriate button. If you select Acknowledged and agreed as above, click Next to continue with the installation. 7. The System Date/Time check window is displayed: 18 Installation and Administration Guide

19 Installing SWIFTAlliance Workstation If the actual date and time at your location are not the same as the system date and time displayed, click Cancel and adjust the settings on your machine before restarting the installation. Otherwise click Next to continue. 8. The Setup Options window is displayed: 9. Select SWIFTAlliance Workstation. The Setup program checks that the computer meets minimum requirements. The installation Check Hardware/Software window appears: If a Stop sign appears against the check indicating that your computer has failed. You cannot proceed with the installation of SWIFTAlliance until you have resolved the problem. If the check program discovers potential problems, they are signalled using a red check mark. You can proceed with the installation but you should fix the problems before actually running SWIFTAlliance. If a GO sign appears, your computer meets the minimum requirements and you can proceed with the installation. Close the window to continue. 10. The following screen is displayed. 2 January

20 SWIFTAlliance Workstation 6.0 If you do not want to set up user accounts now, select Do not create Alliance accounts and go to step 15. Otherwise, select Create Alliance accounts and the following screen is displayed. This exercise creates two user groups and each group has one user. The groups are Alliance Administrators and Alliance Users. The users are AllAdm and AllUsr. Both get the right to log on locally to the PC where SWIFTAlliance is installed. Furthermore, AllAdm is a member of the administrators group. Enter the password you want to use for the AllUsr and re-enter it for confirmation. Enter the password you want to use for the AllAdm and re-enter it for confirmation. Click Back if you want to return to the previous window. Click Next to continue to the next step. 11. The destination folder is then displayed where the SWIFTAlliance Workstation software is to be installed. By default the installation program displays the directory: <Drive letter>:\win32app\swift\alliance\ You can change the directory using the browse button. If this directory does not exist, you are prompted to allow the install program to create it automatically. The new directory selection is shown in the destination folder window. Click Next to confirm your directory selection. Note Software cannot be installed in the root directory. 12. Select a program folder name. The default is SWIFTAlliance Workstation. Click Next and a summary of your current settings is displayed. If they are correct, click Next. If they are not, click Back and change them. Click OK. 13. The installation begins and the installation progress indicator appears. 14. After a few minutes the SWIFTAlliance Control window appears. 20 Installation and Administration Guide

21 Installing SWIFTAlliance Workstation You must specify the Primary Instance to which the SWIFTAlliance Workstation software can connect. Optionally, you can also specify a Fallback Instance. In each case define the server, server's IP address and port number, instance name, and port number. Some of these fields are completed automatically depending on your configuration. The window fields are described here: Field Primary Instance Fallback Instance Server IP address Boot Port Description Identifies the details of the primary SWIFTAlliance Access or Entry server connection. Identifies the details of the secondary SWIFTAlliance Access or Entry server connection. The host name of the SWIFTAlliance Access or Entry system. The IP address of the SWIFTAlliance (Access or Entry) system. The field is only editable if your local system cannot resolve the host name of the SWIFTAlliance Access or Entry system. For example, through the local hosts file or through DNS. The number of the port used by the "swa_boot" process for the SWIFTAlliance Access or Entry server to which this instance is to connect. This field defaults to and is only editable if SWIFTAlliance Workstation cannot contact the swa_boot process. For example, if swa_boot is not running, or is running on another port. 2 January

22 SWIFTAlliance Workstation 6.0 Field Instance name Server Port Release Server OS Software Path Description The name of the SWIFTAlliance Access or Entry instance on the SWIFTAlliance Access or Entry system. The port number used by the main server of the specified SWIFTAlliance Access or Entry instance on the SWIFTAlliance Access or Entry system. This field is only editable if SWIFTAlliance Workstation cannot contact the swa_boot process on the SWIFTAlliance Access or Entry system. The release of the SWIFTAlliance Access or Entry instance. The Operating System installed on your computer. This field is only editable if SWIFTAlliance Workstation cannot contact the swa_boot process on the SWIFTAlliance Access or Entry system. The directory in which SWIFTAlliance Access or Entry is installed on your local system. This field is not editable. 15. In the Server field, select the server you want to connect SWIFTAlliance Workstation to. Display a list of available servers by clicking the down arrow. Remember that Workstation can connect to either UNIX or Windows based servers. If the server does not appear in the drop-down list, this is because it is not defined in your hosts file. Adding the server name to the host file is only required if the server name resolution is done using this file. If DNS is enabled on your network, simply type the name of the server machine and press <Tab>. Note Make sure that the server name you select is not an alias name for the host. Otherwise, there can be problems when using the Message Exchange application. 16. If the server that you want to connect to is not in the list, click Add to display this window: Enter the Server name and it's IP address. If you do not know what to enter for these values, continue as follows: Go to the server. Type the command hostname Copy the server name that appears. To find the IP address on UNIX servers: AIX, type: 22 Installation and Administration Guide

23 Installing SWIFTAlliance Workstation ping <hostname> Solaris, type: ping -s <hostname> Copy the TCP/IP address that appears. The IP address is listed. Press Ctrl + C to stop the ping process. To find the IP address on Windows servers, type: ping <hostname> Copy the TCP/IP address that appears. The IP address is listed. Press Ctrl + C to stop the ping process. 17. After you have supplied values for server name and IP address, click OK to add the server to your hosts file. A backup of the hosts file is created before the modification is made. 18. In the Instance Name field, select an instance. More than one instance may be available. When only a single instance is available, the name of this instance appears automatically. 19. Select either the Primary or Fallback connection to be used by clicking Active Instance in the appropriate tab. 20. Click OK to accept the values that you entered in the SWIFTAlliance Control dialog box. 21. The Setup program adds Windows user groups and user accounts, and creates short-cuts in the program folder. 22. After a while, the following window is displayed: Installation is now complete. Click Yes, I want to restart my computer now and then click Finish. 23. After restarting, log on to Windows locally with the user accounts AllAdm and AllUsr. In the Logon dialog box select options and in the Log on to (domain) field, select the name of the PC (this is the local machine). Change the passwords. Inform the person that will be using SWIFTAlliance Workstation which user account and password to use when logging on. Note The rest of this section concerns replacing an existing version on the same machine. If a previous version is not installed, please continue with the next section. 2 January

24 SWIFTAlliance Workstation Installing Workstation and Replacing an Existing Version Introduction Procedure Follow these instructions if Workstation 5.5 or 5.9 is already installed and you want to overwrite it with Workstation software. This will install in the same folder as 5.5, or 5.9, and replace the 5.5 or 5.9 software that exists. 1. Log on to Windows as Administrator or as another Windows user that is a member of the local administrator group. 2. Ensure that the correct Service Pack for Windows is installed. See the Release Letter for details. To find out which service pack is installed use the winver command. Open a Command Prompt window and type: winver The dialog box that appears shows various information about the Windows operating system including the service pack version. 3. Insert the SWIFTAlliance Access/Entry/RMA/Workstation release CD into the CD drive. If the computer you are installing SWIFTAlliance Workstation on does not have a CD drive, you can connect to one over the network. To do this, select Map Network Drive from the Tools directory of Windows Explorer. Confirm beforehand that the target drive on the host machine is set up for sharing. 4. Click Start, select Run and then type the following: <CD drive>:\win32\setup Where <CD drive> is the drive letter of the CD. 5. The Setup program runs and the Welcome window is displayed: Click Next. 6. The License Agreement window is displayed. 24 Installation and Administration Guide

25 Installing SWIFTAlliance Workstation Read the License Agreement and then click the appropriate button. If you select Acknowledged and agreed as above, click Next to continue with the installation. 7. The System Date/Time check window is displayed. If the actual date and time at your location are not the same as the system date and time displayed, then click Cancel and adjust the settings on your machine before restarting the installation. Otherwise click Next to continue. 8. The Setup Options window is displayed: 2 January

26 SWIFTAlliance Workstation 6.0 Select SWIFTAlliance Workstation. The Setup program checks that the computer meets minimum requirements. The installation Check Hardware/Software window appears: If a Stop sign appears against the check indicating that your computer has failed. You cannot proceed with the installation of SWIFTAlliance until you have resolved the problem. If the check program discovers potential problems, they are signalled using a red check mark. You can proceed with the installation but you should fix the problems before actually running SWIFTAlliance. If a GO sign appears, your computer meets the minimum requirements and you can proceed with the installation. Close the window to continue. 9. The destination folder shows where the SWIFTAlliance Workstation software is to be installed. If the default directory name is not the directory where Workstation 5.5 or 5.9 is currently installed, click Browse... to locate the appropriate directory. Click Next to confirm your directory selection. 10. The Setup program recognises that Workstation 5.5 or 5.9 exists in the directory and displays the following dialog box: 26 Installation and Administration Guide

27 Installing SWIFTAlliance Workstation Select No, I want to overwrite the Workstation 5.5 (or 5.9) software and click Next. 11. The Select Program Folder dialog box appears, showing the name of the program folder where Workstation is to be installed. If you want to keep the Workstation 5.5 or 5.9 software, see "Installing Workstation and Retaining a Previous Version" on page 27 and follow the instructions there. Click Next. 12. Select a program folder name. The default is SWIFTAlliance Workstation. Click Next and a summary of your current settings is displayed. If they are correct, click Next. If they are not, click Back and change them. Click OK. 13. A summary of your selections appears: Review the settings displayed. If they are correct, click Next and continue with the next step. If they are not correct, click Back and change them. Alternately, you can click Cancel at this point, which displays a window where you can stop the installation. 14. The installation begins and the installation progress indicator appears. 15. The Setup program adds Windows user groups and user accounts, and creates short-cuts in the program folder. After a while, the following window is displayed: Installation is now complete. Select Yes, I want to restart my computer now and then click Finish. 16. After restarting, log on to Windows locally with the user accounts AllAdm and AllUsr. In the Logon dialog box select options and in the Log on to (domain) field, select the name of the PC (this is the local machine). Change the passwords. Inform the person that will be using SWIFTAlliance Workstation which user account and password to use when logging on. 2.3 Installing Workstation and Retaining a Previous Version Introduction Follow these instructions if Workstation 5.5 or 5.9 is already installed and you want to install in a different folder on the same machine 2 January

28 SWIFTAlliance Workstation 6.0 Procedure Using this approach, the Setup program does not prompt you to overwrite Workstation 5.5 or 5.9 software. 1. Log on to Windows as Administrator or as another Windows user that is a member of the local administrator group. 2. Ensure that the correct Service Pack for Windows is installed. See the Release Letter for details. To find out which service pack is installed use the winver command. Open a Command Prompt window and type: winver The dialog box that appears shows various information about the Windows operating system including the service pack version. 3. Using Windows Explorer, define the directory where you want to install the SWIFTAlliance Workstation software. 4. Insert the SWIFTAlliance Access/Entry/RMA/Workstation release CD into the CD drive. If the computer you are installing SWIFTAlliance Workstation on does not have a CD drive, you can connect to one over the network. To do this, select Map Network Drive from the Tools directory of Windows Explorer. Confirm beforehand that the target drive on the host machine is set up for sharing. 5. Click Start, select Run and then type the following: <CD drive>:\win32\setup Where <CD drive> is the drive letter of the CD. 6. The Setup program runs and the Welcome window is displayed: Click Next. 7. The License Agreement window is displayed. 28 Installation and Administration Guide

29 Installing SWIFTAlliance Workstation Read the License Agreement and then click the appropriate button. If you select Acknowledged and agreed as above, click Next to continue with the installation. 8. The System Date/Time check window is displayed. If the actual date and time at your location are not the same as the system date and time displayed, then click Cancel and adjust the settings on your machine before restarting the installation. Otherwise click Next to continue. 9. The Setup Options window is displayed: 2 January

30 SWIFTAlliance Workstation 6.0 Select SWIFTAlliance Workstation. The Setup program checks that the computer meets minimum requirements. The installation Check Hardware/Software window appears: If a Stop sign appears against the check indicating that your computer has failed. You cannot proceed with the installation of SWIFTAlliance until you have resolved the problem. If the check program discovers potential problems, they are signalled using a red check mark. You can proceed with the installation but you should fix the problems before actually running SWIFTAlliance. If a GO sign appears, your computer meets the minimum requirements and you can proceed with the installation. Close the window to continue. 10. The destination folder is next displayed where the SWIFTAlliance Workstation software is to be installed. Click Browse... to select the appropriate directory, then click OK. Click Next to confirm your directory selection. Click OK. 11. The Ask User Destination Path dialog box shows the directory where the SWIFTAlliance Workstation software is to be installed. Click Next. 12. The Select Program Folder dialog box appears: Select a program folder name. The default is SWIFTAlliance Workstation. Click Next and a summary of your current settings is displayed. If they are correct, click Next. If they are not, click Back and change them. Click OK. 13. A summary of your selections appears: Review the settings displayed. If they are correct, click Next and continue with the next step. If they are not correct, click Back and change them. Alternately, you can click Cancel at this point, which displays a window where you can stop the installation. 14. The installation begins and the installation progress indicator appears. After a while, a window appears where you select WS The software path is updated. 30 Installation and Administration Guide

31 Installing SWIFTAlliance Workstation Click OK. 15. The Setup program adds Windows user groups and user accounts, and creates shortcuts in the program folder. After a while, the following window is displayed: Installation is now complete. Select Yes, I want to restart my computer now and then click Finish. 16. After restarting, log on to Windows locally with the user accounts AllAdm and AllUsr. In the Logon dialog box select options and in the Log on to (domain) field, select the name of the PC (this is the local machine). Change the passwords. Inform the person that will be using SWIFTAlliance Workstation which user account and password to use when logging on. 2 January

32 SWIFTAlliance Workstation Installation and Administration Guide

33 Administration Tasks 3 Administration Tasks 3.1 Installation Application Window Description Use the Installation application to update and configure SWIFTAlliance. Example Icon descriptions SWIFTAlliance Control Enables you to change the server and instance you are connected to. Uninstall SWIFTAlliance Removes SWIFTAlliance from your computer. Patch/Upgrade Used to install or remove SWIFTAlliance patches from your computer. Version Info Shows which versions of the SWIFTAlliance executable files are installed on your computer and to check that they have not been tampered with. Report Generates a system status report. Command Prompt Used to run SWIFTAlliance commands. 3.2 SWIFTAlliance Control Introduction The SWIFTAlliance Control application allows you to set up and control access to the SWIFTAlliance Server Instances. For a SWIFTAlliance Workstation on a SWIFTAlliance Server you normally have only the "Primary" and "Fallback" Instances that you set up during installation. For a stand-alone Workstation installation you can set up as many SWIFTAlliance Access or Entry Server instances as you require for the different connections you need. 2 January

34 SWIFTAlliance Workstation 6.0 To do this you must create an "Instance Configuration" on the SWIFTAlliance Control application for each SWIFTAlliance Server instance that you intend to connect to. Each Instance Configuration setup in this way is listed on the main SWIFTAlliance Control window Main SWIFTAlliance Control Window Description Example This window is used to create an "Instance Configuration" on the SWIFTAlliance Control application for each SWIFTAlliance Server instance that you intend to connect to. Field descriptions Name Identifier of the instance configuration. Server Hostname of the SWIFTAlliance server machine. Instance Identifier of the SWIFTAlliance instance on the server machine. Release Release of the SWIFTAlliance instance. Status Indicates which instance is "Active". Only one instance can be active at any one time TCP Configuration on the SWIFTAlliance Workstation Port configuration The SWIFTAlliance Workstation must know the IP address of the SWIFTAlliance Workstation machine and the bootstrap port (port of the swa_boot). This port is held in the registry per SWIFTAlliance Workstation instance. The Control application makes an RPC call to the swa_boot daemon process on the machine where the SWIFTAlliance Workstation servers are running, and on the default port of swa_boot (currently 48009). If the system administrator of the SWIFTAlliance Workstation servers has 34 Installation and Administration Guide

35 Administration Tasks configured swa_boot to run on a non-default port, then you are requested to supply another Port Number. This is required when the instance is configured (see the following section). SSL authentication If Server Authentication is being used, then the SWIFTAlliance Workstation must know the DN of the SWIFTAlliance Workstation servers and must have a corresponding CA certificate. Before the setup of the Server Authentication, the CA certificate file must be distributed to the SWIFTAlliance Workstations. The Instance Configuration application retrieves the DN for the SWIFTAlliance Workstation machine (from the.cert_dn file) and propose this as the DN. Check that the proposed DN is the correct one for the selected SWIFTAlliance Workstation instance. The DN name and certificate location are stored in the registry for each instance (primary, fallback and so on.). The Server Authentication check box is unset by default. If the Server Authentication check box is set, then communication with the SWIFTAlliance servers uses SSL and Server Authentication. In this case, if the SWIFTAlliance servers are running without SSL, an error is reported. If the authentication fails (for example, due to an expired certificate), an authentication error message appears. Certificate expiry In case of certificate renewal, the new certificate must be distributed on the SWIFTAlliance Workstation as described in the previous section Adding or Modifying an Instance Introduction SWIFTAlliance Workstation can be configured to connect to multiple instances of the SWIFTAlliance Server. This is achieved by setting up an "instance configuration" on SWIFTAlliance Workstation which can be selected to connect to the required server instance. Note Only one instance configuration can be selected at any one time. Therefore, only one server instance can be "active" for this SWIFTAlliance Workstation. To add an instance configuration: 1. Start the SWIFTAlliance Control application. 2. From the Instance Configuration menu, select New. 3. The Instance Configuration Details window is displayed. 2 January

36 SWIFTAlliance Workstation 6.0 For a description of the fields in this window, see page 21. Note The Boot port must contain the port number for the swa_boot of the SWIFTAlliance Access server to which this instance is to connect. By default this is 48009, however, if the port used by the SWIFTAlliance Access server is different you must enter the actual value in this field. This field is editable on SWIFTAlliance Workstation only when swa_boot is not running on the specified port on the server. For example, when swa_boot is running on another port on the server, or the server is stopped. If the field is greyed out, it means that the correct port is configured and that swa_boot is running on the server. 4. If Secure Communication with Server is required, enable the check box provided. The SSL Certificate DN and CA Certificate Location fields become available. Enter the required SSL Certificate DN and the location of the CA Certificate. 5. Once you have entered all the required details, select Add from the Instance Configuration menu to create and save the Instance Configuration. 36 Installation and Administration Guide

37 Administration Tasks Note Not all the fields allow the configuration data to be entered directly. If DNS or DHCP is activated on your system, or the server information is already present in your "Hosts" file, the IP Address is entered automatically after you have entered the "Server" name. If this does not occur you need to add the Server name and IP Address to your "Hosts" file (see "Adding a Server to the "Hosts" File" on page 38). Also, once the Server and IP Address have been entered normally the Server OS field will be filled out automatically. To modify an instance configuration: 1. Start the SWIFTAlliance Control application. 2. From the Instance Configuration main window, select the Instance Configuration you want to modify. 3. From the Instance Configuration menu, select Open. 4. In the Instance Configuration Details window, change the configuration data for the instance as required. 5. Select Modify from the Instance Configuration menu to save the updated Instance Configuration Activating an Instance Prerequisite Before you can connect to a SWIFTAlliance server instance, you must make its "instance configuration" the "active" instance configuration on SWIFTAlliance Workstation. How to do this is explained in the following procedure. To activate an instance configuration 1. Start the SWIFTAlliance Control application. 2. From the Instance Configuration main window, select the Instance Configuration of the SWIFTAlliance server instance you want to activate. 3. From the Instance Configuration menu, select Activate. The status of the instance changes to "Active" Removing an Instance To remove an instance configuration 1. Start the SWIFTAlliance Control Application. 2. From the Instance Configuration main window, select the instance configuration to be removed. 3. From the Instance Configuration menu, select Remove. You are prompted to confirm the removal. Click Yes to complete the removal of the Instance Configuration from your system. 2 January

38 SWIFTAlliance Workstation 6.0 Note It is not possible to remove an "active" instance configuration. You must first "activate" another instance configuration, to "de-activate" the instance configuration you want to remove Displaying the Active Instance on the Sign-on Window Introduction To identify which SWIFTAlliance server instance you are connecting to, you can select to display its instance configuration identifier on the Sign-on window. It is also possible to select another instance from the Sign-on window if this option is selected. Sign-on window if this option is selected. 1. Start the SWIFTAlliance Control application. 2. From the File menu, select Active Instance visible in Sign-On Dialog. The next time you start SWIFTAlliance Workstation, the Sign-on window will contain the name of the instance configuration of the SWIFTAlliance server instance which is currently active. A drop-down menu lists any other instance configurations setup on your system. 3. The default Active Instance must be at the same release level as the Workstation. If not, an error message like the following is shown: If you want to continue, click Yes and a list of available instances is displayed. Otherwise, click No to cancel the sign-on Adding a Server to the "Hosts" File Overview First determine the Host name and IP Address of the SWIFTAlliance server computer you want to connect to, and then add it to the Hosts file of the computer where you are running SWIFTAlliance Workstation. To determine the Host (Full Computer) name and IP Address of a SWIFTAlliance Windows server 1. Go to the server machine. 2. Click Start and select Settings and then Control Panel. 3. From the Control Panel click System and then the Computer Name tab. Copy the Full Computer Name. This is the computer's "Hostname". 4. Click Start and select Programs, Accessories and then Command Prompt. 38 Installation and Administration Guide

39 Administration Tasks 5. In the Command Prompt window, type ping <host name> (the command syntax may vary depending on your platform). 6. Copy the TCP/IP address that appears. The IP address is the first line that appears. Press Ctrl + C to stop the ping process. To determine the Host name and IP Address of a SWIFTAlliance UNIX server 1. Go to the server machine. 2. Open an Xterm. 3. Type hostname and then copy the name that is displayed. 4. For AIX, type ping <host name> For Solaris, type ping -s <host name> 5. Copy the TCP/IP address that appears. The IP address is the first line that appears. Press Ctrl+C to stop the ping process. To add a server (Host name and IP Address) manually 1. Display the Instance Configuration Details window by selecting New from the Instance Configuration menu. 2. Enter a name for the instance configuration. 3. From the Instance Configuration menu, select Add Server to Hosts file. The Add Hosts window now appears. In the Server field, enter the "Hostname" of the SWIFTAlliance server machine. In the IP Address field, enter the IP address of the SWIFTAlliance server machine. Click OK 4. The system makes a backup of the "Hosts" file. Click OK to confirm the creation of the backup. The server information is added to the "Hosts" file. 3.3 Patches Patch/Upgrade Program Description The Patch/Upgrade program enables you to install and remove any software patches that are distributed to you. There are two types of patch: "Mandatory cumulative patches", which are sent to all SWIFTAlliance Workstation users. Each cumulative patch includes the previous cumulative patch. As a consequence only one mandatory patch can be installed at a time. "Optional patches", which are sent to selected SWIFTAlliance Workstation users and which affect specific deliverables, such as.exe and.dll files. Optional patches do not include any previous patches. 2 January

40 SWIFTAlliance Workstation 6.0 Example When you double-click the Patch/Upgrade icon the following dialog box appears: Field descriptions Current Patch Level The level of the cumulative patch (if there is one installed). List of Installed Patches The release level and a short description of all the patches that are currently installed, including the latest cumulative patch. The Deinstall button becomes available if you select the latest patch. List of Performed Upgrades Historical information about all SWIFTAlliance upgrades that have been performed on the system. This field is deactivated when no upgrade information is available. Patch location The location of the patch description file (.inf) to be installed on a CD drive or on disk. Use the browse button (... ) to locate and select this file. Distributed Patch When the Patch location field points to an.inf file this field displays information about the patch if it is not invalid. A patch is invalid if it is a cumulative patch that is older than the currently installed one. The Install button only becomes available when a valid patch is selected. When a valid patch is selected the following information is displayed: the patch level (RRXX where RR is the base release level). a short description (up to 40 characters) of the patch. 40 Installation and Administration Guide

41 Administration Tasks Installing Patches To install a patch: 1. Read the Release Letter. 2. Insert the installation CD for the patch or download the patch from the Download Centre on 3. Click Start and select Programs. Select SWIFTAlliance Workstation. 4. Select Installation. 5. Double-click Patch/Upgrade. The Patch/Upgrade window opens. 6. Select the.inf file in the Patch location field using the browse button (... ). 7. Click Install to start the installation. For cumulative patches: If there is a cumulative patch currently installed on the system it is removed. Each deliverable affected by the current patch is restored to its base release version. Optional patches are not removed and deliverables affected by optional patches are not restored to the base release version even if one exists. For optional patches: Some existing optional patches may be removed if required. Information about which patches are being removed appears in the bottom left of the dialog box. Deliverables affected by removed patches are restored to their base release versions. For all patches: For each deliverable supplied with the patch, the version on the system gets copied to its base release version and the patch version gets copied onto the system. The system records that the patch has been installed. The patch level, type of patch and a short description are recorded for all patches. For optional patches, a list of affected deliverables and optional patches to be removed is also recorded Some existing optional patches may be removed if required. Information about which patches are being removed appears in the bottom left of the dialog box. Deliverables affected by removed patches are restored to their base release version Removing Patches To remove a patch: 1. Read the Release Letter. 2. Click Start and select Programs. Select SWIFTAlliance Workstation. 3. Select Installation. 4. Double-click Patch/Upgrade. The Patch/Upgrade window opens. 5. Select the latest patch in the List of Installed Patches box. 6. Click Deinstall. 2 January

42 SWIFTAlliance Workstation 6.0 For cumulative patches: All the patched deliverables not patched by optional patches are restored to their base release version. The record that the patch had been installed is removed. For optional patches: All the patched deliverables are restored to their base release version. The record that the patch had been installed is removed. 3.4 Version Info Description Example The Version Info program interrogates your SWIFTAlliance system and lists all the.exe and.dll files that are currently installed. The Version Info window looks like the following example: Field descriptions File Name The name of each file. File Size The size of each file. 42 Installation and Administration Guide

43 Administration Tasks Product Name The name of the related product. Product Version The version number of the product. Internal Version (files that have been installed as a result of patches can have different versions) Build Stamp SWIFTAlliance version indicator Build Date Date this version was created. Checking files When you select Check Signature from the View menu, the files are analysed to see if they have been tampered with. A tampered file is one that has been overwritten by an unofficial version of the file or has been modified in some way. The window looks like the following example: 2 January