Home / Products / Nexus Portal / Installation Instructions

Nexus logoNexus Installation Instructions

These instructions are for new installs only. For additional product information, or if you are upgrading from another version, please use the more detailed instructions in the Nexus Reference GuideOpens new window.

Step 1. Download the Install Files.

If you haven't yet downloaded the Nexus install file to your PC, do that nowOpens new window. Then return to this page. If you have already downloaded the install file you can continue with Step 2.

Save the downloaded file to a new folder on your PC:

The actual file name may change slightly as different releases of the software are made available.

 
Troubleshooting   

If you have a question about the install, give us a call. You can reach our Technical Support team at (250) 655-1766 [7:30-17:00 PST] or the Sales team at (630) 986-0800 [8:00-17:30 CST]. You can also email us.

You can also search our Knowledge BaseOpens new window on this topic.

Step 2. Transfer the Install Files to your iSeries.

Double-click the iSeries install (nexusxx.exe) to transfer the libraries to your iSeries.

After the file is decompressed, BCD's FTP upload utility is presented. Type your iSeries IP address and the QSECOFR password, then click the Upload button:

When the Activity Log reports that the file upload is complete, you can close this window and continue with the next step.

 
Troubleshooting   

If the transfer is interrupted, you can restart it by executing install.exe (in the folder to which you downloaded the install file).

If the transfer fails, check the Activity Log window for errors. BCD's Knowledge BaseOpens new window includes a number of useful troubleshooting options.

You can also run the command WRKSPLF QTCP and check the last joblog there.

Step 3. Install the iSeries Components.

After closing the upload utility, log on to an iSeries session as QSECOFR. Run the command BCDINSTALL/BCDINSTALL. At the panel presented, select the product Nexus and press Enter. Follow the on-screen instructions.

During the install you will be prompted to create a password for the NEXUSADMIN user profile:

Type a value and press Enter to continue. You may also want to make a note of what you typed, you'll need this later to log in to Nexus.

When prompted, enter your Nexus License Key:

If you don't have a valid license key to hand, press F3 (to complete the install) and contact BCD at (630) 986-0800 to request one. Then use the command XL_SMSLIB/UNLOCK to enter your license key when the install concludes.

The last step in the iSeries install instructs you to start the NXAPACHE server instance and provides a test URL to verify that the software has been installed. We'll do that next.

  
Troubleshooting   

After you select the library to install to, BCDINSTALL attempts to restore the product library. It's very rare to have a problem with this step, but any that do come are usually due to changes to the RSTLIB command defaults.

If you mis-enter your license key, you can enter it later using the command XL_SMSLIB/UNLOCK.

You can also search our Knowledge BaseOpens new window on this topic.

Step 4. Start the NXAPACHE HTTP Server Instance.

To run any Nexus programs you will need to start the NXAPACHE HTTP server instance. The server instance configuration was installed with the software.

To start the NXAPACHE HTTP server instance, enter your iSeries IP address below and click the Manage HTTP Servers button. When prompted, log on as QSECOFR and then continue with the instructions below:

. . .

This page may take a few seconds to load. At the page presented go to the Manage tab and select the NXAPACHE server instance from the dropdown list:

After selecting the server instance, verify its status. If it's stopped (as shown above), click the green button to start it. [The NXAPACHE server instance runs on port 8010; if you wish to change this value you can edit the configuration file before starting the server instance]:

Once the server instance is shown as running, click this button to present the Nexus login program:

This test uses the IP address you entered above. If the program isn't found, verify your system IP address in the new browser window.

At the page presented, take note the URL of the page that opens: we have automatically appended the NXAPACHE configuration's port number (8010) to your IP address, as well as the default Nexus login program's URL. We recommend that you bookmark that page.

If you get a Nexus login, it means you have successfully installed the portal, and started a functioning HTTP server instance.

  
Troubleshooting   

If when you attempt to access the :2001 interface, the page won't load, it's probably because you don't have the ADMIN HTTP server instance started on your iSeries. To start it, run this command: STRTCPSVR SERVER(*HTTP) HTTPSVR(ADMIN).

While the best way to start the NXAPACHE HTTP server instance is from the Admin interface, you can also start it directly from an iSeries session using the command STRTCPSVR SERVER(*HTTP) HTTPSVR(NXAPACHE)

The URL for the Admin interface is http://xxx.xxx.xxx.xxx:2001, where the x's represent your iSeries IP address. If you log in this way, at the first page presented you'll need to click on the first link. The text for this link may vary depending on your OS/400 release level, but it will be something like 'IBM Web Administration for i5/OS.

You can also search our Knowledge BaseOpens new window on this topic.

Step 5. Verifying your Configuration and Learning to Use the Software.

If you got to a Nexus login at the previous page, it means you have successfully installed the portal, and started a functioning HTTP server instance. You can use the NEXUSADMIN profile (with the password you set during the install) to log in.

Now you're ready to start learning how to use Nexus.

Continue with Step 2 of the 5 Steps to Success with Nexus.

If at any point in this process you would like to have an informal chat with someone to get some suggestions on how to address your particular needs, then by all means get in touch with our Sales or Technical Support teams.

We will look forward to hearing from you soon.

  
Troubleshooting   

If the page doesn't load at all, confirm that you entered the right IP address for your iSeries.

If you get a Nexus license key error, contact BCD to verify your license key. Then use the command XL_SMSLIB/UNLOCK to enter the license key provided.