SAP TMKSVR tools for the iseries Installation of TMKSVR as part of the SAPINST environment Installation of TMKSVR as part of the SAPINST environment Installation 1.1. Prerequisites 1.2. Start installation 2. How to deinstall the TMKSVR product 3. Troubleshooting 3.1 Make sure the iseries server is reachable via TCP from the PC. 3.2. "error: Could not delete old TMKSVR instance..." 3.3. "error: cannot access iseries via ftp..." 3.4. "> ftp: connect :Connection refused" 3.5. error: [tcp] could not open connection to TMKSVR at <as400> port <port number>, after n tries I'm giving up, sorry. 3.6. error: port number xxx does not seem to be free. use NETSTAT to clean up any hung TCP connections. 3.7 Installing TMKSVR manually Installation 1.1. Prerequisites To install and run the TMKSVR on an iseries server, you need - an FTP server running on the iseries server - administrator rights, i.e. username and password similar to QSECOFR 1.2. Start installation Run setup.exe. You will be presented the following dialog:
Figure 1: Setup Dialog Please fill it out as specified in the image: iseries Hostname: The iseries you want to install the TMKSVR on iseries Administrator: This user is used to install the TMKSVR and to start the server. Make sure that this user has system administrator rights (QSECOFR or similar). Update existing TMKSVR instances: Do not check this option. Yes, create TMKSVR instance: Check this option. TMKSVR instance number: leave the value at 0. TMKSVR Instance Port (also referred to as Dispatcher Port): leave the value at 51515, if possible. Only change this port number if you encounter problems during installation because the port is in use. 2. How to deinstall the TMKSVR product log on to the iseries Server using QSECOFR or similar CALL QCMD<enter> press <F10> to get detailled messages ADDLIBLE TMKSVR<enter> DLTTMKSVR INSTNO(*ALL)<enter> : deletes all TMKSVR instances. If they are running, they are shut down automatically RMVLIBLE TMKSVR <enter> CHGCURLIB *CRTDFT <enter> DLTLIB TMKSVR<enter> Now the machine is clean and pristine.
3. Troubleshooting Troubleshooting the TMKSVR installation requires a user/password for the iseries and console access (5052). Log on to the iseries as QSECOFR or similar. 3.1 Make sure the iseries server is reachable via TCP from the PC. The majority of all installation problem are caused by bad network configurations. I cannot go into depths here network troubleshooting fills whole books - only give you some ideas to start: Make sure you can ping the iseries server from the PC. Make sure the IP address the PC thinks the iseries server has is the same one the iseries server thinks it has. (ping the iseries server from the PC, and compare the resolved IP address with the TCP configuration on the iseries server). Make sure there are not two servers with the same IP address on the network. Make sure the port you want to connect to is not blocked by some firewall between the iseries and the PC. 3.2. "error: Could not delete old TMKSVR instance..." During installation, if there is a previous installation of the TMKSVR product on that iseries server, it will be deleted. This automatic cleanup might fail. In that case, clean up manually. See 2. How to de-install the TMKSVR product for detailed information. 3.3. "error: cannot access iseries via ftp..." During installation, FTP access to the iseries server is needed. - first, check 3.1 Make sure the iseries server is reachable via TCP from the PC - is the FTP server started at the iseries server? When in doubt, start the FTP server with STRTCPSVR SERVER(*FTP)<enter>. - double-check whether the FTP server is running. Use NETSTAT OPTION(*CNN)<enter>. One of the first lines listed should show the service ftp-control listening at port 21. - are you using the right User/Password? Also check whether the user profile was disabled (WRKUSRPRF <your user>) 3.4. "> ftp: connect :Connection refused" Are you using the right User/Password? Also check whether the user profile was disabled (WRKUSRPRF <your user>)
3.5. error: [tcp] could not open connection to TMKSVR at <as400> port <port number>, after n tries I'm giving up, sorry. If you came that far, the TMKSVR is already installed and should run on the iseries server. As a last check, the installation tries to connect to the now running TMKSVR. This step fails. On the iseries console, check whether the TMKSVR is actually running: WRKACTJOB SBS(TMKSVR00) * You should see a DISPATCH job running. It should look like this: Figure 2: WRKACTJOB SBS(TMKSVR00) shows the TMKSVR jobs If you don t see the DISPATCH job, install the TMKSVR manually. See 3.7 Installing TMKSVR manually for details. If you DO see the DISPATCH job, look into the joblog of this job. It should say something like this: >> CALL PGM(TMKSVR00/TMKSVR140) PARM('-mode' 'SERVER' '-instno' '0' '-port' ' 6211' '-user' 'DISPATCH' '-jobs' '1') TMKSVR version 140 - compiled at: Oct 9 2002 10:52:07 ASCII Current library changed to TMKSVR00. tstech TMKSVR - starting SERVER to listen on port 6211 Check whether the port number mentioned in...starting Server to listen on port xxx is the right one. if the instance number of the TMKSVR was 0. If it was 99, for instance, do a WRKACTJOB SBS(TMKSVR99)
If it is not the right port: repeat the installation, enter the port you want the TMKSVR to use. If it is the right port: The TMKSVR is running fine and listens on the port xxx, only the port xxx seems not to be reachable from your PC. Take a look at 3.1 Make sure the iseries server is reachable via TCP from the PC. Check whether there is a firewall installed on the PC or on the iseries or in between the two machines which blocks this port. Contact your network people. 3.6. error: port number xxx does not seem to be free. use NETSTAT to clean up any hung TCP connections. The TMKSVR tries to start and to listen at the port you gave him, but the port was already in use. Do a NETSTAT OPTION(*CNN). Hit <F14> to show the port numbers. Search for the port you use. (Notice there are two sections, the listening ports and the ports with established connections). For all occurrences of your port in the NETSTAT table: Check what jobs are using the port. If it is another iseries application, try to use a different port. If there are no jobs listed, the port was not cleaned up by the system. Use option 4 to delete it. Figure 3: NETSTAT table - notice the port 6211 was not cleaned up yet by the system - remove it manually using option 4
3.7 Installing TMKSVR manually If it really doesn t seem to work, do the following: Install the TMKSVR with the following options (namely disable Update existing TMKSVR instance and Yes, create TMKSVR instance ): and run this installation. Now, the TMKSVR files get copied onto the iseries into the Library TMSKVR. Nothing else happens. Now, log on onto the iseries. Enter the following commands: CALL QCMD<enter> <hit F10 to see all messages> ADDLIBLE TMKSVR<enter> Now create the instance manually. Lets play it through for instance number 0 at port 6211 (the normal build server instance): DLTTMKSVR 0<enter> (this deletes any old tmksvr instance 0, if there is one) CRTTMKSVR 0<enter> (creates the TMKSVR instance 0, namely the library TMKSVR00) STRTMKSVR INSTNO(0) DISPPORT(6211)<enter> Now, the TMKSVR should get started. If not, usually the port is in use: go to NETSTAT option 3 and search for the port and kill it. CRTSHARE SHARE('rootbin') PATH('/')