Windows Server installation

This section outlines how to install the Portus Server on Windows

See here for installation troubleshooting hints.

On Windows, the Portus install is done via the Deployment Wizard. This is a wizard which runs within Eclipse, and guides you through the steps required to install and configure your Portus server.

• A dialog will be presented the first time the Portus Control Center is started after its installation. Specify a project name and click Continue

• To start the deployment wizard at any time, click the following button

  

  The Deployment Wizard will appear

• Click "Browse" to select your license, choose your (Windows) 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).
  Important: Please make sure you are not selecting a license file from C:\ProgramData... If your license file is located in the programData folder pleace make a temporary copy of it to another location and select the file forom there.
  

  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.

  For Windows, you should

  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 the machine you are currently working on.
  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 'Servers View' for later use.

     Click Next

• Now the Deployment Wizard must launch the Windows installer program.

  Press the Launch Setup button

  
• A dialog will pop up alerting that the process needs to check for an existing installation.
• Note: If there is an existing install present please skip to the documentation for an upgrade.
• The deployment wizard now starts an MSI installer to install the Portus Server component on the system. When the first page appears, click Next
• If you require Portus to be installed in a non-default directory, click Browse and select your directory. Otherwise click Next
• Click Install to continue
• Please wait while Portus is installed
• When the installation is complete, click Finish

• Return to the Deployment Wizard, the message log will indicate either success or failure of the setup process.

  Click Next

• The next screen is used to verify that your Portus is up and running, and then to configure it based on your license.

  1. Display Server Status: This displays this a short summary of the server status in the deployment wizard
  2. Display Status in Browser Window: This displays more information about the servers status in a browser.

  3. Configure Driver(s): Allows you to automatically create drivers based on your license.

     

• 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. set the "ListMaxRecords" parameter to a value of "0" (zero) for an Adabas Driver. Click the Save button.

  The Driver Wizard Dialog indicates the success of the operation

• 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

Now Portus is installed - what's next ?

• New to Eclipse ? Take an Eclipse getting started tour.
• Configure Portus using the Portus Control Centre
• Proceed directly to define Web Services using Portus.