z/OS Server installation

In preparation of running the Portus server on z/OS the installation datasets have to be deployed to the z/OS host. The deployment wizard on your Portus Control Centre on Windows or Linux can be used to deploy the required files to z/OS.

• If this is the first time you've started the Control Centre, the Portus Perspective will be activated automatically.

  If, for some reason, the Portus Control Centre perspective has not started, click Window -> Open Perspective -> Other and choose Portus Control Centre from the list. Click OK

  You will be asked to specify a project name or accept the default. Usually you will now simply click the 'Continue' button, which will then start the 'Deployment Wizard' to guide you through the process of defining your server within the Portus Control Centee and transfer (FTP) the installation files to the Portus Server target machine.

• If you, for whatever reason, opt to NOT run the Deployment Wizard at that time, you can start the wizard anytime later on by clicking the Deployment action button in the title bar of the Portus View

  

  The Deployment Wizard will appear

• Click "Browse" to select your license, choose your (z/OS) installation kit from the list of available and licensed kits.

  Important: This license should reside on a local HDD (Hard Disk Drive), and not on a network drive or SSD (Solid State Drive).

  Click Next

• The following screen allows you to either select an existing Portus server to deploy to, or to define a new Portus server to the Control Center. This server definition will be used for server administration later on.

• To define a new server

  1. Enter a 'friendly name'. This name will be used to refer to a Portus Server without needing to enter the hostname (or IP) later on.
  2. Enter the hostname or IP of the machine on which the Portus server will run. This host/IP will be used to send the install files ( via FTP ) and will become the host/IP that you use when issusing requests to Portus .
  3. Enter the port which you would like Portus to listen for requests on. A new Apache web server will be installed, you must ensure that the port choosen here is available for use and not blocked by a firewall. The port entered here will utimately be the port that Portus uses to service requests.
     Important: Once you have filled in all of the above, click 'Add Server'

     The server will now be added to your Portus Control Center Portus View' for later use.

• Alternatively, if an already defined server is to be used (i.e. installation files deployed to it), check 'Deploy to existing Portus Server' and select a server from the list in the 'Existing Server Information' section.

• Click Next

• The next screen is used to deploy the installation files to the target machine, i.e. the machine is where the Portus server will run.

  
• The hostname / IP will have already been filled by what has been specified on the previous page.
• Enter the username which is used to login (via FTP) to the server machine (if required)
• Enter the password (if required)

• Enter a high-level qualifier to send the installation files to.

  Important:

  Check the Create datasets box (in the target information group) if you want the wizard to create the necessary datasets (recommended). Otherwise, these must be already allocated. For more information, see here

• Installation type. In most cases, this should be left as Normal . If the datasets that are being sent are patch datasets, you should select Patch from the drop-down menu.

• The Additional parameters group will allow you to enter the DSN(s) required for the operation of the driver(s) to be installed. Parameters related to all licensed drivers are queried here, you may omit those for all drivers you do not intend to use.

  Note: Click the Help button(s) next to the DSN name input fields to view information about each datasets purpose.
• If your FTP server requires a port other than 21, you can specify that by selecting Specfic FTP Port and entering the FTP port number.
• If your FTP server requires passive mode transfers, you can enable this by selecting the Passive Mode checkbox
• --> Click the Start FTP button to begin the file transfer.
• Once the FTP has completed, you need to logon to the target machine, and run the server-specific installation steps.

• Now that the server has been installed, you can query the server status from the deployment wizard.

  You can choose to view this status information in the Deployment Wizard, in a browser, or both.
• Click the Display Server Status or the Display Status in Browser Window buttons to return the status of the server.

• You should now click Configure Driver(s) to create Portus drivers that are enabled in your license. If you choose to not add drivers now, they can also be created at a later stage, more information about defining drivers can be found in the Portus view section of this documentation.

  The "Driver Wizard" will present a list of licensed drivers, and come up with all drivers selected and ready to be defined. You may now just click the Configure button to define all of them, or deselect those you do not need or want to set up at that stage.

  Click "Configure".

  In case the driver does not require any additional parameters to be set, it will be defined now, otherwise the Driver Definition Dialog will ask for the additional parameter(s) to be set. e.g. we set the "ListMaxRecords" parameter to a value of "0" (zero) for an Adabas driver. Click the Save button.

• When Show (post-setup) Driver Information is selected, and information is available for the driver(s) just installed, it will be displayed (cumulatively) after the driver(s) have been configured
• Click Done to close the Deployment Wizard
• Configure Portus using the Portus (Eclipse) Control Centre