Installation Guide

Planet 8
Version 5.4.6
About
This guide contains all needed technical information on how to install and upgrade Planet 8.
Installation is delivered as normal SAP transport files. The transport may be imported in a system
where Neptune UXP or Planet 8 is already installed.

Important
The zip file contains one folder with the full installation, and another folder with a patch. The
transport with the full installation must be imported before or together with the patch. Please not
that the patch cannot be imported first.

Installation
▪ Download and unpack the trial version.

Normally the path to the SAP-directory is found with transaction AL11. In most systems the
transport directory is: /usr/sap/trans.

▪ If the component EA-APPL is installed in your system, upload can be done with transaction
CG3Z.
▪ Start transaction STMS and open the import que to your system.
▪ Go to Extras->Other Requests->Add

▪ Type in the transport number: NADK90xxxx

▪ Select the transport request and click Request->Import

▪ Specify the Target Client (the Client where you are running Neptune). If you are using more
than one client, please remember to run the program /NEPTUNE/INSTALLATION_CHECK in
each client after the transport has been completed.
▪ Please also tick the "Ignore Invalid Component Version" checkbox in the Options tab

▪ The import should start and while it’s running you can see this icon as the status

▪ You can also monitor the progress of the import by selecting the row and clicking on the
Import Monitor

▪ If the import has completed successfully you should see a similar screen in the Import
Monitor.
 ▪ Please ignore any warnings for the import (code 4/6). If you get an error (code 8/12) please
register a ticket at http://support.neptune-software.com

Post-installation activities
1. Open SAP transaction SICF

Click the Execute icon on the following screen with default parameters set to navigate to the
next screen.

In the Define Services screen expand the neptune node under Virtual Hosts / Services
 Right click on neptune and each of its subnodes and in the context menu select Activate Service

2. Start the transaction /NEPTUNE/DESIGNER and select Run in Browser the NEPTUNE_FLIGHT
app to initialize the environment, and to verify that the sample app is running as expected.
3. Upload Authorization role(s)
3.1. Open transaction PFCG and import the file _NEPTUNE_DEVELOPER.SAP that is available in
the install file archive. In the PFCG screen choose the menu option Role -> Upload.
3.2. From version 5.3.6 it is also required to generate the authorization profile. First open the
profile in change mode:
3.3. Then generate the profile:
 3.4. Finally do the user assignment/update of user master records:

There are also included more optional roles in the installation package, which can be imported
the same way. These can be used to restrict Read/Write access and block certain functions in the
Neptune Cockpit.

4. Make sure you have the hostname/ip for your SAP system in your host file or set a public URL in
the Cockpit System settings (transaction /NEPTUNE/COCKPIT).

5. A pre-requisite for using the App Designer in the Cockpit is that stateless lock handling is set up.
Please refer to this guide for details.

6. If the previous version of the Neptune App Store has been installed, please delete this ABAP
class: ZCL_NAD_APPSTORE_CLIENT. This ABAP class lies in the customer namespace and is
therefore necessary to remove manually.

7. Run program /NEPTUNE/INSTALLATION_CHECK in every client you will run Neptune.

8. To avoid unnecessary system log messages, please upload the certificate that is part of the
installation package into the system Personal Security Environment (system PSE). The certificate
may also be downloaded here. Here is how to do it:
8.1. Start transaction STRUST
8.2. Change
8.3. Import Certificate for System PSE
8.4. Add to Certificate List
8.5. Save

As a general note, please also make sure to update the systems Cryptolib as
described here.

9. We recommend:
9.1. Installing SAPGUI 7.40 Patch level 16 or higher
 9.2. When Neptune applications run inside SAP GUI on Windows, Internet Explorer is used to
render the pages. Only IE11 is supported. Make sure that IE is upgraded to the latest
version.

9.3. For the best user experience, we recommend that you use Google Chrome to run Neptune
Cockpit & the browser based App Designer.

9.4. Setting up SSO2 logon. Please adjust RZ10 (or RZ11 for immediate effect)
9.4.1.login/accept_sso2_ticket = 1
9.4.2.login/create_sso2_ticket = 2

Frequently Asked Questions

Q: My JS Editor / Run in Designer does not work, what should I do?
A: please check out the following guide: https://community.neptune-software.com/blogs/neptune-
javascript-editor-does-not-work

Q: How can I setup single sign-on?

A: Please check out: https://community.neptune-software.com/blogs/single-sign-on

Q: How can I check the status of my installation?

A: Please run report /NEPTUNE/INSTALLATION_CHECK (transaction SE38)

Q: Where can I find more answers to my questions?

A: Please have a look at “Support vs Community.pdf” which is included in the installation package.