Home

ODMS (Installation)

1. MOTIF Software Version Check the version of MOTIF software loaded on the system using the following command analyse image header sys system decw uilmotif exe This provides information about the MOTIF executable includ ing the version of MOTIF software This information is near the top of the output under the sub heading Image Identifica tion Information The image file identification number should be DW V1 2 xxxxx where xxxxx are internal revision and date information ORACLE Open Installation The open data management server provides the SQLplus pack age This package can link to ORACLE databases using an ORACLE open access module If the ORACLE open access module is being installed the ORACLE logical names must be defined To check for defined names SHOW LOGICAL ORA_RDBMS Enter INSTALLATION OPEN VMS OPERATING SYSTEM 3 6 WBPEEUI350003B0 INSTALLATION Open Data Management Server Installation VMS WBPEEUI350003B0 This installation procedure contains two parts The first part retrieves a command procedure The second part uses the command procedure to perform several VMSINSTAL com mands to install the SETCIM software and the open data man agement server software ODMS installation requires that all previous versions of ODMS SETCIM be removed from the system prior to installing the current version If this is an upgrade of an existing ODMS system the following steps should be taken
2. BGCSLINK_UCX 5201 TCP Enter BDDELINK_UCX 5202 TCP Enter For an HP open data management server GCSBERK 5201 TCP Enter The numbers entered must be the same as the service port numbers assigned in the server configuration commands Depending on the TCP IP implementation these lines may be case sensitive 2 Copy winsock dll from the pathways directory to the Win dows root directory 3 Copy wtcp dll from the GCS directory to the Windows root directory 4 In the Windows root directory copy wtcp dll to stpt comm dll WINDOWS CLIENT TERMINAL INSTALLATION 3 60 WBPEEUI350003B0 INSTALLATION 5 Create or edit a file named hosts no extension in the path way directory to include the names and IP addresses of all open data management servers PERSONAL COMPUTER CLIENT DECnet Pathworks These steps provide a general guideline for configuring a per sonal computer client using DECnet Pathworks software To configure the personal computer for access to the host 1 Make sure that DECnet Pathworks is configured and that the client computer is fully configured 2 Using the NCP utility NCP gt define node ODMS_SRV address 10 670 Enter where ODMS_SRV is the name of the open data management server node and 10 670 is the address of the server 3 No other steps should be required on the personal com puter for DECnet type connections WBPEEUI350003B0 PERSONAL COMPUTER CLIENT TCP
3. Do you want install the RDB Open Access Module N INSTALLATION OPEN VMS OPERATING SYSTEM 3 14 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION The RDB Open Access Module allows the SQLplus product to link to an RDB database This product requires that RDB soft ware be installed on the system Do you want install the SETCIM Open Access Module N The SETCIM Open Access Module allows the SQLplus product to link to other SETCIM databases These databases can be remote open data management servers This product is pro vided with SQLplus software and is usually installed if multi ple SETCIM systems are configured Do you want install the DESK Server N The DESK Server allows the SQLplus product to be accessed by the DESK PC product The DESK product requires that this link be installed Type Y at the appropriate prompts to install a link or type N to continue NOTE Warnings for missing platform libraries are issued if any links are selected that require software that has not been installed These warnings do not affect the ODMS installation 26 The following procedure is activated following the installa tion of all SETCIM products This procedure creates a SETCIM group and completes the setup of the base SETCIM system Enter UIC group number octal for SETCIM 200 At the prompt enter the UIC group number or press Enter to accept the default group number 200 This is the group iden tifier of all the SETCIM
4. GCS CLIENT INSTALLATION 3 30 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION where XXXXX is the name of the tape source used in Step 3 Type Y when the tape is ready to be accessed then press to continue 5 At this point the GCS system begins installation of GCS v 2 5 The installation procedure prompts for required infor mation Do you want to purge files replaced by this installation YES If this installation is replacing a previous GCS release old files can be purged to recover disk space If disk space is not an issue old files can be retained Answer Y to purge the replaced files 6 The installation procedure prompts for the device where the GCS software is to be installed Enter disk device for GCS SYS SYSDEVICE DKAXXx where DKAXXX is the name of the disk device where the GCS software is being installed for example DKA200 7 The installation procedure prompts for the directory name in which the GCS is to be installed Enter directory name for GCS root GCS The system provides the default name of GCS If this default is acceptable press Enter Otherwise enter the name of a direc tory 8 The following prompt is displayed Should GCS logicals names also be defined in the system table YES The GCS system requires that certain logical names be defined These names can be defined in the system logical name table or in a group table If the names are defined in the system name table
5. As the installation continues the system responds with Do you want to purge files replaced by this installation YES Type Y to continue 11 A prompt requests the disk directory location to load the SequeLink software If there was a previous installation the user can override it Do you want to use existing SQLNK ROOT definition y If this is a new installation Rooted Directory name SYS SPECIFIC This is the directory into which the SequeLink software is installed The default can be accepted or another directory assigned If a user supplied directory is entered it must be a rooted directory i e it must end in a period For example DKA100 SQLNK is a rooted directory 12 A prompt requests the account that will own the installed files This UIC number can be any account but usually it is the SYSTEM account Using the SYSTEM account insures that the account is available and has the required privileges and quo tas UIC for created directory and files SYSTEM Press to accept the default 13 The SequeLink installation continues with a series of notes and the following prompt At each prompt Press Enter to continue YES Press to continue with the installation Update SequeLink Ins_Log Decnet server for SequeLink installation completed successfully 14 When the SequeLink installation completes the procedure continues by installing the UCXTCPSRV product At each prompt press to accept the default
6. users of the system This parameter should be increased by 68 for each SETCIM open data management server installed semmunu The number of semaphore undo structures This is the number of processes which can have undos pending on a given semaphore This parameter should be set to the same value as semmni msgmni The number of message queue identifiers A mes sage queue identifier is needed for each message queue in the system Each network connection to the open data management server SETCIM system requires a message queue This parameter should be increased by the number of network connected GCS consoles maxupre The maximum number of simultaneous pro cesses a user may have A user is identified by the user ID number not by the number of log in instances The user doing SETCIM open data management server system start ups should be able to start up at least 60 processes It is recommended that this parameter be set to 200 shmmax The shared memory maximum This parameter should be at least 32 megabytes nproc The maximum number of processes that can exist simultaneously in the system Typically this parameter is sized using an equation The default is 20 8 x MAXUSRS NGCSP This equation should be adjusted to support open data management server software Open data man agement server users use considerably more processes INSTALLATION HP UX OPERATING SYSTEM 3 35 INSTALLATION Bailey than the eight listed in the
7. 7 and it is installed in SCSI bus B then the correct device name would be GKB700 For more information on determining SCSI device names refer to the VMS system documentation Do you wish to re read this message N Type N to continue type Y to read this message again Enter a SCSI device name that will be associated with a SCSI ICI RETURN if no more devices Enter a SCSI device name such as GKA400 then press Enter The prompt appears again Either enter another SCSI device name or press to complete the ICI configuration Future changes to the current ICI device configuration can be made by editing two files Edit the file NCPORT COM to make changes to serial device operating parameters Edit the file SETUP COM to make changes to access protection of serial devices or changes to SCSI device names To add new devices copy the commands in these files and replace the current device names with new device names 39 This step covers ICI device configuration The installation procedure proceeds to prompt for INFI 90 OPEN interface con figuration information This information includes the number of ICI modules their physical device types and names and the communication interfaces to these devices If this information is not available it can be manually entered at a later time To manually execute this program type run pimsexe iciconf If you are manually configuring the ICI interface setup there are two files should be edit
8. DECnet name if network type is O TCP IP host if network type is 1 or can be left blank if network type is 2 This field allows the interface to communicate with remote ICI devices If the ICI node is an INOSMO1 it should be OSM node name The network type can be any of the valid choices For TCP IP the DEC product TCP IP services or the TCPware product must be installed For DECnet the DEC product DECnet must be installed If a redundant INFI 90 OPEN interface is required the backup device should be entered For nonredundant interfaces all remaining fields can be left blank To blank a field that has an entry enter a single space in the field Is this correct Y N At the prompt verify that the entries are correct Type Y to accept the entries or type N to continue editing the entries Enter Logical ICI to update define O exit INSTALLATION OPEN VMS OPERATING SYSTEM 3 25 INSTALLATION Bailey Enter any other logical ICI interfaces that need defining After all logical ICI interfaces are defined enter 0 to exit and begin defining ICI physical properties This section allows a user to define the physical port character istics for a given port Define ICI Physical Properties for an ICI Y N Type Y to define ICI physical properties type N to exit Enter the Physical ICI TTA2 If this physical device is already defined a listing of its defini tion is displayed and a prompt asks for new values to be e
9. IP Pathworks These steps provide a general guideline for configuring a per sonal computer client using TCP IP Pathworks To configure the personal computer to access the host 1 Make sure that TCP IP Pathworks is configured and that the client computer is fully configured 2 Edit the hosts file in the pathworks directory to include the name of the client and of the open data management server 3 Edit the services file in the pathworks directory to include the following lines For a VAX open data management server using TCPWARE BGCSLINK_TCPW 5201 TCP Enter BDDELINK_TCPW 5202 TCP Enter For a VAX open data management server using UCX BGCSLINK_UCX 5201 TCP Enter BDDELINK_UCX 5202 TCP Enter For an HP open data management server GCSBERK 5201 TCP Enter GCSBERK 5202 TCP Enter WINDOWS CLIENT TERMINAL INSTALLATION 3 61 INSTALLATION Bailey The numbers entered must be the same as the service port numbers assigned in the server configuration commands 4 No other steps should be required on the PC for TCP IP type connections VAX SERVER TCPware These steps provide a guideline for connecting a VAX server using TCPware software to a GCS console 1 Edit the file device tcpware services by adding the follow ing lines BGCSLINK_TCPW 5201 tcp GCSLINK TCP IP Enter BDDELINK_TCPW 5202 tcp DDELINK TCP IP Enter where any unused service port numbers are used for the
10. SERVER TGV Multinet TGV Multinet support requires that the UCX support library UCXSIPC OLB be copied from MULTINET_COMMON_ROOT MULTINET LIBRARY to SYSSLIBRARY directory prior to installation of the ODMS system When installing the ODMS client system select Multinet as the communication option 1 Multinet must be configured to support the bgcslink ser vice To configure issue the following commands at the appro priate screen prompts shown MULTINET CONFIGURE SERVICE MultiNet Server configuration Utility Reading in configuration from MULTINET SERVICES MASTER_SERVER SERVER CONFIG gt addbgcslink Adding new configuration entry for service BGSLINK Protocol TCP TCP Port number 5001 Program to run NONE Added service BGCSLINK to configuration Selected service is now BGCSLINK SERVER CONFIG gt set service none Service action of BGCSLINK set to NONE SERVER CONFIG gt set program Program to run for BGCSLINK set to NONE SERVER CONFIG gt diable bgcslink SERVER CONFIG gt show full bgcslink Service BGCSLINK DISABLED TCP socket AF_INET SOCK_STREAM port 5001 WINDOWS CLIENT TERMINAL INSTALLATION 3 64 WBPEEUI350003B0 INSTALLATION Socket Options SO_KEEPALIVE INIT TCP Init LISTEN TCP_Listen CONNECTED TCP_Connected SERVER CONFIG gt exit writing configuration to MULTINET_COMMON_ROOT MULTINET SERVICES MASTER_SERVER 2 Edit the file SETCIM RUN by addin
11. TSK_CONSOLE SCRATCH RECORDS 3 55 INSTALLATION Bailey e Guidelines for configuring a GCS console on a personal computer using Wollongong TCP IP software e Guidelines for configuring a GCS console on a personal computer using DECnet Pathworks software e Guidelines for configuring a GCS console on a personal computer using TCP IP Pathworks software e Guidelines for connecting a PC based console to a GCS console on a VAX server using TCPware software e Guidelines for connecting a PC based console to a GCS console on a VAX server using UCX software e Guidelines for connecting a PC based console to a GCS console on a VAX server using DECnet software e Guidelines for connecting a PC based console to a GCS console on an HP server Microsoft Windows Client Terminal Requirements Installing and operating a GCS console from a Windows client terminal requires e A486DX based computer minimum e At least 8 megabytes of memory for GCS console and Win dows software e Atleast 40 megabytes of hard disk drive space e An X Windows software package e TCP IP VAX VMS or HP UX open data management serv ers or DECnet Pathworks VAX VMS open data manage ment servers networking software GCS Console Installation This procedure is an example procedure that explains how to setup a GCS console on a personal computer using Wollongong Pathways TCP IP software to communicate with a open data management server on a VAX usin
12. all users will be accessing the same GCS system If individual user groups wish to operate their own personal cop ies of the GCS system use group logical tables To use a sys tem table to define GCS logicals answer Y If group logical tables are being used answer N At this point the installation procedure creates the required directories and installs the software 9 A prompt for the database option is displayed The only valid options for a open data management server are SETCIM NONE or other for Alpha AXP Choose a local database option NONE GCS CLIENT INSTALLATION 3 31 INSTALLATION Bailey If the SETCIM database option is selected the GCS package is locally linked A local link allows the GCS system to only com municate with a given product version such as SETCIM 4 2 In general the GCS package is not locally linked NONE This permits the database interface to communicate over a physical communication link i e DECnet or TCP IP Accept the default for DECnet or TCP IP connections If the GCS software is being installed on a remote client the NONE option must be chosen NOTE If GCS is locally linked the display validation performed in Step 13 will fail Use ACCESS to modify all the displays to have their default node set to O instead of 1 After this change all displays need to be validated manually The following prompts appear Found group 200 OK to startup ODMS system for it Y N Answer Y 10 The ne
13. before installation 1 Save a snapshot file of the database using DBMT or Eng con 2 Shut down the ODMS system 3 Save the snapshot file made in Step 1 in another directory outside of the ODMS and SETCIM directory trees 4 Save the SETCIM RUN file if customized features exist in the same outside directory 5 Save any disk history data files and archive files in the same outside directory 6 Delete all files in the GCS and SETCIM directory trees including the directories themselves 7 Edit SYSSMANAGER SYSTARTUP_VMS COM and remove all ODMS and SETCIM related items 8 Reboot the system to remove all references to ODMS The standard installation procedure can now be started When installation is complete follow the upgrade instructions provided by SETCIM to restore any tags or other configuration NOTE Only modify records listed in to OKTOMODIFY INP file To install the base server software 1 Log in to the SYSTEM account on the computer on which the open data management server is being installed 2 Load the tape entitled LDODM Server in the tape drive 3 Issue this command at the DCL prompt SYS UPDATE VMSINSTAL ODMSSY_SRV source Enter INSTALLATION OPEN VMS OPERATING SYSTEM 3 7 INSTALLATION Bailey where source is the name of the tape drive for example MKAS500 containing the product kits to be installed 4 The system generates warnings for users that do not have certain privileges and
14. following lines to the end of the profile file just before the done line GCS _ Login Startup variables Enter if f gcs odms odms_gcs sh then Enter gcs odms odms_gcs sh fi b For C shell users add the following to the login file Set up the GCS _ Login Startup environment Enter source gcs odms odms_gcs csh Enter These command scripts append directories to the path The path should not be explicitly set by the login file or by the cshre file To add these lines to the profile file using the vi editor the use the following commands cd change to the home directory vi profile Use to move to the end of the file i enter insert mode Enter the commands that are listed in Step la Press Esc to exit the insert mode to get to line mode w to write change to file q to quit the editor The following command may be useful when editing a file dd deletes a line POST INSTALLATION PROCEDURE GCS CLIENT 3 54 WBPEEUI350003B0 INSTALLATION 2 Log out of the root account and log in as a GCS user For all GCS client connections task console scratch records are required It is recommend that each GCS client have at least two sets of scratch records defined These records can be cre ated using the tsk_console sh_ procedure refer to TSK_CONSOLE SCRATCH RECORDS TSK_CONSOLE SCRATCH RECORDS The open data management server requires that all GCS client
15. following steps 1 Change to the default directory of each open data manage ment server user and add start up commands to the login and profile files of each user On HPVUE systems the file name vueprofile should be edited to uncomment a reference INSTALLATION HP UX OPERATING SYSTEM 3 46 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION to one of the previously mentioned files Using your editor of choice edit these files as follows a For Bourne and Korn shell user add the following lines to the end of the profile file immediately before the done line Run base SETCIM ODMS login file Enter if f setcim commands setcimlogin sh then Enter setcim commands setcimlogin sh Enter fi Set ODMS variables Enter if f setcim ODMS odms sh then Enter setcim ODMS odms sh fi done with ODMS setup Enter b For C shell users add the following lines to the login file Set up the SETCIM environment Enter source setcim commands setcimlogin csh Enter Set the ODMS environment Enter source setcim ODMS odms csh Enter done with odms_ setup Enter These command scripts append directories to the path The path should not be explicitly set by the login file or by the cshre file If time synchronization is required all ODMS users should define the TZ variable in their environment For example TZ ESTS To add these lines to the prof
16. inter faces SCSI device names have the following form DDCU where DD is a two letter device code C is a one letter controller designator and U is a unit number between 0 and 65535 Although the device code can consist of any two letters that do not conflict with the device code for any existing installed device Elsag Bailey recommends using the DEC device code naming standard for VMS by using the device code letters GK for all installed SCSI ICI interfaces This prevents a possible conflict if two separate device drivers attempt to use the same device code A controller designator is a single alpha character A to Z The specific SCSI bus in which the ICI interface is installed deter mines the controller designator For systems with only one SCSI bus the controller designator is A For systems with more than one SCSI bus the controller designators are A B C etc up to the number of SCSI buses installed in the system The physical location of the SCSI buses associated with controller designators varies with each system model Consult the system documentation to verify the physical location of the system SCSI buses INSTALLATION OPEN VMS OPERATING SYSTEM 3 23 INSTALLATION Bailey Setting the ICI interface SCSI address determines the device unit number Determine the device unit number using the fol lowing formula device unit number ICI SCSI address 100 For example if the ICI interface SCSI address is set to
17. management server cre ates one detached process for every file specified in the SETCIM RUN file Additionally one task is active for every GCS console For a typical system MAXPROCESSCNT should be 30 greater than the number of tasks active when the open data management server system is not running MAXBUF This parameter must be at least 4 096 to meet the requirements of the INFI 90 OPEN communication interface PQL_DFILLM This parameter is the maximum number of files a process can open It should be large enough to allow the process with the heaviest use to open all required files The SETCIM task DHISARM the historical data collection program opens three files plus one file for every archive file listed in the TSK_DHIS task record repeat area For a default configuration this number would be three plus ten automatic archive files plus five manual archive files 18 files total This allows for historical data storage which maintains the last ten automatically generated archive files on line and up to five manually selected archive files An alternative to setting this parameter is to modify the DHISARM line in the SETCIM RUN file to include a param eter FILE_LIMIT XX where XX is the maximum number of files required INSTALLATION OPEN VMS OPERATING SYSTEM 3 3 INSTALLATION Bailey System parameters can be checked using the following com mands MCR SYSGEN Enter SYSGEN gt SHOW MAXBUF or any other parame ter S
18. port numbers in the command lines 2 Edit the file SETCIM RUN by adding the following com mands SETCIMCOM start_bgcsnet bgcslink_tcpw tcpware Enter SETCIMCOM start_bddenet bddelink_tcpw tcpware Enter where SETCIM RUN is the open data management server start up file found in the group directory 3 Edit the TCPware HOSTS file to include the IP addresses and names of all clients VAX SERVER UCX and SETCIM 4 5A These steps provide a guideline for connecting a VAX server using UCX software to a GCS console WINDOWS CLIENT TERMINAL INSTALLATION 3 62 WBPEEUI350003B0 INSTALLATION 1 Issue the following commands from the system account UCX UCX gt SET SERVICE BGCSLINK_UCX Enter _UCX gt FILE DISK1 SETCIM COMMANDS BGCSLINK_UCX COM Enter _UCX gt PORT 5201 PROCESS_NAME BGCSLINK_UCX Enter _UCX gt USER_NAME ODMS_USER Enter UCX gt SET SERVICE BSPDDE_UCX Enter _UCX gt FILE DISK1 SETCIM COMMANDS BSPDDE_UCX COM _UCX gt PORT 5202 PROCESS_NAME BSPDDE_UCX Enter _UCX gt USER_NAME ODMS_USER Enter UCX gt ENABLE SERVICE BSPDDE_UCX UCX gt EXIT where DISK1 is the disk device and SETCIM is the directory into which SETCIM was installed 5201 is a unique port num ber that corresponds to the port numbers used in the GCS console PC and ODMS_USER is the name of any valid SET CIM ODMS user created during s
19. quotas If your account does not have sufficient privileges or quotas then exit the procedure and adjust the account before starting the procedure Verify the SYSTEM account is being used for this installation If other users or nonsystem processes are currently active on the system a list of these users and processes is displayed VMSINSTAL W ACTIVE The following processes are still active a list of processes and or users Do you want to continue anyway NO Type N then press to cancel software installation or type Y then press to continue 5 Ifcontinuing the system responds with Are you satisfied with the backup of the your system disk YES If a backup is required type N to cancel installation so that a backup can be done Type Y or press to continue 6 The system responds with Please mount the first volume of the set on XXXXXX Are you ready where XXXXXX is the name of the tape drive To start the open data management server installation process type Y when the tape is ready to be accessed The VMS installation procedure should conclude without any further prompts or questions and load a command procedure to finish the remainder of the installation 7 To continue the installation process enter the commands set def sys update Enter ODMS_INSTALL_SERVER source Enter INSTALLATION OPEN VMS OPERATING SYSTEM 3 8 WBPEEUI350003B0 INSTALLATION where source is the tape device used in St
20. server software This allows multiple copies of the open data management server to be installed on the same machine Each version and its users require a unique VMS group 20 When each product begins to load there is a prompt to purge existing files Existing files should always be purged Do you want to purge files replaced by this installation YES 21 Layered products may generate questions or prompts depending on which layered products are provided on the tape In general accept the defaults for questions or prompts until the SETCIM_CIMIO package is reached For the SETCIM_CIMIO package the following prompt is generated Do you want to purge files replaced by this installation YES A program is provided with CIM I O to test the systems API Should this test program be installed YES Typically the CIMIO package is not used and the test program is not required Answer the prompt by typing N unless this package is to be used If this package is being installed type Y to install the test program INSTALLATION OPEN VMS OPERATING SYSTEM 3 13 INSTALLATION Bailey 22 For the SETCIM_CIMIOEX package the following prompts are generated Do you want to purge files replaced by this installation YES Do you wish to install source without building executables NO Type Y to only install the source code but not the executables Type N or to create and install the executables 23 For VAX systems only the SETCIM_DAC p
21. snapshot after any major database change and before system shut down minimum Failure to do so will result in the loss of all changes made to the database since the last snapshot was taken 17 The SETCIM open data management server installation procedure continues with the open data management server specific installation Enter a user name assigned to operate the open data management server system This user should default to an HP group that has access to a SETCIM system INSTALLATION HP UX OPERATING SYSTEM 3 43 INSTALLATION Bailey Enter user name default odms lt quit gt to exit where the user name is from the HP UX System Parameters section The procedure uses this account to install various open data management server sections 18 The installation procedure displays the action that it is ready to perform and provides a prompt to continue or abort the action Do you want to continue y n Type Y to continue or type N to exit the installation procedure and abort the entire installation process 19 The installation procedure creates two script files to source on HP log in Refer to Post Installation Procedure HP UX for more information on these script files 20 The system executes several command procedures These procedures install the ODMS specific database All messages are logged to err files in the ODMS com subdirectory of the SETCIM directory tree This provides access to the files to review the mes
22. systems have a set of scratch records defined in the server These records can be defined using one of the following com mands depending on the system These commands must be executed while the ODMS system is running If the system is not running start it using following the commands setcimcom startsetcim for VAX systems startsetcim sh for HP UX systems To define scratch records For VAX based servers PIMS COM TSK_CONSOLE node_name c_type where node_name is the node name of the GCS client enclosed in quotation marks and c_type is the type of connection only DECNET or TCPIP connections are valid NOTE For TCP IP connections the node name is case sensitive For HP based servers tsk_console sh node_name where node_name is the node name of the GCS client All con nections to an HP host must use a TCP IP connection These commands updates the open data management server database After the TSK_CONSOLE scratch records are cre ated take a database snapshot to insure these changes are not lost Snapshots can be saved using the DBMT tool or ENGCON utility see the SETCIM Users Manual for more information The default name of the snapshot file for open data manage ment server systems is listed in the SETCIM RUN file WINDOWS CLIENT TERMINAL INSTALLATION WBPEEUI350003B0 This section covers the following information e Microsoft Windows client terminal requirements e Installing a GCS console on a personal computer
23. that connect to ICI inter faces are known device setup can be done at this time At the prompts Do you want to setup system devices now N Type y to set up system devices Will you be connecting any ICI s via serial ports N Type y if any serial interfaces are configured The system prompts for the names of system serial devices that connect to ICI interfaces After the serial device names are INSTALLATION OPEN VMS OPERATING SYSTEM 3 22 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION entered the system prompts for the operating parameters of each serial device that was entered The operating parameters entered for each serial device must match those of the connect ing ICI interface At the prompt Enter a VMS system serial device that will connect to an ICI RETURN if no more devices Type a device name such as tta2 and press Enter The previous prompt appears again Enter another device name and repeat until all device names are entered Press at the prompt after all the system serial devices have been entered Enter the system serial device operating parameters at the prompts Please enter the required parameters for serial port TTA2 Baud rate Parity EVEN ODD or NONE Enter 19200 for the baud rate then press Enter none for parity then press Enter Will you be connecting any SCSI ICI s N Type y if any SCSI interfaces are configured The system asks for the device names of the SCSI ICI
24. the displays a From the ACCESS main menu select Setup b Select GCS from the setup menu and wait for the Sys tem Configuration Utility display c Select the Node Names option d Set up at least one logical node for the open data man agement server The following example is for a VAX open data management server named ODMSRV using TCPWARE for a TCP IP connection This server has a communications task named BGCS BERK The individual communications tasks depend on the type of network connection DECnet or TCP IP server type HP or VAX and the actual network software running on the server and host Refer to the GCS Users Manual for more information Refer to the appropriate section for information on various connection types following the GCS console installation procedure Select a unique node driver address between 82 and 99 An example entry for Wollongong TCP IP is 1 LOGICAL NODES ODMSRV BGCSBERK 1NODE TASK IDENTIFIER 85 NODE DRIVER ADDRESS Refer to Table 3 1 for a summary of the available options and the required SETCIM RUN file server line and GCS Configuration line for those options WINDOWS CLIENT TERMINAL INSTALLATION 3 58 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION Refer to the GCS User Manual for more information on configuring the interface Verify that any other configura tion aspects of connecting a personal computer client to a HP or VAX server are completed e When completed exit this
25. the files that are listed in the history display The following commands can be invoked to increase the size of a disk history file if the open data management server is shut down cd setcim group200 Enter SETCIMCODE incrdhis Enter This program displays prompts asking for a disk history file name Enter the disk history file name requiring a size increase When prompted for a new size enter a size that is larger than the size specified by the sizedhis program If the ODMS system is active this file can be resized on line using the disk history configuration screens that are provided by the GCS software Refer to Disk History Files in Section 5 for information on how to use the disk history configuration screens 7 To set the ICI time zone information enter the commandes cd PIMSEXE Enter initsync Enter It will then update time zone configuration information for the system Enter the time zone for the ODMS system INSTALLATION HP UX OPERATING SYSTEM 3 49 INSTALLATION Bailey Enter a number between 12 and 12 for the time zone This number represents the hours east of Greenwich mean time for example 5 is the Eastern Standard Time Zone in the United States Refer to Table 3 1 for a list of time zones world wide This procedure updates any INFI 90 OPEN interfaces that are defined in the database If any interfaces are predefined the following prompts will appear If no interfaces are predefi
26. users UIC group numbers can be viewed using the VMS authorize utility or using the VMS com mand show process Enter 27 The initial database for the base SETCIM system is config ured Creating SETCIM GROUP200 directory The following standard RLD files are in the SETCIM ETC direc tory Load CIMVALS RLD Load CIMDCOM RLD Do NOT load CIMMVDEG RLD Load CIMCALC RLD Load CIMNETC RLD Load CIMNETS RLD Load CIMSYSCMD RLD Load CIMCC RLD Load CIMCCSCHED RLD INSTALLATION OPEN VMS OPERATING SYSTEM 3 15 INSTALLATION Bailey Load CIMIO RLD Load CIMIOSIMUL RLD Load SQLPLUS RLD The RLD files contain an ASCII version of various database records These records comprise the initial open data manage ment server database Answer no by typing NO at the next prompt and take the default for all products until the prompt for the CIMIO RLD file If the CIMIO package was not installed answer NO to this prompt This prevents the recload file from being processed In general if any optional SETCIM package is not to be used its recload file should not be processed If the CIMIO RLD file is processed and the CIMIO executable was not built then the open data management server will not start The SETCIM RUN file will have an entry for CIMIO tasks that do not exist Correct this by removing the entries from the SETCIM RUN file Do you agree with the default recommendations for RLD files YES Do you wish to l
27. 8 Text Records Loaded from File SETCIM ETC CIMSQLPLUS RLD 1418 lines Finished loading records from RLD files 29 The next sequence generates a new disk history file This file is required to collect historical data and to store system information Do you wish to create a new disk history file YES Press or type YES to create a disk history file Enter new disk history file name DHISTORY DAT The default file name can be accepted by pressing or enter another name DKA200 has 50349 free blocks Enter disk history file size blocks 200 2000 The size of the file should be 2 000 blocks This file contains only standard system historical information Point historical information is stored in a historical file automatically created later in the installation 30 At the prompt for the database snapshot file name enter a name or accept the default by pressing Enter Enter database snapshot file to be created SETCIM SNP The open data management server stores information in a database that is loaded from a snapshot at start up time A snapshot is a copy of the database as it exists in system mem ory and is taken at scheduled intervals NOTE The name of the snapshot file setcim snp by default is listed in the setcim run file in the group directory in the SETCIM directory tree This snapshot is loaded into the database on subse quent open data management server start ups To insure there is no data loss take perio
28. CLE software be installed on the system Do you want install the RDB Open Access Module N The RDB Open Access Module allows the SQLplus product to link to an RDB database This product requires that RDB soft ware be installed on the system Do you want install the SETCIM Open Access Module N The SETCIM Open Access Module allows the SQLplus product to link to other SETCIM databases These databases can be INSTALLATION HP UX OPERATING SYSTEM 3 40 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION remote SETCIM or open data management server systems This product is provided with SQLplus software and is usually installed if multiple SETCIM systems are configured Do you want install the DESK Server N The DESK server allows the SQLplus product to be accessed by the DESK PC product The DESK server requires that this interface be installed Type Y at the appropriate prompts to install a link or type N to continue 10 The installation procedure loads the SequeLink software needed for network communication Enter the full path of the SequeLink Root Directory setcim sequelink The default directory is the root directory selected during the SETCIM software installation and the SequeLink subdirectory The default directory can be accepted in most cases If CIMDESK was selected in Step 9 a prompt is displayed requesting the license code Enter SequeLink license key for CIMDESK 26 characters long Enter the lice
29. CNET 1 TCPIP 2 LOCAL 2 If a redundant INFI 90 OPEN interface is required the backup device should be defined using the same network type input used for the primary interface For nonredundant interfaces the remaining fields can be left blank Physical ICI Backup ICI Backup Node ICI Backup Network Type O DECNET 1 TCPIP 2 LOCAL Is this correct Y N At the prompt verify that the entries are correct Type Y to accept the entries or type N to continue editing the entries Enter Logical ICI to update define O exit Enter any other logical ICI interfaces that need defining After all logical ICI interfaces are defined enter 0 to exit and begin defining ICI physical properties Define ICI Physical Properties for an ICI Y N Type Y to define ICI physical properties type N to exit This section allows a user to define the physical port character istics for a given port Enter the Physical ICI ttya If this physical device is already defined a listing of its defini tion is displayed and a prompt asks for new values to be entered Press for any input to keep the current value If the device is not defined the following prompts are displayed Connection Type 3 Serial 4 SCSI The ICI interface connection type is either serial or SCSI Select the number that matches the type of hardware in use If the SCSI is selected no more prompts appear If serial is selected prompts appear for the communication paramet
30. INSTALLATION OPEN VMS OPERATING SYSTEM 3 10 WBPEEUI350003B0 INSTALLATION Do you want to purge file replace by this installation YES Are DEC TCP IP services for Open VMS installed Y Y Do you want to use existing SQLNK ROOT definition Y As the UCXTCPSRV product is being installed a series of notes will be displayed At the prompt Press RETURN to continue Press to continue SequeLink UCX Server installation completed successfully 15 The system continues with Process all SETCIM kits OpenVMS VAX Software Product Installation Procedure V6 2 Please mount the first volume of the set on XXXXX Are you ready where XXXXXX is the name of the tape drive Answer Y when the tape is ready to be accessed The screen lists the software products that are loaded during this procedure MOUNT I MOUNTED ODMS mounted on _PIMS90 MKA400 The following products will be processed SETCIM V4 6 SETCIM_BATCHTRACK V4 6 SETCIM_CIMCALC V4 6 SETCIM_CIMCC V4 6 SETCIM_CIMIO V 4 6 SETCIM_CIMIOEX V4 6 SETCIM_CIMNET V4 6 SETCIM_CIMGQ V4 6 SETCIM_DAC V4 6 for VAX only SETCIM_DAS V4 6 for VAX only SETCIM_DBMT V4 6 SETCIM_GCSLINK V4 6 SETCIM_SQLPLUS V4 6 16 The user is required to enter password information Refer to the customer order form Sheet 2 for the password that is initially required INSTALLATION OPEN VMS OPERATING SYSTEM WBPEEUI350003B0 3 11 INSTALLATION Bailey This installation procedur
31. Insert each disk as the system requests it 5 The installation process if permitted updates the con Jig sys and autoexec bat files for GCS console required vari ables It creates a program group and start up icon and concludes installation 6 When the installation completes install disk 6 in the drive and bring up a DOS window and enter the following com mands cd c gcswin displays a scdisps a odmdisps install bat WINDOWS CLIENT TERMINAL INSTALLATION 3 57 INSTALLATION Bailey where c gcswin is the directory where the GCS console is installed display is the default display directory and a is the floppy disk drive These steps extract the open data management server displays and add them to the GCS displays directory convert the dis plays from ASC file format to DSP file format and set up the console configuration The scdisps exe file is a self extracting zip file that loads the SETCIM specific displays The odm disps exe file is a self extracting zip file that loads the base open data management server displays The script file will replace several base SETCIM display files The install bat file converts the displays and provides an initial GCS console con figuration 7 Type exit to return to Windows 8 Exit Windows remove the floppy disk from the floppy disk drive boot the system and start up Windows 9 Click on the GCS icon Do the following steps to complete the GCS configuration and validate
32. N to continue editing the entries Define ICI Physical Properties for an ICI Y N Type Y to define additional physical devices type N to exit This completes the installation of SETCIM and open data man agement server software Post Installation Procedure VMS WBPEEUI350003B0 The following steps contain instructions for configuring the open data management server system Do these steps after all installation operations are complete Some of the post installa tion steps require that the database be loaded and all points configured before they are performed 1 Add the following line to the LOGIN COM file of every account that uses the open data management server system This command sets up symbols and other settings required to run the SETCIM and open data management server software SETCIMCOM SETCIMSYLOGIN Enter 2 A proxy account must be defined if ICI interface communi cation is via DECnet or a GCS client communicates via DEC net Any of the defined open data management server user accounts can be used The following commands define a proxy account and create the proxy database if one does not exist set def sys system Enter run authorize Enter UAF gt show proxy Enter This requires SYSPRV or system account If an error results the proxy database must be created using the command UAF gt create proxy If the server node does not have a proxy fo
33. SECTION 3 INSTALLATION INTRODUCTION This section contains software installation procedures for installing SETCIM and the Open Data Management Server ODMS software on the following systems e Alpha AXP Open VMS e VAX Open VMS e HP UX It also includes instructions for installing GCS clients on the following systems e Alpha AXP Open VMS e VAX Open VMS e HP UX e Personal computer with MS Windows 3 1 or 95 The SETCIM software installation requires a software license code Refer to the release documentation for details on obtain ing the required license code Software installation also requires a password This password is supplied with the soft ware package Installation will fail without this password All INFI NET interface connections require a software key don gle otherwise any installed software will not function A soft ware key is provided with the open data management server software package for each interface connection purchased Refer to Appendix B for information on installing the software key It is recommended that the software key be installed and all INFI NET to Computer Interface ICI hardware be config ured prior to software installation INSTALLATION OPEN VMS OPERATING SYSTEM WBPEEUI350003B0 This section covers the following installation stages e General VMS requirements including modifying VMS oper ating system parameters e Installing the base SETCIM software and the
34. STALLATION OPEN VMS OPERATING SYSTEM 3 4 WBPEEUI350003B0 INSTALLATION If all parameters are satisfactory at the DCL prompt enter SYS UPDATE AUTOGEN SETPARAMS REBOOT This will set the system parameters and reboot the system Take care when rebooting a system Have all users log off the system and allow all applications to complete their tasks and exit User Accounts For existing user accounts that will be accessing the open data management server database set the PGFLQUOTA parameter to at least 10 000 greater than the number of 256 word pages needed for the database Check and modify this parameter using the standard VMS AUTHORIZE utility set def SYS SYSTEM Enter run authorize Enter UAF gt sh odms_user Enter UAF gt modify odms_user PGFLQUO XX UAF gt exit where odms_user is the name of the existing VMS account accessing the open data management server and XX is the cal culated PGFLQUO size XX gt GLBPAGFIL 10 000 Refer to VMS System Parameters for information on calculating GLBPAGFIL The UIC number associated with SETCIM users should be noted because it is required later in the installation procedure Network Configuration WBPEEUI350003B0 If DECnet is being used for console communication or the INFI 90 OPEN interface communication protocol adjust the follow ing parameters MAX LINKS The maximum number of active links for the system The open data management server requires 24
35. YSGEN gt EXIT If any of these parameters require adjustment the system MODPARAMS DAT file should be updated The following is an example of how to update the MODPARAMS DAT file using a standard screen editor set def SYS SYSTEM Enter edit MODPARAMS DAT Enter Add the following lines to the end of the file ADD_GBLPAGFIL 5860 ODMS MIN_VIRTUALPAGECNT 19 912 ODMS MIN_MAXBUF 4096 ODMS To end the edit session press Ctri Z then type EXIT The ADD_ command increases the current value by the amount specified and the MIN_ command increases the param eter to the specified value if the current value is less Explicitly setting parameter values in MODPARAMS DAT is not recom mended other packages installed on the computer may have greater requirements Always set values using the MIN_ and ADD_ commands To update the VMS operating system to the new parameters from a DCL prompt use AUTOGEN to verify that the parame ters are correct To invoke AUTOGEN type SYS UPDATE AUTOGEN SAVPARAMS GENPARAMS CHECK_FEEDBACK Enter This procedure generates a report usually named SYSSSYS TEM AGENSPARAMS REPORT that should be reviewed In particular check the SCSI system ID This parameter should be DECNET area x 1024 DECNET sub address For example a DECnet address of 10 188 would have a SCS SYSTEMID of 10428 1024 x 10 188 This parameter must be set correctly for the system to work properly IN
36. allation operations are complete and all points are configured in the system verify that the historical files are sized correctly To do this execute the file cd SETCIMCODE Enter sizedhis Enter NOTE Execute these programs from one of the valid SETCIM open data management server user accounts established earlier in this procedure INSTALLATION HP UX OPERATING SYSTEM 3 48 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION This program will prompt for the disk history task record name Check at least the following records TSK_DHIS corresponding to dhistory dat file TSK_DHS1 corresponding to dhistor1 dat file If any additional historical task records are configured they should be checked also This program reports the required disk sizes To verify the disk history file sizes check the size of the actual disk history file The file names can be viewed using the historical configuration display Divide the file size by 512 to get the block size Compare the block size to the block size set in Step under Open Data Management Server Installa tion HP UX To display the current disk file sizes cd setcim group200 Enter Is i DAT Enter where setcim is the directory in which SETCIM is installed and group200 is the group directory created during the instal lation procedure The group number may be different if another HP UX group was used to install the open data man agement server software The files are
37. ces to ODMS The standard installation procedure can now be started When installation is complete follow the upgrade instructions provided by SETCIM to restore any tags or other configuration NOTE Only modify records listed in to OKTOMODIFY INP file To install the SETCIM open data management server software 1 Log in to the system as root 2 An empty temporary directory is required to receive the tape distribution To create the temporary directory enter the command mkdir temp where temp is the name of the directory being created 3 Load the SETCIM tape titled LDODM Server in the tape drive 4 Change directories to the temporary directory using the command cd temp where temp is the name of the directory created in Step 2 5 Load the files from the tape into the temporary directory by entering tar xv or tar xf dev rmt Nm Enter INSTALLATION HP UX OPERATING SYSTEM 3 38 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION where dev rmt is the device name for the tape drive and Nm is the tape drive logical unit number such as 0m This command loads a command file and directory structure into the tempo rary directory tar is a standard UNIX command where X indicates extract file v indicates verbose list all files as they are extracted f indicates from listed devices If the f option is omitted and only one device is present it will default to that device 6 At the prompt start
38. default equation This equation should be updated to allow 30 processes per user The nproc parameter is used in equations for several kernel parameters dst This parameter is a flag indicating Daylight Saving Time This parameter should be set to 0 Open data man agement server time synchronization and module time stamping require that this option be disabled timezone This parameter is the time zone for this com puter system This time zone is entered in minutes west of Greenwich mean time This parameter is the opposite of the time zone entered in during the open data management server installation open data management server requests minutes east of Greenwich mean time A typical value for this time zone would be 300 for Eastern Standard Time Zone in the United States The SETCIM open data management server software requires user accounts that are members of the same group Each group has an ID associated with it The group ID is used to establish ownership of certain files in the HP UX operating sys tem The following steps explain how to examine the user groups and modify the kernel parameters if necessary If a group already exists it can be used 1 Log in to the system as root 2 At the prompt type sam to open the system administra tor manager SAM window and wait for the window to open 3 Select Users and Groups option from the list 4 Select the Groups option 5 When the groups window opens select Add und
39. dic snapshots to update this file Take a data base snapshot after any major database change and before system shut down minimum Failure to do so could result in the loss of all changes made to the database since the last snapshot was taken 31 The installation procedure checks for existing accounts that have access to the UIC group selected in Step 26 If any accounts are found they are listed At least one account must exist This account is used later in the installation INSTALLATION OPEN VMS OPERATING SYSTEM 3 17 INSTALLATION Bailey Do you wish to create one or more accounts No Type N or press to not create new accounts and to skip to Step 32 Type Y if there are no accounts found or if there are more accounts to be added and the following will occur The account creation procedure requests the following infor mation e A unique member number must be an octal number less than or equal to 777 e The account name any character string without embedded spaces e The name of the user the full name of the user or any char acter string including spaces e The initial password for the account e The default device and directory for the account The actual device can be any location but in general each user should have a unique location and this location should not be within the SETCIM or open data management server directory trees Enter the requested information as each of the following prompts appear Som
40. display using the cancel mouse button and quit the System Configuration Utility menu 10 After communications are established all the system dis plays must be validated to connect the client displays to the server database NOTE The server must be up and operating the open data man agement server application while proceeding with this activity The display validation operation attempts to establish a com munications connection for example via TCP IP with the server that was defined earlier in the GCS setup node name ODMSRV in the example in Step 9 If this connection is not established the display validation appears to be working but all displays will report validation errors Verify that the message Remote connection established appears in the access messages window during Step d If it does not verify that the client and server platforms are cor rectly configured and validate the display again To validate displays a Enter the GCS Access Utility b Select the Utilities option then select the Validation option c From the validation menu select Names to open the Validate Tag Names d Select the All option then select the Use option to begin the validation process Verify there is a Remote connection established message as the validation process begins e Successful validation of the displays takes several min utes to several hours depending on the types of client and server platforms f Exit
41. e of the prompts show an example user input There are no accounts with UIC group number 200 Do you wish to create one or more accounts YES Enter a unique UIC member number octal 1 Enter user name ODMS_USER Creating ODMS_USER account now with UIC 200 1 UAF I ADDMSG user record successfully added UAF I RDBADDMSGU identifier ODMS_USER value 000200 000001 added to rights data base Modifying privileges and quotas UAF I MDFYMSG user record s updated UAF I MDFYMSG user record s updated Enter owner name ODMS_USER John Smith INSTALLATION OPEN VMS OPERATING SYSTEM 3 18 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION UAF I MDFYMSG user record s updated Enter password not echoed to terminal UAF I MDFYMSG user record s updated Setting password to expire after first login UAF I MDFYMSG user record s updated Enter login device SYS SYSDEVICE DKA200 Enter login directory ODMS_USER USER ODMS_USER Creating DKA200 USER ODMS_USER directory UAF I MDFYMSG user record s updated Do you wish to create another account NO 32 The SETCIM open data management server needs to be operating for the user account that is entered in this step for the remainder of the installation procedure The following prompt will verify that the system is ready for start up Found group xxx OK to startup ODMS system for it Y N where xxx is the UIC for the SETCIM group for start up The
42. e will exit if you do not know your SETCIM license password Do you know your SETCIM license password YES After pressing or typing YES to continue the following prompt is shown Enter SETCIM license password where the license password is provided with the system Enter the license code as it appears on the customer order form to activate all products for a limited time This process can be repeated if necessary by using the follow ing command and entering the original password RUN SETCIMCODE makelicense Enter Entering the initial password generates a license code Enter the license code in the white background box on the customer order form Sheet 2 Fax or mail the customer order to the Elsag Bailey Open Data Management Server Coordinator at the following address Elsag Bailey 29801 Euclid Ave Wickliffe Ohio 44092 ATTENTION Open Data Management Server Coordinator Mail Stop 3N3 FAX the form to Open Data Management Server Coordinator Mail Stop 3N3 FAX No 216 585 8756 The Open Data Management Server Coordinator assigns final license numbers and returns them to the customer contact identified on Sheet 1 of the customer order form The final license numbers are placed in the gray boxes on Sheet 2 of the customer order form NOTE The initial license provided on the customer order form is valid for approximately 60 days All system functions cease opera tion after 60 days unless a final license code is
43. ed to match the data entered in the iciconf file Edit the files pimsexe ncports com pimsexe setup com The following prompts will appear Define ICI Logical Configuration Y N Type Y to display a list of currently configured devices if any exists Type N to exit INSTALLATION OPEN VMS OPERATING SYSTEM 3 24 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION Enter Logical ICI to update define O exit Each interface should be defined The number selected for the interface is arbitrary but it must match the ICI_X records defined in the database For example an ICI_1 record appears on a display as interface 1 This record requires that a logical ICI be defined with number 1 The following provides an exam ple for logical ICI1 defined as a serial interface The appropriate input is shown with the screen prompts Enter Logical ICI to update define O exit 1 Physical ICI TTA2 ICI Node Name ICI Network Type O DECNET 1 TCPIP 2 LOCAL 0 Physical ICI Backup ICI Backup Node ICI Backup Network Type O DECNET 1 TCPIP 2 LOCAL The Physical ICI must be an existing device This includes RS 232 C ports such as TTA2 LAT type devices such as LTA19 SCSI devices such as A400 and ENET if connecting to an INOSMO1 interface NOTE SCSI devices will appear in the system as GKA400 but should be entered as A400 in this program The ICI node should be filled in with the open data manage ment server node name
44. entered into the sys tem Refer to PERMANENT LICENSE INSTALLATION in Section 6 for information on installing the final license code 17 As the installation continues the system responds with Do you want to purge files replaced by this installation YES INSTALLATION OPEN VMS OPERATING SYSTEM 3 12 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION Existing versions of SETCIM files should be purged to free disk space Type Y to continue This prompt is repeated for all prod ucts installed 18 At the prompt enter the name of the disk device where SETCIM is to be loaded i e DKA200 Enter disk device for SETCIM SYS SYSDEVICE 19 When prompted enter a root directory for the base SETCIM system Enter directory name for SETCIM root SETCIM SECTIM is offered as the default directory Either accept the default directory name or enter a directory name Then answer the following prompt to define the scope of the open data man agement server Should SETCIM logical names also be defined in the system table YES If all users are accessing the same version of SETCIM and open data management server software the logical names should be defined in the system table Answer yes by typing Y If multiple versions of SETCIM and open data management server soft ware are being installed answer no by typing N The logical names are defined in the group logical table for multiple ver sions of SETCIM and open data management
45. ep 3 This command procedure performs several installations and other miscella neous work which includes e Installs SequeLink software if required e Process all SETCIM kits including SQLplus e Creates a SETCIM group e Process the open data management server kit e Perform post installation steps 8 The installation procedure prompts to install the SequeLink software Should SequeLink software be installed Y Press if this software is to be installed If this software is already installed then type N and the procedure skips to Step 15 If other users or nonsystem processes are currently active on the system a list of these users and processes is displayed VMSINSTAL W ACTIVE The following processes are still active list of services 9 The system then responds with Please mount the first volume of the set on XXXXXX Are you ready where XXXXXX is the name of the tape drive specified in Step 7 Answer Y when the tape is ready to be accessed NOTE Several messages appear during the installation of the SET CIM system These are informational messages and should be expected INSTALLATION OPEN VMS OPERATING SYSTEM WBPEEUI350003B0 3 9 INSTALLATION Bailey The screen lists the software products that are loaded during this procedure The following products are processed DNSRV V_ _ SequeLink only UCXTCPSRV V_ _ SequeLink only where V_ _ is the revision number of the SequeLink software 10
46. er the actions menu and click OK 6 Enter the name of the new group for example SETCIM 7 Select the newly created group name in the list 8 Select Modify under the actions menu 9 Select a user name from the Non members list and click Add to place the user into the group Repeat this step for each user that belongs to the group Click OK when finished 10 Return to the SAM main menu 11 Select Previous Level INSTALLATION HP UX OPERATING SYSTEM 3 36 WBPEEUI350003B0 INSTALLATION 12 Select Kernel Configuration from the system administration manager window 13 Select Configurable Parameters 14 From HP UX System Parameters select the parameter that requires updating then select Modify Configurable Parameter under the actions menu Modify the parameter as needed then click OK to update Repeat this process for all parameters that require updates 15 If any of the operating system parameters are modified the system administration manager prompts to generate a new kernel when exiting the Kernel Configuration screen Specifi cally the system administration manager prompts to mark one of the following three options with an X and click OK Create a New Kernel Now Defer Kernel Creation Until Later Cancel All Kernel Modifications If the option to create a new kernel is selected another set of options appears These options are Move Kernel Into Place and Reboot the System Now Exit Without Moving the K
47. ernel Into Place Choosing the first option and clicking OK causes the new ker nel to be created and the system reboots Before rebooting shut down all applications and have all users log off the sys tem 16 To check the version of MOTIF loaded on the HP system enter the command cd usr lib X11 more system mwmre The first screen displays the version of MOTIF loaded on the HP computer MOTIF 1 2 is required To exit the display type q Open Data Management Server Installation HP UX WBPEEUI350003B0 ODMS installation requires that all previous versions of ODMS SETCIM be removed from the system prior to installing the current version If this is an upgrade of an existing ODMS system the following steps should be taken before installation 1 Save a snapshot file of the database using DBMT or Eng con 2 Shut down the ODMS system INSTALLATION HP UX OPERATING SYSTEM 3 37 INSTALLATION Bailey 3 Save the snapshot file made in Step 1 in another directory outside of the ODMS and SETCIM directory trees 4 Save the SETCIM RUN file if customized features exist in the same outside directory 5 Save any disk history data files and archive files in the same outside directory 6 Delete all files in the GCS and SETCIM directory trees including the directories themselves 7 Delete all tmp LOCK files These files relate to ODMS and ICI interface communication 8 Reboot the system to remove all referen
48. ers defined by the ICI interface hardware RS 232 Baud Rate INSTALLATION HP UX OPERATING SYSTEM 3 45 INSTALLATION Bailey Enter the baud rate of the ICI interface usually 19200 Data Bits This prompt is asking for the number of data bits in each word received by or sent from the ICI interface This is usually set for 8 bits 1 NONE 2 EVEN 3 ODD Parity Enter the parity for the port as it is configured on the ICI Usu ally this is configured for NONE Stop Bits This prompt asks for the number of stop bits associated with the communication channel This is usually set to 1 Is this correct Y N At the prompt verify that the entries are correct Type Y to accept the entries or type N to continue editing the entries Define ICI Physical Properties for an ICI Y N Type Y to define additional physical devices type N to exit vices 22 The user is given the option to configure the services file for a port number for GCS link to the SETCIM open data manage ment server Enter the port number for GCS Links The value of the port number should be a unique value in the etc services file greater than 5000 and less than 32767 This number will be updated into the services file in the PIMSEXE directory This file is an example of the lines that should be defined in the etc services file Post Installation Procedure HP UX All open data management server users are required to com plete the
49. erver installation 2 Edit the file SETCIM RUN by adding the following com mands SETCIMCOM start_bgcsnet bgcslink_ucx ucx Enter SETCIMCOM start_bddenet bspdde_ucx ucx where SETCIM RUN is the open data management server start up file found in the group directory 3 Edit the UCX HOSTS file to include the IP addresses and names of all clients WBPEEUI350003B0 VAX SERVER DECnet These steps provide a guideline for connecting a VAX server using DECnet software to a GCS console 1 Configure the operating system for network objects to sup port GCS connections The following commands will create a GCS connection MCR NCP Enter NCP gt def obj ngcslink number 0 file setcimcom ngcslink com Enter NCP gt set obj ngcslink number 0 file setcimcom ngcslink com Enter NCP gt exit WINDOWS CLIENT TERMINAL INSTALLATION 3 63 INSTALLATION Bailey where ngcslink is the name of the service that remote clients are using for a connection 2 Make sure that all clients are defined in the DECnet NCP database Use the following commands to show and define new nodes MCR NCP Enter NCP gt show know nodes Enter NCP gt def node 10 670 name ODMS CLT Enter NCP gt set node 10 670 name ODMS CLT Enter NCP gt exit where ODMS CLT is the node name of the client 3 No additional configuration is required for a DECnet type connection VAX
50. g TCPware software Other installations may use different protocols or software packages but the concepts are similar NOTE Install the TCPware VAX and Pathways TCP IP PC soft ware before proceeding with the GCS console installation proce dure Refer to the instruction guides for those software packages for installation instructions WINDOWS CLIENT TERMINAL INSTALLATION 3 56 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION To install GCS console for windows 1 Insert the first GCS console floppy disk into the floppy disk drive 2 From within Windows select run from the file pulldown menu 3 Enter a setup and click on the OK button to start the installation process 4 The installation process opens several windows Each win dow asks for information to be entered The requested informa tion is e The target drive and directory e The default cursor size none small cross hair or large cross hair e The object focus option standard no default focus or fol low cursor e The communication type DECnet NETBIOS TCP IP 3COM TCP IP Lan Workplace TCP IP Wollongong or NETIPC ARPA For this configuration select TCP IP Wollongong e The name ofa scratch drive for temporary files e If the system should write communication errors to a log file e Switch mouse buttons for left handed people After all prompts have been answered the installation will automatically process disks 1 through 5
51. g the following com mands SETCIMCOM start_bgcsnet bgcslink_ucx ucx Enter SETCIMCOM start_bddenet bspdde_ucx ucx where SETCIM RUN is the open data management server start up file found in the group directory 3 Edit the UCX HOSTS file to include the IP addresses and names of all clients HP SERVER HP CLIENT These steps provide a guideline for connecting an HP server to an HP based GCS consoles 1 Edit the etc services file on both the server and client by adding the following line gcsberk 5401 tcp GCSLINK TCP IP HP client where any unused service port number is used for the service port number in the command 2 On the server edit the SETCIM RUN file by adding the fol lowing line bgcsnet gcsberk SETCIM COMMAND bgcslink sh where SETCIM RUN file is the open data management server start up file found in the group directory 3 Edit the etc hosts file to include the IP addresses and names of all clients WINDOWS CLIENT TERMINAL INSTALLATION WBPEEUI350003B0 3 65 INSTALLATION Bailey HP SERVER PC CLIENT These steps provide a guideline for connecting an HP server to an PC based GCS consoles 1 Edit the ete services file on the server by adding the fol lowing line cim200 5402 tcp GCSLINK TCP IP PC client where any unused service port number is used for the service port number in the command 2 On the server edit the etc inetd conf file by adding the following line c
52. he disk history file display To display the current disk file sizes use the command dir siz setcimgrp dat Enter The following commands can be invoked to increase the size of a disk history file if the open data management server is shut down set def setcimgrp Enter run setcimcode incrdhis Enter This program displays prompts asking for a disk history file name Enter the disk history file name requiring a size increase When prompted for a new size enter a size that is larger than the size specified by the sizedhis program If the ODMS system is active this file can be resized on line using the disk history configuration screens that are provided by the GCS software Refer to Disk History Files in Section 5 for information on how to use the disk history configuration screens 4 For all GCS client connections task console scratch records are required Create one set of task console scratch records for each GCS client prior to client installation Create these records using the tsk_console com procedure refer to TSK_CONSOLE SCRATCH RECORDS INSTALLATION OPEN VMS OPERATING SYSTEM 3 28 WBPEEUI350003B0 INSTALLATION 5 Verify that all updates have been completed then save a snapshot file using the DBMT utility 6 Restart the open data management server using the follow ing command setcimcom startsetcim This command will stop the open data management server and s
53. hen the server starts it checks the licenses in server map tcp To verify that the licenses are valid check the SSET CIM sequelink tcpsrv log file GCS CLIENT INSTALLATION WBPEEUI350003B0 To install a GCS client 1 Log in to the system as the root user NOTE For those installing the GCS client only i e this was not already done under Open Data Management Server Installation HP UX delete the existing GCS directory before creating a new one Use the command rm r gcs to delete the gcs directory 2 Create a temporary directory to contain the tape distribu tion if needed A temp directory should exist from the SETCIM installation procedure If not create the directory by entering the command mkdir temp where temp is the name of the directory being created 3 Load the LSGCS client tape in the tape drive 4 Change directories to the temporary directory using the command cd temp 5 Load the files from the tape into the temporary directory by entering tar xv or tar xf dev rmt Nm where dev rmt is the device name for the tape drive and Nm is the tape drive logical unit number such as 0m The command loads a command file and directory structure into the tempo rary directory 6 At the prompt start the installation command file by typ ing odms_install_client sh The script generates various prompts and loads the GCS client system GCS CLIENT INSTALLATION 3 51 INSTALLATION Baile
54. iguration in CON SOLE DAT_SAVE If no initial configuration exists an error message may occur The following steps provide an initial con figuration Valid server connection types are DECNET or LOCAL Enter the type of connection to server DECNET Select the appropriate server connection The link to the open data management server can be via a locally linked GCS client a DECnet connection or a TCP IP connection The appropriate option must be installed from Step 9 The default for VMS sys tems is DECnet For network connections the name of the server node is required Enter the ODMS server node name When DECnet or TCP IP is selected specify the name of a open data management server that can be accessed for database information The name for DECnet systems is the DECnet Node name of the server For a TCP IP connection the name is the host name of the server 14 The installation process finishes moving any displays It converts the displays from ASC to DSP files The display files are validated against the database on the open data manage ment server These steps can require several minutes to several hours depending on the CPU and type of connection Some dis plays may generate validation errors if the displays are for a package that was not installed such as CIMIO the message should be expected SETCIM displays are generally named after its package If the open data management server is not available the displays wi
55. ile setcim etc CIMSQLPLUS RLD 470 lines Finished loading records from rld files 15 The next sequence generates a new disk history file This file is required to collect historical data and to store system information Do you wish to create a new disk history file YES Press or type YES to create a disk history file Enter new disk history file name DHISTORY DAT The default file name can be accepted by pressing or enter another name This file contains only standard system historical information Point historical information is stored in a historical file auto matically created later in the installation Enter a file size of approximately 2000 blocks at the next prompt Enter disk history file size blocks 200 16 At the prompt for the database snapshot file name enter a name or accept the default by pressing Enter database snapshot file to be created SETCIM SNP The open data management server stores information in a database that is loaded from a snapshot at start up time A snapshot is a copy of the database as it exists in system mem ory and is taken a scheduled intervals NOTE The name of the snapshot file setcim snp by default is listed in the SETCIM RUN file in the group directory in the SETCIM directory tree This snapshot is loaded into the database on subse quent open data management server start ups To insure there is no data loss take periodic snapshots to update this file Take a data base
56. ile file using the vi editor Use the following commands cd change to the home directory vi profile Use 1 to move to the end of the file i enter insert mode Type the commands as listed in Step la Press Esc escape to exit insert mode for line mode INSTALLATION HP UX OPERATING SYSTEM 3 47 INSTALLATION Bailey w to write change to file q to quit the editor The following command may be useful when editing a file dd deletes a line 2 Update the etc services file for ICI connections and for GCS connections Examples of these updates for ICI connec tions are DD_ttya 20000 tcp DD_ttyb 20001 tcp where 20000 and 20001 are port numbers Examples of these updates for GCS connections are gcsberk 5401 tcp cim200 5402 tcp 3 Log in to an ODMS user account for the following steps Start up the SETCIM open data management server system Use the following command to start the system startsetcim sh This command starts all open data management server pro cesses including GCS client support and ICI interface support 4 For all GCS client connections task console scratch records are required Create a set of task console scratch records for each GCS client prior to installation of the client These records can be created using the tsk_console sh proce dure refer to TSK_CONSOLE SCRATCH RECORDS 5 When all updates are complete use the DBMT utility to save a snapshot file 6 After all inst
57. im200 stream tcp nowait odms_ setcim commands cimgcsi_bs sh cimgcsi where odms is a valid user account 3 Edit the etc hosts file to include the IP addresses and names of all clients 4 Reset the TCP IP process with the following command inetd c WINDOWS CLIENT TERMINAL INSTALLATION 3 66 WBPEEUI350003B0
58. links for each INFI 90 OPEN interface Increase this param eter by the number of required links Typically this param eter defaults to 32 and should be reset to 100 ALIAS MAX LINKS This parameter parallels the MAX LINKS parameter and should be increased in proportion MAX LINKS parameter MAX OBJECTS The total number of network objects that can be active on a system Every INFI 90 OPEN interface that is configured for DECnet requires five network objects Every GCS client that connects to this server using DECnet INSTALLATION OPEN VMS OPERATING SYSTEM 3 5 INSTALLATION Bailey requires one object The SQLplus system requires one object for every interface configured for DECnet see SQL plus installation for details Typically this parameter defaults to 30 and should be increased to 50 To check or modify these parameters use the command MCR NCP Enter NCP gt SHOW EXECUTOR CHARACTERISTICS Enter Executing this command generates a list of parameters includ ing the network configuration parameters Use the SET com mand to update the system during operation Use the DEFINE command to update the system configuration permanently NCP gt SET EXECUTOR MAX OBJECT 50 Enter NCP gt DEFINE EXECUTOR MAX OBJECT 50 Enter NCP gt SET EXECUTOR MAX LINKS 100 NCP gt DEFINE EXECUTOR MAX LINKS 100 Enter NCP gt SET EXECUTOR ALIAS MAX LINKS 100 Enter NCP gt DEFINE EXECUTOR ALIAS MAX LINKS 100 Enter NCP gt EXIT
59. ll not validate When the server is available the displays can be manually validated using the ACCESS utility If the display validation fails and the open data management server was available check the connection to the open data management server Use the ACCESS utility to check the connection Refer to the GCS Users Manual for information on using the ACCESS utility GCS CLIENT INSTALLATION 3 33 INSTALLATION Bailey POST INSTALLATION PROCEDURE GCS 1 Add the following line to the LOGIN COM file of every account using the GCS system GCS COMMANDS GCSLOGIN INC This command sets up symbols and other settings required by the GCS software 2 Task console scratch records are required for all GCS cli ent connections These records can be created using the tsk_console com procedure refer to TSK_ CONSOLE SCRATCH RECORDS INSTALLATION HP UX OPERATING SYSTEM This section covers the following installation stages e Modifying HP UX operating system parameters Installing the base SETCIM and open data management server software including SQLplus software Installing the GCS client and the open data management server client only software HP UX System Requirements Installing and operating the SETCIM and open data manage ment server software requires e A Hewlett Packard HP9000 Series 800 computer e An HP system with a HP UX 9 x x operating system e A tape drive and device file for it e The HP c
60. m to the customer contact identified on Sheet 1 of the customer order form The final license numbers are in the gray boxes on Sheet 2 of the cus tomer order form NOTE The initial license provided on the customer order form is valid for approximately 60 days All system functions cease opera tion after 60 days unless a final license number is entered into the system Refer to PERMANENT LICENSE INSTALLATION in Section 6 for information on installing the final license code 8 SETCIM files are copied to subdirectories of the SETCIM root directory The SETCIM root directory and its subdirecto ries are created by this installation procedure At the prompt where should the SETCIM root directory be created setcim Press Enter will accept the default directory setcim Enter a new base directory if a different disk device or name is desired then press Enter The installation script creates the required directory tree and installs the SETCIM software 9 The ODMS specific installation process is invoked The SQLplus product supports links to a number of other prod ucts Prompts are generated for the links to be installed Only select the products that are licensed for the machine Some prompts may not appear if the required software is not avail able Do you want install the ORACLE Open Access Module N The ORACLE Open Access Module allows the SQLplus product to link to an ORACLE database This product requires that ORA
61. nagement server software is being installed define the logical names in the system table If multiple versions of SETCIM and open data management server are being installed define the logical names in the group logical table Additional versions of SET CIM and open data management server software must be installed under a unique VMS groups Should ODMS logical names also be defined in the system table Y At the prompt type Y or press for single version installa tion or type N for a multiple version installation 36 Next the installation procedure loads the open data man agement server database modifies the SETCIM start up file SETCIM RUN and creates an initial disk history file It will then update time zone configuration information for the sys tem Enter the time zone for the ODMS system Enter a number between 12 and 12 for the time zone This number represents the hours east of Greenwich mean time for example 5 is the Eastern Standard Time Zone in the United States Table 3 1 lists the time zones of the world and the appropriate number to enter for that time zone This procedure updates any INFI 90 OPEN interfaces that are defined in the database If any interfaces are predefined the following prompts will appear If no interfaces are predefined skip to Step 37 INSTALLATION OPEN VMS OPERATING SYSTEM 3 20 WBPEEUI350003B0 INSTALLATION Table 3 1 Time Zones Time Zone Number Greenwich Mean Time Lo
62. ndon Edinburgh Dublin Monrovia Casablanca Azores Cape Verde Island Mid Atlantic Buenos Aires Georgetown Brasilia Atlantic Time Canada Caracas La Paz Eastern Time US and Canada Bogota Lima Central Time US and Canada Saskatchewan Mexico City Tegucigalpa Mountain Time US and Canada Arizona Pacific Time US and Canada Tijuana Alaska Hawaii Midway Island Samoa Eniwetok Kwajalein Fiji Kamchatka Marshall Island Wellington Auckland Magadan Solomon Island New Calelonia Guam Port Moresby Vladivostok Hobart Brisbane Mel bourne Sydney Tokyo Osaka Sapparo Seoul Yakutsk Beijing Chongping Urumqi Hong Kong Perth Singapore Taipai Bangkok Jakarta Hanoi Almaty Dhaka Islamabad Karachi Ekaterinberg Tashkent Abu Dhabi Muscat Tbilisi Kazan Volgograd Moscow St Petersburg Baghdad Kuwait Nairobi Riyadh Eastern Europe Athens Helsinki Istanbul Cairo Israel Harare Pretoria Berlin Stockholm Bern Brussels Vienna Amsterdam Lisbon Warsaw Paris Madrid Prague Enter the time zone for ICI ici_1 where ici_1 is the interface to an INFI 90 OPEN loop Currently all interfaces have the same time zone as the base ODMS sys tem Additionally the time synchronization information for a given interface can be initialized at the prompt Should time sync data for ici_1 be initiali
63. ned the prompts will not appear Enter the time zone for ICI ici_1 where ici_1 is the interface to an INFI 90 OPEN loop Currently all interfaces have the same time zone as the base ODMS sys tem Additionally the time synchronization information for a given interface can be initialized at the prompt Should time sync data for ici_1 be initialized Y N This information should be initialized before the interface is placed on line but it should not be initialized once the inter face is on line If the interface is time synchronizing the INFI 90 OPEN system and the time synchronization information is ini tialized the INFI 90 OPEN system will reset all trend informa tion resulting in data loss Type Y to initialize time or type N to proceed 8 If DESK software is added to the system at a later date update the SequeLink licenses These licenses are in the fol lowing file setcim sequelink servermap tcp where setcim is the directory into which SETCIM was loaded This file contains the licenses listed CIMDESK LSPCIMDES license SETCIM LSPSETCIM license where license is the 26 character SequeLink license 9 The SequeLink server must be started before either DESK or the SETCIM Open Access Modules can be used To start the SequeLink server log in as root and type the following com mands cd SETCIM sequelink starttcpserver INSTALLATION HP UX OPERATING SYSTEM 3 50 WBPEEUI350003B0 INSTALLATION W
64. need to be validated manually 9 The installation procedure processes the open data man agement server specific items These items require the name of the directory that will contain the displays Enter the directory that contains the standard displays Default will be displays The default is usually accepted The installation procedure cre ates this directory the only time a different directory is valid is if this system is being updated and a different directory was used by the old version 10 Enter the name of an ODMS user who will be using GCS to access the open data management server system GCS CLIENT INSTALLATION 3 52 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION Enter user name This user must be a valid user The activities that are to be per formed are displayed and a prompt asks for confirmation to continue or exit Do you want to continue y n Exiting the installation procedure requires that the installation procedure be started again at the beginning A prompt asks for the type of connection to the open data management server Will connection to server be via locally linked GCS Y N If the GCS client was installed as locally linked in Step 8 answer yes by typing Y Typically the GCS is not locally linked If this is the case with this installation answer no by typing N 11 If responding with no in Step 10 enter the name of the open data management server that connects to the GCS client a
65. nse code as it appears on the license The license code is displayed and prompt is displayed to verify the license code Is this correct Y N Y If the license code is incorrect type N to enter the license code again If it is correct press enter Enter to continue 11 If SETCIM was selected in Step 9 a prompt is displayed requesting a SequeLink license key for SETCIM Enter SequeLink license key for SETCIM 26 characters long Enter the license code as it appears on the license The license code is displayed and prompt is displayed to verify the license code Is this correct Y N Y If the license code is incorrect type N to enter the license code again If it is correct press enter Enter to continue 12 The installation software prompts to create a group direc tory for the SETCIM open data management server system if one is needed INSTALLATION HP UX OPERATING SYSTEM 3 41 INSTALLATION Bailey Create a new SETCIM group y n This group must be defined prior to executing SETCIM Type Y to create a new group and enter the group name at the prompt Enter name of an existing group xxxxxx where xxxxxx is the group name established in HP UX System Parameters 13 The initial database for the base SETCIM system is config ured The standard RLD files from the SETCIM etc directory are listed These RLD files contain an ASCII version of various database records These records will comprise the initial
66. ntered Press for any input to keep the current value If the device is not defined the following prompts are displayed TCP IP port for this device This is the TCP IP port assigned to the ICI interface The open data management server INFI 90 OPEN interface does not use the TCP IP protocol to connect to the ICI interface Therefore set this value to 0 Connection Type 3 Serial 4 SCSI The ICI interface connection type is either serial or SCSI Select the number that matches the type of hardware in use If the SCSI is selected no more prompts appear If serial is selected prompts for the communication parameters defined by the ICI interface hardware appears RS 232 Baud Rate Enter the baud rate of the ICI hardware notifies usually 19 200 Refer to Table B 1 for BAUD rate dipswitch settings Data Bits This prompt is asking for the number of data bits in each word received by or sent from the ICI interface This is usually set for 8 bits 1 NONE 2 EVEN 3 ODD Parity Enter the parity for the port as it is configured on the ICI inter face Usually this is configured for NONE Stop Bits INSTALLATION OPEN VMS OPERATING SYSTEM 3 26 WBPEEUI350003B0 INSTALLATION This prompt asks for the number of stop bits associated with the communication channel This is usually set to 1 Is this correct Y N At the prompt verify that the entries are correct Type Y to accept the entries or type
67. oad CIMVALS RLD YES Do you wish to load CIMDCOM RLD YES Do you wish to load CIMMVDEG RLD NO Do you wish to load NEWCIMQ RLD YES Do you wish to load CIMCALC RLD YES Do you wish to load CIMNETC RLD YES Do you wish to load CIMNETS RLD YES Do you wish to load CIMSYSCMD RLD YES Do you wish to load CIMCC RLD YES Do you wish to load CIMCCSCHED RLD YES Do you wish to load CIMIO RLD YES Do you wish to load CIMSQLPLUS RLD YES 28 At the prompt for the database sizing information enter the maximum size that the database is expected to reach usu ally the size that was purchased This size determines the upper limit of the database A typical number for a small open data management server is 1 000 000 The size of the database purchased is listed on the tape What is the maximum expected database size in words 300000 1000000 Now starting SETCIM and loading RLD files NOTE It is very important to enter the correct database size The database size must be greater than 700 000 If the default is accepted the installation will fail in a later step At this point the SETCIM system is started and the various RLD files are loaded When the loading is complete a message INSTALLATION OPEN VMS OPERATING SYSTEM 3 16 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION similar to that shown below is displayed The actual database sizes may differ TOTAL WORDS have been increased from 185819 to 18982
68. omputer should have the following amounts of disk space free 100 000 blocks for SETCIM and the open data management server and 60 000 blocks for GCS cli ent NOTE These are the installation requirements The software pack ages require less disk space after installation is complete Software is distributed on DAT tape Therefore an appropriate tape drive is required A familiarity with the use of the tape drive is required It is recommended that the system manager perform any required adjustments of system parameters These parameters are changed using the System Administration Manager utility POST INSTALLATION PROCEDURE GCS 3 34 WBPEEUI350003B0 INSTALLATION SAM The HP UX System Administration Tasks Manual gives a full explanation of how to use the SAM utility A knowledge of the HP UX operating system is required HP UX System Parameters WBPEEUI350003B0 NOTE HP UX systems are case sensitive All examples use the required case Type all commands and files in the correct case The following kernel parameters may require changes or updates semmuni The number of semaphore identifiers available to the users This parameter should be increased by 64 for each SETCIM open data management server installed semmap The number of semaphore maps These maps are directly related to the semaphores described above This parameter should be set to semmni plus 2 semmns The total number of semaphores available to the
69. open data management server database Load CIMVALS RLD Load CIMDCOM RLD Do NOT load CIMMVDEG RLD Load CIMGCS RLD Load NEWCIMQ RLD Load CIMCALC RLD Load CIMNETC RLD Load CIMNETS RLD Load CIMSYSCMD RLD Load SQLPlus RLD Do you agree with the default recommendations for RLD files YES Type YES at the prompt to accept the default RLD files 14 A prompt for the database sizing information is displayed next What is the maximum expected database size in words 300000 1000000 Enter the maximum size that the database is expected to reach usually the size that was purchased The maximum size determines the upper limit of the database A typical number for a small open data management server is 1 000 000 The size of the database purchased is listed on the tape After the database size is entered the system continues NOTE It is very important to enter the correct database size The database size must be greater than 600 000 If the default is accepted the installation will fail in a later step Now starting SETCIM and loading RLD files The SETCIM system is started and the various RLD files are loaded When the loads are complete a message similar to the INSTALLATION HP UX OPERATING SYSTEM 3 42 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION one shown is displayed The actual database sizes and file names may differ TOTAL WORDS has been increased from 126791 to 128170 Text Records Loaded from F
70. open data management server software e Installing the GCS client and the open data management server client software NOTE The procedures in this section apply to both Alpha AXP and VAX installations Procedural differences are noted as required INTRODUCTION 3 1 INSTALLATION Bailey VMS System Requirements The following hardware and software are required to install and operate the open data management server software pack age e AVAX system with at least an Open VMS 6 1 operating sys tem or a DEC Alpha system with at least an Open VMS 6 2 operating system MOTIF version 1 2 software e Sufficient system memory 16 Mbytes of memory mini mum Contact Elsag Bailey for specific memory require ments e 60 Mbtyes of disk space on target disk drive This does not include any additional space required for historical data storage Contact Elsag Bailey for specific memory require ments e 30 Mbytes of free disk space on the system disk This disk space is required temporarily It is used by the installation process If installing and using a remote GCS client the server should include at least one of the following e DECNET_VAX for Open VMS 6 0 or e TCPware for VMS or Open VMS version 4 0 or higher or e TCP IP services for VMS or Open VMS version 2 0B or higher If using TCPware make sure the USCSIPC OLB library is in the SYSSLIBRARY path Software is distributed on digital audio DAT tape
71. r internal access create one An internal access proxy is for the open data man agement server node name i e if the DECnet node name is server1 then a proxy could be server1 odms_user D UAF gt add proxy server1 odms_user default Enter UAF gt exit Enter INSTALLATION OPEN VMS OPERATING SYSTEM 3 27 INSTALLATION Bailey This command creates a proxy for all users to the ODMS_USER account on node server1 where ODMS_USER is the name of a valid Open VMS account If this does not provide enough security add individual proxies for each user that will be using the ODMS system including the system account for installation 3 Complete the remaining steps 3 through 7 from one of the valid open data management server user accounts estab lished earlier in this procedure After all installation operations are complete and all points are configured in the system verify that the historical files are sized correctly To do this execute the file run setcimcode sizedhis Enter This program will prompt for the disk history task record name Check at least the following records TSK_DHIS corresponds to dhistory dat file TSK_DHS1 corresponds to dhistor1 dat file If any additional historical task records are configured they should be checked This program reports the required disk sizes To verify the disk history file sizes check the size of the actual disk history file The file names can be viewed using t
72. rocesses are installed again by this proce dure and should not be operating during this installation pro cedure Other processes that are operating should not cause any problems Type N then press Enter to cancel software installation Type Y then press Enter to continue If continuing the system responds with Are you satisfied with the backup of the your system disk YES If a system backup is required type N to cancel installation so that a system backup can be done Type Y or press to continue with the installation The procedure will check to insure that the tape is ready to process Are you ready Enter Y at the prompt when the tape is ready 4 When the installation of ODMSSY_CLT is completed enter the following commands SET DEF SYS UPDATE Enter ODMS_INSTALL_CLIENT source Enter where source is the name of the drive used in Step 2 This com mand procedure processes the various save sets needed to install the GCS client software This includes custom GCS and open data management server features The save sets are installed using the VMSINSTALL command The system generates warnings for users that do not have cer tain privileges and quotas If other users are currently on the system a list of users is shown at the prompt VMSINSTAL W ACTIVE The following processes are still active list of services programs Please mount the first volume of the set on XXXXX Are you ready
73. roduct is installed at the prompts Do you want to purge files replaced by this installation YES Enter device for SETCIM DA client DKA500 Enter directory name for SETCIM DA root SETCIM Accept the defaults for these prompts and allow this part of the installation to complete 24 For the SETCIM_GCSLINK package the following prompt appears Do you wish to install all of these communications options NO When prompted to select the communication methods offered RS 232 C DECnet and TCPware UCX by the layered prod uct select all by typing YES This loads all communication methods The actual communication method to be used is selected later in the installation Proceeding with installation of the SETCIM_DDELINK interface Do you wish to use the same communications options as for GCS YES Select the same communications options that were selected for GCSLINK by pressing or type Y 25 The next product to be installed is the SQLplus product The SQLplus product supports links to a number of other products Prompts are generated for the links to be installed Only select links for products that are licensed for the machine Some of the prompts may not appear if the required software is not available Do you want install the ORACLE Open Access Module N The ORACLE Open Access Module allows the SQLplus product to link to an ORACLE database This product requires that ORACLE software be installed on the system
74. sages at a later time 21 Prompts for INFI 90 OPEN interface configuration informa tion are displayed The information requested by various prompts includes the number of ICI modules their physical device types and names and the communication interface to these devices If this information is not available it can be man ually entered at later time The following prompt will appear Define ICI Logical Configuration Y N Answer by typing Y to this prompt to display a list of currently configured devices if any Each interface requires definition The number of the interface is arbitrary but it must match the ICI_X records defined in the database For example an ICI_1 record appears on a display as interface 1 This record requires that a logical ICI interface be defined as number 1 The user inputs shown at the prompts provides an example of how to define logical ICI_1 as a serial interface Entries for prompts with no user input shown are also explained Enter Logical ICI to update define O exit 1 The Physical ICI must be an existing device RS 232 ports such as ttya Physical ICI ttya INSTALLATION HP UX OPERATING SYSTEM 3 44 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION The ICI node name can be left blank This field allows the inter face to communicate with remote ICI devices ICI Node Name The Network Type can be any of the valid choices a local con nection is recommended ICI Network Type O DE
75. t the next prompt This name is the network host name of the open data management server Enter the name of the host server 12 Copy the standard SETCIM displays to the GCS displays directory Should standard SETCIM displays be loaded into gcs dis plays where gcs displays is the name of the GCS display directory enter in Step 9 This step is recommended although it can take several minutes to several hours The standard displays provide access to functions such as easy trending NOTE During the course of display validation the screen may not update To check the progress of display validation open another terminal access the display directory to examine the date and time for the display files The installation procedure processes all displays converting them from asc to dsp and validating them This procedure may take several minutes to several hours depending on the CPU in use Any resulting errors are echoed to the screen and to the files gcs odms gcsconv err and gcs odms gcs name err GCS CLIENT INSTALLATION 3 53 INSTALLATION Bailey POST INSTALLATION PROCEDURE GCS CLIENT All users who are to be GCS client users are required to per form the following steps 1 Change to the default directory of each user and add start up commands to the login and profile files of each open data management server user Using any text editor edit these files as follows a For Bourne and Korn shell users add the
76. tart it It will also start up any ICI interfaces and GCS server allowing incoming GCS client connections 7 This installation procedure generates an X Windows resource default file which sets the fonts and colors for the windows interface Fonts or colors can be changed by copying this file to the log in directory and modifying it Enter the following command COPY sysS common DECWSDEFAULTS USER JIQ DAT SYSSLOGIN GCS CLIENT INSTALLATION WBPEEUI350003B0 The open data management server should be available and operating when installing the GCS client software If the server is not operating errors result These errors are not fatal to the system but require manual intervention to correct 1 Login to the SYSTEM account 2 Load the LSGCS Graphic Client tape in the tape drive 3 Use this command at the DCL prompt SYS UPDATE VMSINSTAL ODMSSY_CLT source Enter where source is the name of the tape device in Step 2 The system issues warnings for users that do not have certain privileges and quotas If other users are currently on the sys tem a list of users is shown at the prompt VMSINSTAL W ACTIVE The following processes are still active list of services programs Do you want to continue anyway NO GCS CLIENT INSTALLATION 3 29 INSTALLATION Bailey If any of the processes listed are standard GCS processes such as ACCESS or OPCON press and exit the installation procedure These p
77. the installation shell script by typing odms_install_server sh This script prompts for information to be entered then loads the SETCIM and open data management server systems 7 After the installation begins password information is required The initial required password is included in the dis tribution package Do you know your SETCIM license password YES After pressing or typing YES to continue the following prompt appears Enter SETCIM license password where the license password is provided with the system The license password should be entered as it appears on the cus tomer order form The password permits operation of all prod ucts for a limited time This process can be repeated if necessary by using the follow ing command and entering the original password makelicense Entering the initial password generates a license code Enter the license code in the white background box on the customer order form Sheet 2 Fax or mail the customer order to the Elsag Bailey Open Data Management Server Coordinator at the following address Elsag Bailey 29801 Euclid Ave Wickliffe Ohio 44092 ATTENTION Open Data Management Server Coordinator Mail Stop 3N3 INSTALLATION HP UX OPERATING SYSTEM 3 39 INSTALLATION Bailey FAX the form to Open Data Management Server Coordinator Mail Stop 3N3 FAX No 216 585 8756 The Open Data Management Server Coordinator assigns final license numbers and returns the
78. therefore an appropriate tape drive is required Installation of these soft ware packages requires a familiarity with the use of the tape drive It is recommended that the system manager perform any required adjustments of system setup parameters SYSGEN A knowledge of the VMS operating system is required INSTALLATION OPEN VMS OPERATING SYSTEM 3 2 WBPEEUI350003B0 INSTALLATION VMS System Parameters WBPEEUI350003B0 The following SYSGEN parameters should be checked these parameters apply to only the server unless otherwise noted GBLPAGFIL Increase this parameter by the size of the database To calculate the number of pages needed to con tain the database for VAX systems divide the database word size by 256 words for DEC Alpha systems divide the database word size by the page size 256 512 1 024 or 2 048 words For example a 1 500 000 word database requires that the GBLPAGFIL parameter be increased by 5 860 pages 1 500 000 256 If the size of the database is not known use the size listed on the tape label The size listed on the tape is the maximum license size purchased SYSGEN parameters can be adjusted later if needed VIRTUALPAGECNT This parameter must exceed twice the global page file size GBLPAGFIL by 8 192 Using the example of a 1 500 000 word database VIRTUALPAGECNT is at least 19 912 pages 5 860 x 2 8 192 On Alpha AXP platforms ignore the internal values number MAXPROCESSCNT The open data
79. to the access utility main menu g Select the Console option and verify that the client con nects to the server again and executes the open data man agement server GCS console displays This will conclude the GCS portion of the setup WINDOWS CLIENT TERMINAL INSTALLATION 3 59 INSTALLATION Bailey Table 3 2 Configuration Options PC Client to ODMS Server Host Communication SETCIM RUN File Server Line Protocol VAX on See note 1 ODMSRV user pass ngcslink DECnet GCS Configuration Line PC Client VAX on setcimcom start_bgcsnet ODMSRV user pass bgcslink_ucx TCP IP UCX bgcslink_ucx ucx VAX on setcimcom start_bgcsnet ODMSRV user pass bgcs link_tcpw TCP IP TCPWARE bgcslink_tcpw tcpware HP on TCP IP bgcsnet gcsberk ODMSRV user pass cim200 SETCIM COMMANDS bgcslink sh NOTE 1 No updates to the SETCIM RUN file are needed setcimcom ngcslink com must be defined as a DECnet object PERSONAL COMPUTER CLIENT Wollongong TCP IP These steps provide a general guideline for configuring a per sonal computer client using Wollongong TCP IP software To configure the personal computer for TCP IP access to the host and define SERVICES 1 Edit or create the file c pathways SERVICES to include the following lines For a VAX open data management server using TCPWARE BGCSLINK_TCPW 5201 TCP Enter BDDELINK_TCPW 5202 TCP Enter For a VAX open data management server using UCX
80. user must be a member of this group Type Y to start up the open data management server system 33 The procedure continues with the open data management server specific installation which includes processing another VMS installation kit The system generates warnings for users that do not have cer tain privileges and quotas If your account does not have suffi cient privileges or quotas then exit the procedure and adjust the account before starting the procedure If other users or nonsystem processes are currently active on the system a list of these users and processes is displayed ODMS tasks are displayed in the form TSK_XXX as shown in the example below VMSINSTAL W ACTIVE The following processes are still active a list of processes and or users TSK_DBCLOCK TSK_DHIS TSK_DHIS_ARM TSK_SAVE INSTALLATION OPEN VMS OPERATING SYSTEM 3 19 INSTALLATION Bailey The system responds with Please mount the first volume of the set on XXXXXX Are you ready where XXXXXX is the name of the tape drive To continue type Y when the tape is ready to be accessed The following products will be processed ODMSSY_SRV v_ _ NOTE Some informational messages and warnings may appear during this part of the installation They may be safely ignored 34 At the prompt enter the name of an ODMS account that was assigned in Step 31 Account to run SETCIM from ODMS_USER 35 If a single version of SETCIM and open data ma
81. xt procedure installs the open data management server specific files Please mount the first volume of the set on XXXXX Are you ready where XXXXX is the name of the tape source used in Step 3 Type Y when the tape is ready to be accessed then press to continue A user account is required to access the GCS functions Account to run GCS from ODMS_USER Enter the name of an account using the GCS system This account must exist on the system If the system has an ODMS_USER account the default can be accepted 11 The GCS system requires the name of the directory that contains all displays Directory that contains GCS displays DISPLAYS Enter a directory name The directory DISPLAYS is the default but any existing GCS display directory can be used 12 If desired include the standard SETCIM displays in the directory selected above Should Base SETCIM displays be copied to the display direc tory Y GCS CLIENT INSTALLATION 3 32 WBPEEUI350003B0 WBPEEUI350003B0 INSTALLATION In general the base SETCIM displays should be included However it is possible to limit the number of displays in the display system not all the base SETCIM displays are required If you answer N to this prompt then manually update the dis play directory with the required displays 13 The GCS system requires configuration to connect to a open data management server Any existing configuration is saved prior to creating an initial conf
82. y 7 Atthe prompt enter the root GCS directory name if it is not defined Enter the directory that is to contain the GCS Package The directory should be a complete directory such as ges If this directory does not exist the installation procedure prompts the user to create it Directory does not exist create it y n Type Y to create a new directory A no response causes the sys tem to prompt for a valid directory The installation procedure verifies that the directory is set cor rectly The GCS directory is defined as follows GCS gcs Do you want to continue with this value y n If this is the correct directory type Y The script will create all needed subdirectories and expand the archives 8 The GCS system can be defined to access any SETCIM open data management server system or it can be locked to a local SETCIM open data management server system Do you want GCS to be locally linked y n This local linkage allows the GCS system to only communicate with a given product version such as SETCIM 4 2 In general the GCS system is not locally linked and the user should enter an N to allow for the database interface to communicate over a physical communications link i e TCP IP NOTE If GCS is locally linked the display validation that is done later in the installation will fail Use ACCESS to modify all the dis plays to have their default node set to O instead of 1 After this change all displays
83. zed Y N INSTALLATION OPEN VMS OPERATING SYSTEM WBPEEUI350003B0 3 21 INSTALLATION Bailey This information should be initialized before the interface is placed on line but it should not be initialized once the inter face is on line If the interface is time synchronizing the INFI 90 OPEN system and the time synchronization information is ini tialized the INFI 90 OPEN system will reset all trend informa tion resulting in data loss Type Y to initialize time or type N to proceed If an ICI interface is defined later the following program can be executed to perform time synchronization setup run pimsexe initsync Enter 37 The privileges and quotas given to SETCIM accounts must be modified for open data management server to operate The accounts that were created in Step 31 are listed in a table Modify the privileges and accounts of all required accounts as needed The following accounts have UIC group number 200 Owner Username UIC Account Privs Pri Directory ODMS ODMS_USER 200 1 SYSTEM All 4 DKA100 USER ODMS_ USER Enter account to modify ODMS_USER Modifying privileges and quotas for the ODMS account UAF I MDFYMSG user record s updated UAF I MDFYMSG user record s updated When prompted for the accounts to modify enter the same accounts created earlier in the SETCIM installation or any other account that will be using open data management server software 38 If the names of the system devices

ODMS (Installation)

Contents

Download Pdf Manuals

Related Search

Related Contents