Starting the SAP Web Dispatcher with the Bootstrap Option

Context

The bootstrap option is used to start the SAP Web Dispatcher without the profile file. This is created automatically by the bootstrap. sapwebdisp -bootstrap must be executed with the user ID that firstly has write authorization in the current working directory, and secondly matches the user ID under which the SAP Web Dispatcher is later operated.

If you call sapwebdisp -bootstrap in a directory below/usr/sap/ <SID>/, you need <SID> adm authorizations, whereby <SID> is the SAP system that the SAP Web Dispatcher is used for.

Procedure

To do this, enter sapwebdisp -bootstrap or sapwebdisp -b in the command line.
The bootstrap starts up, and in the command line you can see the following output:
```
This bootstrap will perform the following steps:
1. create profile file "sapwebdisp.pfl" for SAP Web Dispatcher (if not already existing)
2. create user for web based administration in file "icmauth.txt" (if not already existing)
   After the bootstrap you can use the web based administration
```
If neither profile sapwebdisp.pfl nor file icmauth.txt in which the authorizations for the Web administration are stored are available, these are created by the following bootstrap steps:

Depending on whether sapwebdisp.pfl and/or icmauth.txt already exist, they are not newly created by the bootstrap. The following steps are therefore omitted. If they already exist and you want to replace them, you can simply delete them (singly too) from the directory and recreate them using the bootstrap.
Enter the message server details required by the bootstrap to create the profile. Before the profile is created, the message server details are checked automatically. If necessary you can correct the details.
Example
In this example the system that the SAP Web Dispatcher is set up for is called SAP; the ASCS instance on which the message server is running is called scshost. The HTTP port of the message server is 8081.

Host Name of Message Server (rdisp/mshost):scshost

HTTP Port of Message Server (ms/http_port):8081

System Identifier of Message Server (SID):SAP
In the command line you can see the following output:
```
Checking connection to message server...OK
```
Enter a name, an instance number, the HTTP port, and HTTPS port for the SAP Web Dispatcher.
Select the encryption you want.
- 0 = Encryption deactivated
- 2 = Encryption activated
If you activated encryption, you can see the following output in the command line:
```
-> Please import backend certificate to trusted list of PSE SAPSSLC.pse
-> Use PSE Management of the Web Administration
```
Enter the number of allowed connections you want:
The profile file of the SAP Web Dispatcher is now created. In the command line you can see the following output:
```
set DIR_INSTANCE = <Pfad Ihres SAP Web Dispatcher Verzeichnisses>
Profile "sapwebdisp.pfl" generated
```
Specify a user and password for the Web administration. If file icmauth.txt already exists, the system does not ask you for this information again.
In the command line you can see the following output:
```
Authentication file "icmauth.txt" generated
Web Administration user is "GewählterName" with your selected password
Web Administration accessible only with SSL/TLS using "URL"
```

Results

The bootstrap was successfully completed. In the command line you can see the following output:

SAP Web Dispatcher bootstrap ended (rc=0)

*** INFO: You can now start SAP Web Dispatcher
1. directly:          sapwebdisp pf=sapwebdisp.pfl
2. Start Service:     sapstartsrv pf=sapwebdisp.pfl

The bootstrap carries out the following steps:

Generates the profile sapwebdisp.pfl (if it does not already exist).
Creates a user for the Web administration in file icmauth.txt (if it does not already exist).

Next Steps

You can now start the SAP Web Dispatcher directly or using the SAP start service. Call the Web administration interface using the specified URL.